Claude Skills Tutorial

Author simple descriptor-only skills that return summaries and bodies without invoking the LLM.

Repository Layout

Claude skills live under .AchillesSkills/<domain>/<skill_name>/ and require only a skill.md descriptor. No JavaScript entrypoint is needed; ClaudeSkillsSubsystem returns the descriptor content directly. 

.AchillesSkills/
└── docs/
    └── runbook/
        └── skill.md

Descriptor: skill.md

The Markdown file provides a title (first heading), a summary, and a body. These fields are returned as metadata and a static result when the skill runs. 

# Reset Database Passwords

## Summary
Steps for rotating a managed database password.

## Body
1. Verify the caller in the ticketing system.
2. Rotate credentials in the admin portal.
3. Confirm rotation and note the timestamp in the incident log.

When invoked, the runtime responds with the summary or title as the headline and the body text as details—no LLM calls or code execution.

Execution Behaviour

  1. RecursiveSkilledAgent discovers the descriptor and registers it under the folder name.
  2. ClaudeSkillsSubsystem prepares metadata (title, summary, sections).
  3. Executing the skill returns { summary, details, type: 'claude' } with sessionMemory: null.

This makes Claude skills ideal for help content, runbooks, or capability cards that should be deterministic and free to call.