# Rc Boat Hydrodynamics Design

> RC Boat Hydrodynamics & Naval Design analysis and decision-support harness with flexible agent architecture, dynamic skill registry, and production-grade error handling. Use for any RC boat design, analysis, hydrodynamics calculation, stability assessment, propulsion sizing, or naval architecture question. Trigger on keywords: "boat design", "hydrodynamics", "resistance", "stability", "propeller"…

- **Type:** Skill
- **Install:** `agentstack add skill-dungnotnull-rc-boat-hydrodynamics-design-agent-skill-rc-boat-hydrodynamics-design-agent-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dungnotnull](https://agentstack.voostack.com/s/dungnotnull)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dungnotnull](https://github.com/dungnotnull)
- **Source:** https://github.com/dungnotnull/rc-boat-hydrodynamics-design-agent-skill

## Install

```sh
agentstack add skill-dungnotnull-rc-boat-hydrodynamics-design-agent-skill-rc-boat-hydrodynamics-design-agent-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## Quick Start

Invoke this skill for any RC boat hydrodynamics or naval design task:

```
"Design an RC boat for 3 m/s with a 0.75m hull"
"Analyze the stability of this catamaran design"
"Calculate resistance for a V-hull at 5 m/s"
"What propeller do I need for a 6000 RPM motor?"
"Thiết kế tàu RC cho tốc độ 3 m/s"
"Tính toán sức cản cho vỏ tàu V"
```

## Harness Architecture

This skill uses a **flexible agent architecture** with dynamic skill resolution:

```
SKILL.md (entry point)
    │
    ▼
Skill Router → analyzes query → builds execution chain
    │
    ├─► Gather Requirements (validate scope, inputs)
    ├─► Evidence Collector (fetch real-time data)
    ├─► Core Analysis (hydrodynamics engine)
    ├─► Knowledge Updater (query knowledge base)
    └─► Advisor (synthesize recommendations)
        │
        ▼
    Quality Gates (U1-U6 + G1-G4)
        │
        ▼
    Final Report (risk-disclosed, evidenced)
```

## Flexible Skill System

Skills are **dynamically registered** in `config/skill_registry.json`. The router:

1. **Analyzes your query** intent and complexity
2. **Builds optimal execution chain** based on dependencies
3. **Resolves skill order** to maximize efficiency
4. **Executes with hooks** (pre/post/error) for monitoring
5. **Validates outputs** against JSON schemas
6. **Applies graceful degradation** on failures

### Execution Modes

**Full Harness** (high complexity):
```
gather_requirements → evidence_collector → core_analysis →
knowledge_updater → advisor → quality_gates
```

**Targeted Analysis** (medium complexity):
```
gather_requirements → core_analysis → advisor → relevant_gates
```

**Direct Tool** (low complexity):
```
hydrodynamics.py → basic formatting → minimal_gates
```

## Quality Assurance

All outputs pass through **10 quality gates**:

### Universal Gates (U1-U6)
- **U1**: ≥3 sources cited, ≥1 academic/authoritative
- **U2**: Disclosure/limitations before recommendation
- **U3**: Evidence hierarchy stated per source (Tier 1-4)
- **U4**: Language matches user preference
- **U5**: Output uses declared template (all sections)
- **U6**: Every claim traceable to source or flagged

### Domain Gates (G1-G4)
- **G1**: Resistance estimated with scaling laws
- **G2**: Stability (GM/trim) checked
- **G3**: Propulsion matched to drag
- **G4**: Control/CFD methods applied

**Auto-fix logic** with 2-retry max. Unfixable issues trigger explicit limitation flags.

## Output Format

The skill produces a structured report in your **preferred language** (detected automatically):

### English Structure
1. **Analysis Report**
2. **Executive Summary**
3. **Inputs & Scope**
4. **Evidence Collected**
5. **Analysis** (hydrodynamics calculations)
6. **Academic Evidence**
7. **Verdict** (Optimized/Conditional/Unstable/Inconclusive)
8. **Key Risks**
9. **Recommended Actions**
10. **Disclosure / Limitations**

### Vietnamese Structure
1. **Báo cáo phân tích**
2. **Tóm tắt tổng quan**
3. **Đầu vào & Phạm vi**
4. **Bằng chứng thu thập**
5. **Phân tích** (tính toán thủy động)
6. **Bằng chứng học thuật**
7. **Kết luận** (Tối ưu/Có điều kiện/Không ổn định/Chưa đủ cơ sở)
8. **Rủi ro chính**
9. **Hành động đề xuất**
10. **Công bố / Giới hạn phân tích**

## Tools & Resources

