Writing Skills
Skill Verified ActiveUse when creating new skills, editing existing skills, or verifying skills work before deployment
To guide users in creating and maintaining high-quality agent skills by applying a rigorous Test-Driven Development approach.
Features
- TDD methodology for skill creation
- Detailed testing scenarios for agents
- Guidance on handling common rationalizations
- Best practices for documentation structure and content
- Workflow for closing loopholes and ensuring compliance
Use Cases
- Creating new agent skills
- Editing existing skills for improvements
- Verifying skills before deployment
- Ensuring skills are robust under pressure
Non-Goals
- Creating skills without a failing test first
- Skipping the RED-GREEN-REFACTOR cycle
- Documenting hypothetical scenarios without testing
- Allowing rationalizations to bypass established rules
Workflow
- Follow TDD cycle for skill creation (RED-GREEN-REFACTOR)
- Write failing test scenarios without the skill (Baseline)
- Document agent failures and rationalizations verbatim
- Write minimal skill addressing specific failures
- Run scenarios with skill to verify compliance
- Close loopholes by adding explicit counters and updating documentation
- Re-test until skill is bulletproof and agent complies under pressure
Practices
- Test-Driven Development
- Documentation Quality
- Methodology Enforcement
- Iterative Refinement
Prerequisites
- Understanding of superpowers:test-driven-development skill
Installation
First, add the marketplace
/plugin marketplace add obra/superpowers/plugin install superpowers@superpowers-devQuality Score
VerifiedTrust Signals
Similar Extensions
Dart Matcher Best Practices
100Best practices for using `expect` and `package:matcher`. Focuses on readable assertions, proper matcher selection, and avoiding common pitfalls.
Neon Postgres
100Guides and best practices for working with Neon Serverless Postgres. Covers getting started, local development with Neon, choosing a connection method, Neon features, authentication (@neondatabase/auth), PostgREST-style data API (@neondatabase/neon-js), Neon CLI, and Neon's Platform API/SDKs. Use for any Neon-related questions.
Sdk Dx
100Design SDKs that developers love to use—APIs that feel native, error messages that guide, and experiences that reduce friction. This skill covers creating SDKs that drive adoption through exceptional developer experience rather than aggressive marketing. Trigger phrases: "SDK design", "developer experience", "API design", "SDK DX", "error messages", "type safety", "IDE integration", "SDK versioning", "migration guides", "client library design", "making SDKs feel native", "SDK best practices"
Csharp Async
100Get best practices for C# async programming
Golang Concurrency Patterns
100Go concurrency patterns for production services: context cancellation, errgroup, worker pools, bounded parallelism, fan-in/fan-out, and common race/deadlock pitfalls
Coding Standards
100Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns.