aibot88 Skill Guidelines Management
Core Principles
- Progressive Disclosure - SKILL.md contains essentials, reference/* contains examples
- Project Independence - Remove project-specific paths, names, domains
- Bullet Format -
- **Rule** - Brief 5-10 word how-to, see [reference/file.md](reference/file.md) - Style Consistency - Match existing skill patterns in structure and voice
Skill Structure
- SKILL.md - Frontmatter, essentials (3-7 bullets), one example, progressive disclosure links
- reference/*.md - Guideline, rationale, how to apply, examples, counter-examples
Operations
- Create from document - Extract guidelines from URLs or files, see reference/create.md
- Extract from codebase - Analyze code patterns and project instructions, see reference/extract.md
- Assimilate skills - Merge elements from one skill into another, see reference/assimilate.md
- Simplify skills - Condense verbose SKILL.md to bullet list, see reference/simplify.md
- Simplify references - Merge overlapping sections in reference files, see reference/simplify-reference.md
Progressive Disclosure
- Read reference/create.md - When creating skill from documentation or URL
- Read reference/extract.md - When extracting patterns from codebase
- Read reference/assimilate.md - When augmenting skill with another skill's elements
- Read reference/simplify.md - When condensing verbose skill to bullet format
- Read reference/simplify-reference.md - When condensing verbose reference files