docs(agents): add

Amolith created 2 weeks ago

Change summary

AGENTS.md | 25 +++++++++++++++++++++++++
1 file changed, 25 insertions(+)

Detailed changes

AGENTS.md

@@ -0,0 +1,25 @@
+# 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`)