Files
superpowers/docs/README.kimi.md
2026-06-01 19:41:58 -07:00

2.5 KiB

Superpowers for Kimi Code

Complete guide for using Superpowers with Kimi Code.

Installation

Superpowers is available in Kimi Code's plugin marketplace.

Open the plugin manager:

/plugins

Search for Superpowers and install it.

You can also install from this repository:

/plugins install https://github.com/obra/superpowers

For unreleased validation against dev, pin the branch explicitly:

/plugins install https://github.com/obra/superpowers/tree/dev

Kimi Code applies plugin changes to new sessions. After installing, updating, enabling, disabling, or reloading a plugin, start a fresh session with /new.

How It Works

The Kimi plugin manifest lives at .kimi-plugin/plugin.json.

The manifest does three things:

  1. Points Kimi Code at the existing skills/ directory.
  2. Loads using-superpowers at session start through sessionStart.skill.
  3. Provides Kimi-specific tool mapping through skillInstructions.

Kimi Code reads Superpowers skills from this repository. There are no copied skills, symlinks, hooks, or extra runtime dependencies.

Tool Mapping

Skills describe actions instead of hard-coding one runtime's tool names. On Kimi Code these resolve to:

  • "Ask the user" / "ask clarifying questions" -> AskUserQuestion
  • "Create a todo" / "mark complete in todo list" -> TodoList
  • "Dispatch a subagent" -> Agent
  • "Invoke a skill" -> Kimi Code's native Skill tool
  • "Read a file" / "write a file" / "edit a file" -> Read, Write, Edit
  • "Run a shell command" -> Bash
  • "Search the web" -> WebSearch

Updating

Use Kimi Code's plugin manager:

/plugins

Select Superpowers and update it from there. Start a fresh session with /new after updating.

Troubleshooting

Plugin not loading

  1. Run /plugins info superpowers and check diagnostics.
  2. Make sure the plugin is enabled.
  3. Start a fresh session with /new after install or update.

Direct GitHub install used an old release

Kimi Code installs the latest GitHub release for a bare repository URL when one exists. To test unreleased changes before the next Superpowers release, install the branch explicitly:

/plugins install https://github.com/obra/superpowers/tree/dev

Skills not triggering

  1. Confirm /plugins info superpowers shows the plugin enabled.
  2. Start a fresh session with /new.
  3. Try the acceptance prompt: Let's make a react todo list. A working install should load brainstorming before writing code.