@@ -18,6 +18,13 @@ skills/skill-name/
The `skills/authoring-skills/` directory has the necessary info for, well, authoring skills.
+## Naming Convention
+
+Two categories of skills exist:
+
+- **Generic capability skills** (`resolving-secrets`, `formatting-commits`): Use specific tools to accomplish general tasks. Tool name omitted from skill name.
+- **Service workflow skills** (`deferring-work-through-lunatask`): Workflows for specific proprietary services. Service name included via `-through-{service}` suffix.
+
## Design Principles
1. Progressive disclosure: Frontmatter loads at startup; SKILL.md body loads on activation; references/ load on-demand