Qwen Superpowers

Inspired by obra/superpowers

A collection of composable skills for Qwen Code that enforce structured software development workflows.

🎯 What is this?

Qwen Superpowers is a set of mandatory workflows that guide Qwen Code through disciplined software development practices. Instead of jumping straight into coding, the agent follows a structured process:

1. Clarifies requirements through brainstorming and questions
2. Presents design in small, reviewable sections
3. Creates detailed implementation plans with specific tasks
4. Executes via subagents with built-in code review
5. Follows TDD (Red-Green-Refactor) for all implementations
6. Verifies and cleans up before declaring completion

📦 Installation

Option 1: Local install (for testing)

# Clone and install locally
git clone [email protected]:ni032mas/superpowers-qwen.git
cd superpowers-qwen
npm install -g .

Option 2: From GitHub

# Install directly from GitHub
npm install -g github:ni032mas/superpowers-qwen

Verify Installation

Ask Qwen Code something like:

use brainstorming skill to help me plan a feature

Or use the explicit command:

/skills brainstorming

Uninstall

Note: Due to npm limitations, uninstall requires two steps:

# Step 1: Remove skills from ~/.qwen/skills/
superpowers-qwen-cleanup

# Step 2: Remove the npm package
npm uninstall -g superpowers-qwen

Or use the interactive uninstaller:

superpowers-qwen-uninstall
npm uninstall -g superpowers-qwen

If you already removed the package, cleanup skills manually:

superpowers-qwen-cleanup

Or remove manually:

# Windows
rmdir /s /q %USERPROFILE%\.qwen\skills\brainstorming
rmdir /s /q %USERPROFILE%\.qwen\skills\executing-plans
# ... repeat for each skill

# macOS/Linux
rm -rf ~/.qwen/skills/brainstorming
rm -rf ~/.qwen/skills/executing-plans
# ... repeat for each skill

⚡ Available Skills

| Skill | Description | |-------|-------------| | brainstorming | Clarifies ideas through questions before coding | | writing-plans | Breaks work into 2-5 minute tasks with exact paths | | executing-plans | Executes planned tasks systematically | | subagent-driven-development | Delegates tasks to subagents with 2-stage review | | test-driven-development | RED-GREEN-REFACTOR cycle for all code | | systematic-debugging | 4-phase root cause analysis | | requesting-code-review | Reviews work against the plan | | finishing-a-development-branch | Verifies, commits, and cleans up |

🔄 Updating

# If installed via npm
npm update -g superpowers-qwen

# If installed from GitHub
npm update -g github:YOUR_USERNAME/superpowers-qwen

# If installed manually (Git)
cd superpowers-qwen
git pull

Then restart Qwen Code.

📚 Philosophy

• ✅ TDD First — tests always before implementation
• ✅ Systematic over ad-hoc approaches
• ✅ Simplicity as the primary goal
• ✅ Evidence over assertions
• ✅ Review before completion

This project adapts the excellent superpowers workflow for Qwen Code.