Skip to content

An agentic skills framework & software development methodology that works.

Integrate testing-skills-with-subagents into writing-skills

Jesse Vincentb57c27d8155e
diff --git a/README.md b/README.md
index c0223c208..354d660af 100644
--- a/README.md
+++ b/README.md
@@ -120,9 +120,8 @@ Fetch and follow instructions from https://raw.githubusercontent.com/obra/superp
- **finishing-a-development-branch** - Merge/PR decision workflow
- **subagent-driven-development** - Fast iteration with quality gates
-**Meta**
-- **writing-skills** - Create new skills following best practices
-- **testing-skills-with-subagents** - Validate skill quality
+**Meta**
+- **writing-skills** - Create new skills following best practices (includes testing methodology)
- **using-superpowers** - Introduction to the skills system
## Philosophy
@@ -140,9 +139,8 @@ Skills live directly in this repository. To contribute:
1. Fork the repository
2. Create a branch for your skill
-3. Follow the `writing-skills` skill for creating new skills
-4. Use the `testing-skills-with-subagents` skill to validate quality
-5. Submit a PR
+3. Follow the `writing-skills` skill for creating and testing new skills
+4. Submit a PR
See `skills/writing-skills/SKILL.md` for the complete guide.
diff --git a/skills/writing-skills/SKILL.md b/skills/writing-skills/SKILL.md
index 984ebce57..da631a7fa 100644
--- a/skills/writing-skills/SKILL.md
+++ b/skills/writing-skills/SKILL.md
@@ -181,7 +181,7 @@ Use words Claude would search for:
**Use active voice, verb-first:**
- ✅ `creating-skills` not `skill-creation`
-- ✅ `testing-skills-with-subagents` not `subagent-skill-testing`
+- ✅ `condition-based-waiting` not `async-test-helpers`
### 4. Token Efficiency (Critical)
@@ -520,7 +520,7 @@ Run same scenarios WITH skill. Agent should now comply.
Agent found new rationalization? Add explicit counter. Re-test until bulletproof.
-**REQUIRED SUB-SKILL:** Use superpowers:testing-skills-with-subagents for the complete testing methodology:
+**Testing methodology:** See @testing-skills-with-subagents.md for the complete testing methodology:
- How to write pressure scenarios
- Pressure types (time, sunk cost, authority, exhaustion)
- Plugging holes systematically
diff --git a/skills/testing-skills-with-subagents/examples/CLAUDE_MD_TESTING.md b/skills/writing-skills/examples/CLAUDE_MD_TESTING.md
similarity index 100%
rename from skills/testing-skills-with-subagents/examples/CLAUDE_MD_TESTING.md
rename to skills/writing-skills/examples/CLAUDE_MD_TESTING.md
diff --git a/skills/testing-skills-with-subagents/SKILL.md b/skills/writing-skills/testing-skills-with-subagents.md
similarity index 97%
rename from skills/testing-skills-with-subagents/SKILL.md
rename to skills/writing-skills/testing-skills-with-subagents.md
index a623adef4..9b12f3bb8 100644
--- a/skills/testing-skills-with-subagents/SKILL.md
+++ b/skills/writing-skills/testing-skills-with-subagents.md
@@ -1,10 +1,7 @@
----
-name: testing-skills-with-subagents
-description: Use when creating or editing skills, before deployment, to verify they work under pressure and resist rationalization - applies RED-GREEN-REFACTOR cycle to process documentation by running baseline without skill, writing to address failures, iterating to close loopholes
----
-
# Testing Skills With Subagents
+**Load this reference when:** creating or editing skills, before deployment, to verify they work under pressure and resist rationalization.
+
## Overview
**Testing skills is just TDD applied to process documentation.**