Skip to content

install-for-kimi.md

Latest commit

 

History

History
243 lines (167 loc) · 5.16 KB

install-for-kimi.md

File metadata and controls

243 lines (167 loc) · 5.16 KB

Install Humanize for Kimi CLI

This guide explains how to install the Humanize skills for Kimi Code CLI.

Overview

Humanize provides three Agent Skills for kimi:

Skill Type Purpose
humanize Standard General guidance for all workflows
humanize-gen-plan Flow Generate structured plan from draft
humanize-rlcr Flow Iterative development with Codex review

Installation

Quick Install (Recommended)

From the Humanize repo root, run:

./scripts/install-skills-kimi.sh

This command will:

  • Sync humanize, humanize-gen-plan, and humanize-rlcr into ~/.config/agents/skills
  • Copy runtime dependencies into ~/.config/agents/skills/humanize

Common installer script (all targets):

./scripts/install-skill.sh --target kimi

Manual Install

1. Clone or navigate to the humanize repository

cd /path/to/humanize

2. Copy skills and runtime bundle to kimi's skills directory

# Create the skills directory if it doesn't exist
mkdir -p ~/.config/agents/skills

# Copy all three skills
cp -r skills/humanize ~/.config/agents/skills/
cp -r skills/humanize-gen-plan ~/.config/agents/skills/
cp -r skills/humanize-rlcr ~/.config/agents/skills/

# Copy runtime dependencies used by the skills
cp -r scripts ~/.config/agents/skills/humanize/
cp -r hooks ~/.config/agents/skills/humanize/
cp -r prompt-template ~/.config/agents/skills/humanize/

# Hydrate runtime root placeholders inside SKILL.md files
for skill in humanize humanize-gen-plan humanize-rlcr; do
  sed -i.bak "s|{{HUMANIZE_RUNTIME_ROOT}}|$HOME/.config/agents/skills/humanize|g" \
    "$HOME/.config/agents/skills/$skill/SKILL.md"
done

3. Verify installation

# List installed skills
ls -la ~/.config/agents/skills/

# Should show:
# humanize/
# humanize-gen-plan/
# humanize-rlcr/

4. Restart kimi (if already running)

Skills are loaded at startup. Restart kimi to pick up the new skills:

# Exit current kimi session
/exit

# Or press Ctrl-D

# Start kimi again
kimi

Usage

List available skills

/help

Look for the "Skills" section in the help output.

Use the skills

1. Generate plan from draft

# Start the flow (will ask for input/output paths)
/flow:humanize-gen-plan

# Or load as standard skill
/skill:humanize-gen-plan

2. Start RLCR development loop

# Start with plan file
/flow:humanize-rlcr path/to/plan.md

# With options
/flow:humanize-rlcr path/to/plan.md --max 20 --push-every-round

# Skip implementation, go directly to code review
/flow:humanize-rlcr --skip-impl

# Load as standard skill (no auto-execution)
/skill:humanize-rlcr

3. Get general guidance

/skill:humanize

Command Options

RLCR Loop Options

Option Description Default
path/to/plan.md Plan file path Required (unless --skip-impl)
--max N Maximum iterations 42
--codex-model MODEL:EFFORT Codex model gpt-5.4:xhigh
--codex-timeout SECONDS Review timeout 5400
--base-branch BRANCH Base for code review auto-detect
--full-review-round N Full alignment check interval 5
--skip-impl Skip to code review false
--push-every-round Push after each round false

Generate Plan Options

Option Description Required
--input <path> Draft file path Yes
--output <path> Plan output path Yes

Prerequisites

Ensure you have codex CLI installed:

codex --version

The skills will use gpt-5.4 with xhigh effort level by default.

Uninstall

To remove the skills:

rm -rf ~/.config/agents/skills/humanize
rm -rf ~/.config/agents/skills/humanize-gen-plan
rm -rf ~/.config/agents/skills/humanize-rlcr

Troubleshooting

Skills not showing up

  1. Check the skills directory exists:

    ls ~/.config/agents/skills/

  2. Ensure SKILL.md files are present:

    cat ~/.config/agents/skills/humanize/SKILL.md | head -5

  3. Restart kimi completely

Codex not found

The skills expect codex to be in your PATH. If using a proxy, ensure ~/.zprofile is configured:

# Add to ~/.zprofile if needed
export OPENAI_API_KEY="your-api-key"
# or other proxy settings

Scripts not found

If skills report missing scripts like setup-rlcr-loop.sh, verify:

ls -la ~/.config/agents/skills/humanize/scripts

Installer options

The installer supports:

./scripts/install-skill.sh --help

Common examples:

# Preview only
./scripts/install-skills-kimi.sh --dry-run

# Custom skills directory
./scripts/install-skills-kimi.sh --skills-dir /custom/skills/dir

Output files not found

The skills save output to:

  • Cache: ~/.cache/humanize/<project>/<timestamp>/
  • Loop data: .humanize/rlcr/<timestamp>/

Ensure these directories are writable.

See Also