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-codegen
superpowers: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: 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)