Skip to main content
UncategorizedSkill Writing339 lines

Skill File Structure and Anatomy

Quick Summary18 lines
This skill teaches the foundational structure of a well-formed skill file for SkillDB. A skill file is a markdown document that teaches an AI agent how to perform a specific task or apply domain knowledge. Understanding the anatomy of a skill file is essential for creating skills that are discoverable, effective, and maintainable.

## Key Points

- Encodes expert knowledge in a format AI agents can consume
- Provides actionable instructions, not just reference material
- Includes enough context for the agent to know when and how to apply the skill
- Is discoverable through metadata (tags, title, category)
- [Specific scenario 1]
- [Specific scenario 2]
- [Specific scenario 3]
- [Scenario where a different skill is more appropriate]
- [Scenario where this approach doesn't apply]
1. Identify natural boundaries (e.g., "setup" vs. "usage" vs. "debugging")
2. Create a parent skill with overview + links to children
3. Each child skill stands alone (doesn't require reading parent first)
skilldb get skill-writing-skills/skill-file-structureFull skill: 339 lines

Install this skill directly: skilldb add skill-writing-skills

Get CLI access →