Skip to content
Maktaba

docs/README.kimi.md

docs/README.kimi.md · 2.6 KB · View on GitHub at 22f0b46

Superpowers for Kimi Code

Section titled “Superpowers for Kimi Code”

Complete guide for using Superpowers with Kimi Code.

Installation

Section titled “Installation”

Superpowers is available in Kimi Code’s plugin marketplace.

Open the plugin manager:

/plugins

Go to Marketplace > 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

Section titled “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

Section titled “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 file contents” -> Grep
  • “Find files by path or pattern” -> Glob
  • “Fetch a URL” -> FetchURL
  • “Search the web” -> WebSearch

Updating

Section titled “Updating”

Use Kimi Code’s plugin manager:

/plugins

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

Troubleshooting

Section titled “Troubleshooting”

Plugin not loading

Section titled “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

Section titled “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

Section titled “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.
Original Markdown source
docs/README.kimi.md
# Superpowers for Kimi Code


Complete guide for using Superpowers with [Kimi Code](https://github.com/MoonshotAI/kimi-code).


## Installation


Superpowers is available in Kimi Code's plugin marketplace.


Open the plugin manager:


```text
/plugins
```


Go to `Marketplace` > `Superpowers` and install it.


You can also install from this repository:


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


For unreleased validation against `dev`, pin the branch explicitly:


```text
/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 file contents" -> `Grep`
- "Find files by path or pattern" -> `Glob`
- "Fetch a URL" -> `FetchURL`
- "Search the web" -> `WebSearch`


## Updating


Use Kimi Code's plugin manager:


```text
/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:


```text
/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.