diegosouzapw Superpowers Skills Adaptation Guide
Overview
Adapting 21 workflow skills from obra/superpowers for Factory.ai Droid CLI.
Key Differences: Superpowers vs Factory.ai
| Aspect | Superpowers (Claude Code) | Factory.ai Droid CLI |
|---|---|---|
| Skill Reference | superpowers:skill-name |
Just skill-name (auto-loaded) |
| User Reference | "your human partner" | "the user" |
| Slash Commands | /superpowers:command |
/command or native Droid commands |
| Skill Location | ~/.superpowers/skills/ |
.factory/skills/ |
| Plan Location | docs/plans/ |
.droidz/specs/ or docs/plans/ |
| Worktree | Git worktrees assumed | Optional, document if needed |
| Subagents | superpowers:subagent-* |
Task tool with droidz-* droids |
Adaptation Rules
1. Keep Core Methodology
- ✅ KEEP: The process/workflow (these are excellent!)
- ✅ KEEP: Red flags, rationalizations, checklists
- ✅ KEEP: Examples (Good/Bad patterns)
- ✅ KEEP: The "Iron Laws" and core principles
2. Update References
- ❌ REMOVE: "superpowers:" prefix from skill references
- ✅ UPDATE: "REQUIRED SUB-SKILL" → "RECOMMENDED SKILL" or "SEE ALSO"
- ✅ UPDATE: "your human partner" → "the user"
- ✅ UPDATE: Slash commands to Factory.ai equivalents
3. Simplify Frontmatter
---
name: skill-name
description: When to use this skill
category: workflow # Add this for workflow skills
---
4. Update File Paths
- Plans:
docs/plans/→.droidz/specs/(or keep docs/plans) - Skills: Reference other skills without prefix
- Tests: Keep language-agnostic examples
5. Update Subagent References
superpowers:subagent-driven-development→ Use Task tool with droidz-codegensuperpowers:executing-plans→ Use Task tool with droidz-orchestrator- Document Factory.ai Task tool patterns
Skills to Adapt (21 Total)
Testing Skills (5)
- test-driven-development - TDD process (RED-GREEN-REFACTOR)
- systematic-debugging - 4-phase debugging framework
- verification-before-completion - Pre-completion checklist
- defense-in-depth - Multi-layer validation
- testing-anti-patterns - What NOT to do
Collaboration Skills (5)
- brainstorming - Design through questions
- writing-plans - Detailed implementation plans
- executing-plans - Following plans step-by-step
- requesting-code-review - How to ask for review
- receiving-code-review - How to respond to feedback
Development Skills (5)
- root-cause-tracing - Backward tracing technique
- subagent-driven-development - Task-by-task with fresh agents
- finishing-a-development-branch - Completing work properly
- using-git-worktrees - Parallel work branches
- condition-based-waiting - Replace arbitrary timeouts
Advanced/Meta Skills (6)
- dispatching-parallel-agents - Spawning multiple agents
- writing-skills - Creating new skills
- testing-skills-with-subagents - Validating skill quality
- sharing-skills - Publishing skills
- using-superpowers → using-droidz - How to use this system
- commands - Custom command reference
Adaptation Workflow
For each skill:
- Fetch original from obra/superpowers
- Keep core methodology (process, principles, examples)
- Update Factory.ai references (no "superpowers:" prefix)
- Simplify frontmatter, update paths
- Test that references work (skill → skill not superpowers:skill)
- Save to
.factory/skills/[name].md
Quality Standards
Each adapted skill must:
- ✅ Preserve the original methodology and quality
- ✅ Remove superpowers-specific references
- ✅ Update to Factory.ai Droid CLI patterns
- ✅ Keep all examples, checklists, red flags
- ✅ Maintain 800+ lines (these are already comprehensive!)
- ✅ Add
category: workflowto distinguish from framework skills
Success Criteria
- ✅ All 21 skills adapted
- ✅ No broken references (superpowers: removed)
- ✅ Factory.ai Task tool patterns documented
- ✅ Skills work with Factory.ai auto-loading
- ✅ Total skill count: 42 (21 framework + 21 workflow)