Skip to content

install-for-codex.md

Latest commit

 

History

History
84 lines (62 loc) · 2.13 KB

install-for-codex.md

File metadata and controls

84 lines (62 loc) · 2.13 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/PolyArch/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, humanize-refine-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:high, codex review with gpt-5.4:high

Verify

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

Expected directories:

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

Runtime dependencies in humanize/:

  • scripts/
  • hooks/
  • prompt-template/
  • templates/
  • config/
  • agents/

Installed files/directories:

  • ${CODEX_HOME:-~/.codex}/skills/humanize/SKILL.md
  • ${CODEX_HOME:-~/.codex}/skills/humanize-gen-plan/SKILL.md
  • ${CODEX_HOME:-~/.codex}/skills/humanize-refine-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/
  • ${CODEX_HOME:-~/.codex}/skills/humanize/templates/
  • ${CODEX_HOME:-~/.codex}/skills/humanize/config/
  • ${CODEX_HOME:-~/.codex}/skills/humanize/agents/

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"