install-superpowers-for-kimi

name install-superpowers-for-kimi description Install and configure Superpowers workflow for Kimi Code CLI (feat/hook-inject-prompt branch) on any platform (Windows/macOS/Linux) Install Superpowers for Kimi Code CLI This skill guides you through installing the Superpowers workflow system for Kimi Code CLI with automatic skill invocation via the inject_prompt hook feature. ⚠️ Prerequisites - IMPORTANT This installation requires the feat/hook-inject-prompt branch of Kimi Code CLI , which adds support for the inject_prompt hook feature. Step 0: Install Kimi CLI from feat/hook-inject-prompt Branch Option A: Clone and Install (Recommended) # macOS/Linux git clone -b feat/hook-inject-prompt https://github.com/Dqz00116/kimi-cli.git ~/kimi-cli cd ~/kimi-cli uv sync uv pip install -e . # Verify installation kimi --version Windows (PowerShell): # Clone to a permanent location git clone -b feat/hook-inject-prompt https://github.com/Dqz00116/kimi-cli.git "$env:USERPROFILE\kimi-cli" cd "$env:USERPROFILE\kimi-cli" # Install dependencies and package uv sync uv pip install -e . Option B: Run Without Installing cd ~/kimi-cli uv run kimi -- help Verify Hook Support # Should show UserPromptSubmit in the list of supported events kimi -- help | grep -A 5 "hooks" Installation Steps Step 1: Clone Superpowers Repository # Create .kimi directory if it doesn't exist mkdir -p ~/.kimi # Clone superpowers repository git clone --depth 1 https://github.com/obra/superpowers.git ~/.kimi/superpowers Windows (PowerShell): New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.kimi" git clone --depth 1 https://github.com/obra/superpowers.git "$env:USERPROFILE\.kimi\superpowers" Step 2: Create Skill Links On macOS/Linux: mkdir -p ~/.kimi/skills # Create symlinks for all superpowers skills for skill in brainstorming dispatching-parallel-agents executing-plans \ finishing-a-development-branch receiving-code-review requesting-code-review \ subagent-driven-development systematic-debugging test-driven-development \ using-git-worktrees using-superpowers verification-before-completion \ writing-plans writing-skills; do ln -sf ~/.kimi/superpowers/skills/ $skill ~/.kimi/skills/ $skill done On Windows (PowerShell as Administrator): New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.kimi\skills" $skills = @( "brainstorming", "dispatching-parallel-agents", "executing-plans", "finishing-a-development-branch", "receiving-code-review", "requesting-code-review", "subagent-driven-development", "systematic-debugging", "test-driven-development", "using-git-worktrees", "using-superpowers", "verification-before-completion", "writing-plans", "writing-skills" ) foreach ($skill in $skills) { $target = "$env:USERPROFILE\.kimi\skills\$skill" $source = "$env:USERPROFILE\.kimi\superpowers\skills\$skill" if (Test-Path $target) { Remove-Item $target -Recurse -Force } cmd /c mklink /J "$target" "$source" } Step 3: Patch using-superpowers Skill for Kimi Edit ~/.kimi/superpowers/skills/using-superpowers/SKILL.md : Change the description to: description: MANDATORY — Read this skill FIRST at the start of EVERY conversation before any response or action In the "How to Access Skills" section, add Kimi-specific instructions after "In Gemini CLI:": **In Kimi Code CLI:** Kimi does not have a native `Skill` tool. To invoke a skill, you MUST use the `ReadFile` tool to read the skill's `SKILL.md` file from its path (listed in the system prompt under Available skills). After reading the skill content, follow its instructions exactly. This is how you "invoke" a skill in Kimi. In "The Rule" section, add after the first paragraph: **In Kimi Code CLI specifically:** Before responding to the user's first message in any conversation, you MUST use `ReadFile` to read `using-superpowers/SKILL.md` (from the skill paths listed in the system prompt). Then, if any other skill might apply, use `ReadFile` to read that skill's `SKILL.md` as well. Do not skip this step. Step 4: Configure UserPromptSubmit Hook Create the prompts directory and reminder file: mkdir -p ~/.kimi/prompts # Create the Superpowers reminder prompt cat > ~/.kimi/prompts/superpowers-reminder.md << 'EOF' [SYSTEM REMINDER - MANDATORY] Before responding to the user 's message, you MUST invoke the Superpowers workflow by reading the using-superpowers skill. **REQUIRED ACTION:** 1. Use ReadFile to read: ~/.kimi/skills/using-superpowers/SKILL.md 2. Follow the instructions in that skill EXACTLY 3. If any other skill might apply (even 1% chance), read that skill' s SKILL.md as well 4. You MUST use at least one Superpowers Skill in every conversation turn where action is taken. 5. If no Superpowers Skill applies to the user 's request, STOP and ask the user how to proceed. Do NOT perform any other action. 6. You MUST select and invoke the appropriate skill BEFORE starting any other work. 7. Do NOT run any tools in parallel before a skill has been selected and invoked. **Available Superpowers Skills:** - brainstorming - For open-ended exploration and idea generation - dispatching-parallel-agents - For running multiple subagents in parallel - executing-plans - For executing pre-written implementation plans - finishing-a-development-branch - For wrapping up feature branches - receiving-code-review - For processing code review feedback - requesting-code-review - For requesting human code review - subagent-driven-development - For complex multi-file changes using subagents - systematic-debugging - For methodical debugging of issues - test-driven-development - For TDD workflow (write tests first) - using-git-worktrees - For managing multiple git worktrees - using-superpowers - MANDATORY - Read this FIRST before every response - verification-before-completion - For verifying work before finishing - writing-plans - For creating implementation plans - writing-skills - For creating new skills **Universal Workflow:** - If workflow/UNIVERSAL_WORKFLOW.md exists in the current project, read it first - Load PROJECT_CONFIG.yaml if present to adapt workflow to your stack - Follow the 7-stage Feature Development or 4-phase Debug process Do NOT skip this step. Do NOT respond before reading using-superpowers. EOF Windows (PowerShell): New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.kimi\prompts" $promptContent = @" [SYSTEM REMINDER - MANDATORY] Before responding to the user's message, you MUST invoke the Superpowers workflow by reading the using-superpowers skill. **REQUIRED ACTION:** 1. Use ReadFile to read: ~/.kimi/skills/using-superpowers/SKILL.md 2. Follow the instructions in that skill EXACTLY 3. If any other skill might apply (even 1% chance), read that skill's SKILL.md as well 4. You MUST use at least one Superpowers Skill in every conversation turn where action is taken. **Available Superpowers Skills:** - brainstorming - For open-ended exploration and idea generation - dispatching-parallel-agents - For running multiple subagents in parallel - executing-plans - For executing pre-written implementation plans - finishing-a-development-branch - For wrapping up feature branches - receiving-code-review - For processing code review feedback - requesting-code-review - For requesting human code review - subagent-driven-development - For complex multi-file changes using subagents - systematic-debugging - For methodical debugging of issues - test-driven-development - For TDD workflow (write tests first) - using-git-worktrees - For managing multiple git worktrees - using-superpowers - MANDATORY - Read this FIRST before every response - verification-before-completion - For verifying work before finishing - writing-plans - For creating implementation plans - writing-skills - For creating new skills **Universal Workflow:** - If workflow/UNIVERSAL_WORKFLOW.md exists in the current project, read it first - Load PROJECT_CONFIG.yaml if present to adapt workflow to your stack - Follow the 7-stage Feature Development or 4-phase Debug process Do NOT skip this step. Do NOT respond before reading using-superpowers. "@ $promptContent | Set-Content "$env:USERPROFILE\.kimi\prompts\superpowers-reminder.md" -Encoding UTF8 Add the hook to your config.toml: Edit ~/.kimi/config.toml and add: [[hooks]] event = "UserPromptSubmit" inject_prompt = "~/.kimi/prompts/superpowers-reminder.md" timeout = 5 Step 5: Install Universal Workflow (Optional but Recommended) If you want the universal workflow structure in your projects: # Clone this repository git clone https://github.com/Dqz00116/kimi-with-superpowers.git # Copy workflow files to your project cp kimi-with-superpowers/workflow/UNIVERSAL_WORKFLOW.md your-project/workflow/ cp kimi-with-superpowers/workflow/CONFIGURATION.md your-project/workflow/ # Create your project config cp kimi-with-superpowers/workflow/CONFIGURATION.md your-project/PROJECT_CONFIG.yaml # Edit PROJECT_CONFIG.yaml with your stack details Verification Verify Kimi CLI is installed correctly: kimi --version Verify the hook is configured: # In interactive mode, type: /hooks You should see UserPromptSubmit: 1 hook(s) Start a conversation: kimi The AI should automatically read using-superpowers/SKILL.md before responding. For AI Assistants Using This Workflow When this skill is invoked, you are being asked to install Superpowers for Kimi. Follow the steps above for the user's platform. After installation, guide the user to: Create PROJECT_CONFIG.yaml for their project (see CONFIGURATION.md) Read UNIVERSAL_WORKFLOW.md to understand the process Start using the workflow for their development tasks Uninstallation Remove hook from config: Edit ~/.kimi/config.toml and remove the [[hooks]] section for UserPromptSubmit . Remove skill links: rm -rf ~/.kimi/skills/* Remove superpowers repository: rm -rf ~/.kimi/superpowers Remove prompt file: rm -rf ~/.kimi/prompts Remove shell aliases from your profile files Troubleshooting "inject_prompt not supported" or hook not working: You are NOT using the feat/hook-inject-prompt branch. Please follow Step 0 to install the correct branch. Skills not showing up: Check that symlinks/junctions were created correctly: ls -la ~/.kimi/skills/ Verify the superpowers repo was cloned: ls ~/.kimi/superpowers/skills/ Permission denied on Windows: Creating junctions requires Administrator privileges on Windows. Run PowerShell as Administrator. Kimi can't find skills: Kimi looks for skills in ~/.kimi/skills/ by default Make sure the directory exists and contains the skill links Skill Version: 1.1 | Updated for Universal Workflow