skill-evolver

CLI-backed workflow for iterating a local Codex skill repository.

Skill-first User Path

Install the Skill Evolver collection first:

npx --registry=https://registry.npmjs.org skills add jax-ho/skill-evolver --skill '*'

Then open a target skill repository that contains SKILL.md and ask Codex to use skill-evolver. Codex runtime resolves the orchestrator and worker skills from the installed collection.

The orchestrator checks whether the skill-evolver CLI is available. If it is missing, the orchestrator attempts to install it from npm:

npm install -g @jaxho/skill-evolver --registry=https://registry.npmjs.org

After the CLI is available, the orchestrator runs the normal loop:

skill-evolver status
skill-evolver init
skill-evolver run

Single-skill Fallback

If you need to install one skill at a time, use the same source with an explicit skill name:

npx --registry=https://registry.npmjs.org skills add jax-ho/skill-evolver --skill skill-evolver
npx --registry=https://registry.npmjs.org skills add jax-ho/skill-evolver --skill skill-evolver-case-builder
npx --registry=https://registry.npmjs.org skills add jax-ho/skill-evolver --skill skill-evolver-answer-runner
npx --registry=https://registry.npmjs.org skills add jax-ho/skill-evolver --skill skill-evolver-answer-judge
npx --registry=https://registry.npmjs.org skills add jax-ho/skill-evolver --skill skill-evolver-gap-analyzer
npx --registry=https://registry.npmjs.org skills add jax-ho/skill-evolver --skill skill-evolver-skill-editor

skill-evolver init initializes project state only; it does not validate worker skill installation paths. Use skill-evolver doctor skills only as a best-effort local file path diagnostic when debugging a local environment.

Local Source Checkout

From this repository:

bun install
bun run build
node dist/cli.js --help

For local source dogfood, prefer installing the public collection first, then testing the built CLI from this checkout.