Skill Creator

Agent Skill Creator Standard

Priority: P0 (CRITICAL)

Strict guidelines for authoring High-Density Agent Skills. Maximize information density while minimizing token consumption through progressive disclosure and strategic content organization.

Core Principles

Token Economy First ⚡

Every word costs tokens. Design skills for maximum information/token ratio:

• Progressive Loading: Load only essential content initially
• Lazy References: Move detailed examples to references/ folder
• Imperative Compression: Use verbs, abbreviations, bullet points
• Context Window Awareness: Design for 4k-32k token limits across agents

Three-Level Loading System

Level 1: Metadata (100 words) → Always loaded
Level 2: SKILL.md Body (100 lines) → When triggered
Level 3: References/Scripts/Assets → As needed

Directory Structure

skills/
└── {category}/                     # e.g., "flutter" (lowercase)
    └── {skill-name}/               # e.g., "bloc-state-management" (kebab-case)
        ├── SKILL.md                # Core Logic (High Density, <100 lines)
        ├── scripts/                # Executable code (Deterministic tasks)
        │   └── automation.py
        ├── references/             # Heavy Examples (Lazy loaded)
        │   ├── patterns.md
        │   └── examples.md
        └── assets/                 # Output templates (Never loaded)
            └── template.json

Writing Rules (Token-Optimized)

1. Imperative Compression: Start with verbs. No "Please/You should".

   • Waste: "You should use BLoC for state management." (8 words)
   • Efficient: "Use BLoC for state management." (5 words)

2. Token Economy: Maximize info/token ratio.

   • Skip articles ("the", "a") if readable
   • Use standard abbreviations (cfg, param, impl)
   • Bullet points > paragraphs (3x density)

3. Progressive Disclosure: Essential info first, details on-demand.

   • Core workflow in SKILL.md
   • Complex examples in references/
   • Templates/assets never loaded