Skip to main content

Superpowers — Install & Configure

Superpowers is an optional skills framework that plugs into ValorIDE and provides reusable agent “skills” (small, opinionated workflows such as TDD, verification hooks, and workspace tooling).

This guide shows a minimal, safe installation for local developer systems.

Quick summary​

  • Clone the Superpowers repo into ~/.valoride/superpowers.
  • Create a ~/.valoride/skills directory for your personal skills.
  • Update ~/.valoride/AGENTS.md to reference the Superpowers bootstrap command.

Step-by-step​

  1. Clone the repository:
mkdir -p ~/.valoride/superpowers
cd ~/.valoride/superpowers
git clone https://github.com/obra/superpowers.git .
  1. Add a personal skills directory (optional):
mkdir -p ~/.valoride/skills
  1. Make a bootstrap entry in ~/.valoride/AGENTS.md so ValorIDE can find and enable the framework.

Example snippet to add:

## Superpowers System

You have superpowers. Run the bootstrap to initialize skills:

`~/.valoride/superpowers/.valoride/superpowers-valoride bootstrap`
  1. Run the bootstrap command to initialize skills and verify the setup:
~/.valoride/superpowers/.valoride/superpowers-valoride bootstrap

You should see the available skill list and installation instructions returned by the tool.

How Superpowers and Personal Skills interact​

  • Superpowers repository (global shared skills) lives in ~/.valoride/superpowers.
  • Local personal skills live in ~/.valoride/skills and override global skills when name collisions occur.

Example skills​

  • test-driven-development — TDD workflow (red/green/refactor) for code tasks
  • verification-before-completion — run checks before marking a task done
  • writing-plans — produce structured, testable plans before implementation

Usage tips​

  • The recommended default behavior is that ValorIDE checks whether the required skill exists before a task and loads it automatically.
  • If you build custom skills, keep them focused and include a verification checklist so changes remain deterministic and auditable.

Next steps​

  • Browse ~/.valoride/superpowers/skills to see available capabilities
  • Add personal overrides under ~/.valoride/skills