An agentic skills framework & software development methodology that works.
Fix skill descriptions: remove workflow summaries that override flowcharts
Jesse Vincent030a222af19c
diff --git a/skills/dispatching-parallel-agents/SKILL.md b/skills/dispatching-parallel-agents/SKILL.mdindex 493dea2db..33b14859f 100644--- a/skills/dispatching-parallel-agents/SKILL.md+++ b/skills/dispatching-parallel-agents/SKILL.md@@ -1,6 +1,6 @@---name: dispatching-parallel-agents-description: Use when facing 3+ independent failures that can be investigated without shared state or dependencies - dispatches multiple Claude agents to investigate and fix independent problems concurrently+description: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies---# Dispatching Parallel Agentsdiff --git a/skills/executing-plans/SKILL.md b/skills/executing-plans/SKILL.mdindex 47e545a67..ca77290c8 100644--- a/skills/executing-plans/SKILL.md+++ b/skills/executing-plans/SKILL.md@@ -1,6 +1,6 @@---name: executing-plans-description: Use when partner provides a complete implementation plan to execute in controlled batches with review checkpoints - loads plan, reviews critically, executes tasks in batches, reports for review between batches+description: Use when you have a written implementation plan to execute in a separate session with review checkpoints---# Executing Plansdiff --git a/skills/requesting-code-review/SKILL.md b/skills/requesting-code-review/SKILL.mdindex f8b1a5652..f0e33952c 100644--- a/skills/requesting-code-review/SKILL.md+++ b/skills/requesting-code-review/SKILL.md@@ -1,6 +1,6 @@---name: requesting-code-review-description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements - dispatches superpowers:code-reviewer subagent to review implementation against plan or requirements before proceeding+description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements---# Requesting Code Reviewdiff --git a/skills/systematic-debugging/SKILL.md b/skills/systematic-debugging/SKILL.mdindex a6790bd59..111d2a98c 100644--- a/skills/systematic-debugging/SKILL.md+++ b/skills/systematic-debugging/SKILL.md@@ -1,6 +1,6 @@---name: systematic-debugging-description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes - four-phase framework (root cause investigation, pattern analysis, hypothesis testing, implementation) that ensures understanding before attempting solutions+description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes---# Systematic Debuggingdiff --git a/skills/test-driven-development/SKILL.md b/skills/test-driven-development/SKILL.mdindex b138985a4..7a751fa94 100644--- a/skills/test-driven-development/SKILL.md+++ b/skills/test-driven-development/SKILL.md@@ -1,6 +1,6 @@---name: test-driven-development-description: Use when implementing any feature or bugfix, before writing implementation code - write the test first, watch it fail, write minimal code to pass; ensures tests actually verify behavior by requiring failure first+description: Use when implementing any feature or bugfix, before writing implementation code---# Test-Driven Development (TDD)diff --git a/skills/writing-plans/SKILL.md b/skills/writing-plans/SKILL.mdindex b26b9d15e..448ca3193 100644--- a/skills/writing-plans/SKILL.md+++ b/skills/writing-plans/SKILL.md@@ -1,6 +1,6 @@---name: writing-plans-description: Use when design is complete and you need detailed implementation tasks for engineers with zero codebase context - creates comprehensive implementation plans with exact file paths, complete code examples, and verification steps assuming engineer has minimal domain knowledge+description: Use when you have a spec or requirements for a multi-step task, before touching code---# Writing Plansdiff --git a/skills/writing-skills/SKILL.md b/skills/writing-skills/SKILL.mdindex b678dca47..1487f1c04 100644--- a/skills/writing-skills/SKILL.md+++ b/skills/writing-skills/SKILL.md@@ -1,6 +1,6 @@---name: writing-skills-description: Use when creating new skills, editing existing skills, or verifying skills work before deployment - applies TDD to process documentation by testing with subagents before writing, iterating until bulletproof against rationalization+description: Use when creating new skills, editing existing skills, or verifying skills work before deployment---# Writing Skills