writing-skills ยท diff
git:20260325.a6b3a88 to git:20260507.56f011d
35 added, 32 removed. Audit A to A.
- ---
- name: writing-skills
- description: Use when creating new skills, editing existing skills, or verifying skills work before deployment.
- ---
-
- # Writing Skills
-
- ## Overview
-
- Writing skills IS Test-Driven Development applied to process documentation. Write pressure tests, watch agents fail, write the skill, watch them pass, close loopholes.
-
- **Core principle:** If you did not watch an agent fail without the skill, you do not know if the skill teaches the right thing.
-
- ## TDD for Skills
-
- | TDD Concept | Skill Creation |
- |-------------|----------------|
- | Test case | Pressure scenario with subagent |
- | Production code | Skill document (SKILL.md) |
- | RED | Agent violates rule without skill |
- | GREEN | Agent complies with skill present |
- | REFACTOR | Close loopholes |
-
- ## Skill Structure
-
- - YAML frontmatter: `name` and `description` only
- - Description: "Use when..." (triggering conditions only, never summarize workflow)
- - Flat namespace, separate files only for heavy reference or reusable tools
-
- ## Tool Use
-
- Meta-skill for creating new skills within the methodology.
+ ---
+ name: writing-skills
+ description: Use when creating new skills, editing existing skills, or verifying skills work before deployment.
+ graph:
+ domains: [domain:software-engineering]
+
+ ---
+
+ # Writing Skills
+
+ ## Overview
+
+ Writing skills IS Test-Driven Development applied to process documentation. Write pressure tests, watch agents fail, write the skill, watch them pass, close loopholes.
+
+ **Core principle:** If you did not watch an agent fail without the skill, you do not know if the skill teaches the right thing.
+
+ ## TDD for Skills
+
+ | TDD Concept | Skill Creation |
+ |-------------|----------------|
+ | Test case | Pressure scenario with subagent |
+ | Production code | Skill document (SKILL.md) |
+ | RED | Agent violates rule without skill |
+ | GREEN | Agent complies with skill present |
+ | REFACTOR | Close loopholes |
+
+ ## Skill Structure
+
+ - YAML frontmatter: `name` and `description` only
+ - Description: "Use when..." (triggering conditions only, never summarize workflow)
+ - Flat namespace, separate files only for heavy reference or reusable tools
+
+ ## Tool Use
+
+ Meta-skill for creating new skills within the methodology.