skill-writer

Skill Writer

Create high-quality Agent Skills for any technology, language, or domain.

What Skills Are

Skills are modular packages that extend AI capabilities by providing:

• Specialized workflows - Multi-step procedures for specific domains
• Tool integrations - Instructions for working with file formats or APIs
• Domain expertise - Schemas, business logic, conventions
• Bundled resources - Scripts, references, assets for complex tasks

Skills are orchestrators, not tools themselves. They guide AI on HOW to use tools.

Core Principles

1. Concise is Key - Challenge each token; prefer examples over explanations
2. Degrees of Freedom - Match specificity to task fragility
3. Progressive Disclosure - Load details only when needed

See references/core-principles.md for detailed guidance.

Skill Anatomy

skill-name/
├── SKILL.md (REQUIRED)
│   ├── YAML frontmatter (name, description)
│   └── Markdown instructions
└── Bundled Resources (OPTIONAL)
    ├── scripts/      - Executable code (deterministic tasks)
    ├── references/   - Documentation (loaded as needed)
    └── assets/       - Output files (not loaded into context)

See references/skill-anatomy.md for when to use each resource type.

6-Step Creation Process

1. Understand - Gather concrete usage examples
2. Plan - Identify reusable resources (scripts/references/assets)
3. Initialize - Create directory structure
4. Edit - Implement resources + write SKILL.md
5. Package - Validate and create distributable
6. Iterate - Improve based on real usage

See references/creation-process.md for step-by-step guidance.

Writing SKILL.md

Frontmatter (Critical)

---
name: lowercase-hyphenated-name
description: WHAT it does + WHEN to use it. Include trigger words and contexts.
---

The description is the primary triggering mechanism. Include ALL trigger information here—the body only loads AFTER triggering.