Agent Skills

Project Structure

Understanding the OpenOcean Skills directory layout.

Directory Layout

Skills live under skills/, while shared API docs and token data live under references/.

Project Structure

openocean-skills/

├── skills/

│ ├── quote/# Get a swap quote

│ │ └── SKILL.md

│ ├── swap-build/# Build swap calldata (with confirmation)

│ │ └── SKILL.md

│ ├── swap-execute/# Execute a swap via Foundry cast (with confirmation)

│ │ └── SKILL.md

│ ├── swap-execute-fast/# Build and execute in one step (no confirmation)

│ │ ├── SKILL.md

│ │ └── scripts/

│ │ ├── fast-swap.sh# Token resolution and route building

│ │ └── execute-swap.sh# Calls fast-swap.sh and then broadcasts

│ └── error-handling/# Troubleshooting and error codes

│ └── SKILL.md

├── references/# Shared docs

│ ├── api-reference.md

│ └── token-registry.md

├── test/# Prompt test cases

│ └── agent-test-cases.md# English test prompts

└── README.md

skills/ - Contains all skill definitions as SKILL.md files
references/ - Shared documentation that skills reference
- api-reference.md - OpenOcean API documentation
- token-registry.md - Token symbols and addresses
test/ - Test prompts and agent test cases