writing-skills ยท diff
git:20260507.56f011d to git:20260507.8dfdcb4
6 added, 16 removed. Audit A to C.
---
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 |
+ graph:
+ domains: [domain:software-engineering]
+ skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop]
+ workflows: [workflow:feature-development]
+ topics: [topic:developer-experience]
+ roles: [role:tech-lead, role:backend-engineer]
|-------------|----------------|
| 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.