Superpowers Skills Adaptation Guide

Overview

Adapting 21 workflow skills from obra/superpowers for Factory.ai Droid CLI.

Key Differences: Superpowers vs Factory.ai

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-codegen
• •superpowers:executing-plans → Use Task tool with droidz-orchestrator
• •Document Factory.ai Task tool patterns

Skills to Adapt (21 Total)

Testing Skills (5)

1. •test-driven-development - TDD process (RED-GREEN-REFACTOR)
2. •systematic-debugging - 4-phase debugging framework
3. •verification-before-completion - Pre-completion checklist
4. •defense-in-depth - Multi-layer validation
5. •testing-anti-patterns - What NOT to do

Collaboration Skills (5)

1. •brainstorming - Design through questions
2. •writing-plans - Detailed implementation plans
3. •executing-plans - Following plans step-by-step
4. •requesting-code-review - How to ask for review
5. •receiving-code-review - How to respond to feedback

Development Skills (5)

1. •root-cause-tracing - Backward tracing technique
2. •subagent-driven-development - Task-by-task with fresh agents
3. •finishing-a-development-branch - Completing work properly
4. •using-git-worktrees - Parallel work branches
5. •condition-based-waiting - Replace arbitrary timeouts

Advanced/Meta Skills (6)

1. •dispatching-parallel-agents - Spawning multiple agents
2. •writing-skills - Creating new skills
3. •testing-skills-with-subagents - Validating skill quality
4. •sharing-skills - Publishing skills
5. •using-superpowers → using-droidz - How to use this system
6. •commands - Custom command reference

Adaptation Workflow

For each skill:

1. •Fetch original from obra/superpowers
2. •Keep core methodology (process, principles, examples)
3. •Update Factory.ai references (no "superpowers:" prefix)
4. •Simplify frontmatter, update paths
5. •Test that references work (skill → skill not superpowers:skill)
6. •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: workflow to 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)