From 7e82c5f43348a5e4df178317082a2a160e119b47 Mon Sep 17 00:00:00 2001
From: Amolith <amolith@secluded.site>
Date: Sat, 27 Dec 2025 22:46:14 -0700
Subject: [PATCH] docs(agents): add

---
 AGENTS.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000000000000000000000000000000000000..6cebb815f8aa59da384f3200a223b982bafcac5e
--- /dev/null
+++ b/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`)