Skip to content

install-for-codex.md

Latest commit

 

History

History
76 lines (54 loc) · 1.83 KB

install-for-codex.md

File metadata and controls

76 lines (54 loc) · 1.83 KB

Install Humanize Skills for Codex

This guide explains how to install the Humanize skills for Codex skill runtime ($CODEX_HOME/skills).

Quick Install (Recommended)

One-line install from anywhere:

tmp_dir="$(mktemp -d)" && git clone --depth 1 https://github.com/humania-org/humanize.git "$tmp_dir/humanize" && "$tmp_dir/humanize/scripts/install-skills-codex.sh"

From the Humanize repo root:

./scripts/install-skills-codex.sh

Or use the unified installer directly:

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

This will:

  • Sync humanize, humanize-gen-plan, and humanize-rlcr into ${CODEX_HOME:-~/.codex}/skills
  • Copy runtime dependencies into ${CODEX_HOME:-~/.codex}/skills/humanize
  • Use RLCR defaults: codex exec with gpt-5.4:xhigh, codex review with gpt-5.4:high

Verify

ls -la "${CODEX_HOME:-$HOME/.codex}/skills"

Expected directories:

  • humanize
  • humanize-gen-plan
  • humanize-rlcr

Runtime dependencies in humanize/:

  • scripts/
  • hooks/
  • prompt-template/

Installed files/directories:

  • ${CODEX_HOME:-~/.codex}/skills/humanize/SKILL.md
  • ${CODEX_HOME:-~/.codex}/skills/humanize-gen-plan/SKILL.md
  • ${CODEX_HOME:-~/.codex}/skills/humanize-rlcr/SKILL.md
  • ${CODEX_HOME:-~/.codex}/skills/humanize/scripts/
  • ${CODEX_HOME:-~/.codex}/skills/humanize/hooks/
  • ${CODEX_HOME:-~/.codex}/skills/humanize/prompt-template/

Optional: Install for Both Codex and Kimi

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

Useful Options

# Preview without writing
./scripts/install-skills-codex.sh --dry-run

# Custom Codex skills dir
./scripts/install-skills-codex.sh --codex-skills-dir /custom/codex/skills

Troubleshooting

If scripts are not found from installed skills:

ls -la "${CODEX_HOME:-$HOME/.codex}/skills/humanize/scripts"