Achilles Agents Tutorials

Skill repositories, descriptor formats, and end-to-end examples for every Achilles Agents skill family.

Repository Pattern

Every scenario keeps its skills inside a .AchillesSkills/ folder. The recursive loader walks up the directory tree until it finds this repository, indexes the descriptors, and registers the skills automatically.

tests/iskills/missing-parameters/
└── .AchillesSkills/
    └── support/
        └── file_incident/
            ├── iskill.md          # primary descriptor
            └── file_incident.js   # optional entrypoint (specs/action/roles)

Descriptor suffixes map to skill families:

iskill.md — interactive conversational flows.
tskill.md — DBTable skills that drive CRUD access to structured tables.
oskill.md — orchestration planners (LightSOPLang optional).
mskill.md — MCP tool planners.
cgskill.md — code generation guidance.
cskill.md — code skills that generate code from specifications.
skill.md — Claude skills that return static summaries/bodies.

Choose a Walkthrough

Interactive Skills

Prompt collection, validation, and example descriptors from the interactive suite.

DBTable Skills

Table-focused workflows using tskill.md, generated helpers, and CRUD scenarios from tests/dbTableSkills.

Orchestration Skills

Plan coordination with LightSOPLang scripts, intent taxonomies, and fallbacks.

MCP Skills

Tool allow-lists, scripted MCP plans, and execution traces.

Code Generation Skills

Descriptors plus sandbox entrypoints for LLM-assisted code execution.

Code Skills

Generate executable code from detailed specifications and execute it safely.

Claude Skills

Create static descriptor skills that surface summaries and bodies without invoking the LLM.