Rc Boat Hydrodynamics Design

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

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

# 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

@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
• Source: dungnotnull/rc-boat-hydrodynamics-design-agent-skill
• License: MIT

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