### Numerical Engine
**`tools/hydrodynamics.py`** — Production-grade hydrodistics computation:
- ITTC 1957 friction line, Reynolds/Froude numbers
- Wavemaking via bounded residual-resistance envelope
- Froude similitude scaling + ITTC 1978 model→prototype
- Intact stability: KB (Morrish), BM, GM, GZ, MCTC, trim
- Propeller open-water (KT/KQ) + actuator disk
- Thrust=drag equilibrium solver (Brent)

### Knowledge Base
**`SECOND-KNOWLEDGE-BRAIN.md`** — Living, auto-updated knowledge base:
- Core concepts & frameworks
- Key research papers with DOIs
- State-of-the-art methods
- Authoritative data sources
- Updated weekly via cron schedule

### Domain References
**`references/`** — Curated domain knowledge:
- `naval_architecture/` — ITTC procedures, Fossen handbook
- `rc_propulsion/` — Motor selection, propeller design
- `cfd_methods/` — RANS models, mesh generation
- `prompt_templates/` — Output templates

### Configuration
**`config/`** — Type-safe configuration management:
- `skill_registry.json` — Dynamic skill registration
- `tool_schemas.json` — Tool definitions & schemas
- `schemas/` — JSON schemas for validation
- `logging.yaml` — Structured logging configuration

## Error Handling

The skill **degrades gracefully** on failures:

### Level 0: Full Operation
All skills and tools available.

### Level 1: Degraded Web Access
WebSearch/WebFetch failing → use cached knowledge
**Output:** "Based on cached data as of [date]"

### Level 2: Tool Unavailable
hydrodynamics.py unavailable → manual calculation
**Output:** "Estimated without computational engine"

### Level 3: Multiple Failures
Multiple tools unavailable → qualitative analysis
**Output:** "Qualitative assessment - quantitative unavailable"

### Level 4: Critical Failure
Core functionality unavailable → explanatory error
**Output:** Error message with remediation steps

**All errors logged** to `logs/harness.log` with structured JSON logging.

## Language Support

**Bilingual support** with automatic detection:

### Vietnamese Detection
- Diacritics: à á ả ã ạ ă â đ è é ê ì í ò ó ô ơ ù ú ư ý
- Common words: "tàu", "thiết kế", "phân tích", "tính toán"

### English (Default)
- Default for all other inputs

**Output language** matches your input preference throughout the entire analysis.

## Integration

### As a Claude Code Skill
```
/rc-boat-hydrodynamics-design [your query]
```

### As a Standalone Tool
```python
from tools.hydrodynamics import (
    analyze, HullGeometry, OperatingCondition,
    PropellerOpenWater, report_to_text
)

# Define hull
hull = HullGeometry(
    length_waterline=0.75, beam=0.22, draft=0.06,
    displaced_volume=0.0018, wetted_surface_area=0.18,
    midship_section_coefficient=0.78, kg=0.05,
    waterplane_coefficient=0.72
)

# Define propeller
prop = PropellerOpenWater(
    j_samples=(0.0, 0.2, 0.4, 0.6, 0.8, 1.0, 1.2),
    kt_samples=(0.50, 0.42, 0.34, 0.25, 0.15, 0.06, 0.0),
    kq_samples=(0.060, 0.052, 0.043, 0.034, 0.026, 0.015, 0.0),
    diameter=0.040
)

# Analyze
rep = analyze(
    hull, OperatingCondition(speed=2.5, form_factor=0.1),
    propeller=prop, max_rpm=6000.0,
    wake_fraction=0.08, thrust_deduction=0.05,
    freeboard=0.012
)

print(report_to_text(rep))
```

### As a Python Library
```python
# Import specific functions
from tools.hydrodynamics import (
    resistance_components, transverse_gm,
    actuator_disk_thrust, analyze
)

# Use individual functions
resistance = resistance_components(hull, condition)
stability = transverse_gm(hull.geometry)
thrust = actuator_disk_thrust(power, speed)
```

## Version & Status

**Version:** 2.0.0 — Production-grade with flexible agent architecture

**Status:** All phases complete (Phase 0-5), 100% functional code, no placeholders

**License:** MIT — see [LICENSE](LICENSE)

## Citation

```bibtex
@software{rc_boat_hydrodynamics_design,
  title  = {rc-boat-hydrodynamics-design: RC Boat Hydrodynamics Design \& Testing},
  author = {Claude Code},
  year   = {2026},
  version= {2.0.0},
  license= {MIT},
  url    = {https://github.com/yourusername/rc-boat-hydrodynamics-design}
}
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dungnotnull](https://github.com/dungnotnull)
- **Source:** [dungnotnull/rc-boat-hydrodynamics-design-agent-skill](https://github.com/dungnotnull/rc-boat-hydrodynamics-design-agent-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dungnotnull-rc-boat-hydrodynamics-design-agent-skill-rc-boat-hydrodynamics-design-agent-skill
- Seller: https://agentstack.voostack.com/s/dungnotnull
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.