# Agent Skills Repository

Amolith's collection of Agent Skills—markdown-based documentation that extends AI agent capabilities through a standardized format.

## Repository Structure

Each top-level directory is a skill. A skill's directory name **must match** its `name` frontmatter field.

```
skill-name/
├── SKILL.md          # Required: YAML frontmatter + markdown instructions
├── references/       # Optional: additional documentation loaded on-demand
├── scripts/          # Optional: executable code
└── assets/           # Optional: templates, resources
```

## Creating/Editing Skills

The `authoring-skills/` directory has the necessary info for, well, authoring skills.

## Design Principles

1. Progressive disclosure: Frontmatter loads at startup; SKILL.md body loads on activation; references/ load on-demand
2. Conciseness over completeness: Every token competes for context window space
3. Appropriate freedom: Match instruction specificity to task fragility (see `authoring-skills/references/patterns.md`)