New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Guide for authoring agent skills that stays within the 200-line rule through progressive disclosure.

skills.sh installs
2.8K
GitHub stars
22
last updated
Aug 21, 2026
View on GitHub

What it does

  • Covers skill anatomy: SKILL.md frontmatter, the three-level loading model, and optional scripts/, references/, and assets/ folders
  • Explains progressive disclosure, keeping SKILL.md under 200 lines and moving detail into references/ files
  • Provides concision and freedom-level guidance, including how much instruction to give for fragile versus flexible operations
  • Designed for authors writing new skills or updating existing ones that extend agent capabilities

Install

$ npx -y skills add siviter-xyz/dot-agent --skill create-skill -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

Create Skill

Guide for creating effective skills that extend agent capabilities with specialized knowledge, workflows, and tool integrations.

About Skills

Skills are modular, self-contained packages that extend agent capabilities by providing specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific domains or tasks.

What Skills Provide

  1. Specialized workflows - Multi-step procedures for specific domains
  2. Tool integrations - Instructions for working with specific file formats or APIs
  3. Domain expertise - Company-specific knowledge, schemas, business logic
  4. Bundled resources - Scripts, references, and assets for complex and repetitive tasks

Progressive Disclosure Principle

The 200-line rule is critical. SKILL.md must be under 200 lines. If you need more, split content into references/ files.

Three-Level Loading System

  1. Metadata (name + description) - Always in context (~100 words)
  2. SKILL.md body - When skill triggers (<200 lines, ideally <500 lines for optimal performance)
  3. Bundled resources - As needed by agent (unlimited)

Why Progressive Disclosure Matters

Details

Repository
github.com/siviter-xyz/dot-agent
Categories
Documentation, AI & Agent Building, Skill Development

More from siviter-xyz/dot-agent

All 3

Similar to Create Skill

More Documentation