J-Rig Skill Refiner
Overview
Use the existing refiner CLI to inspect a skill, generate a bounded edit proposal and collect evaluation evidence. Distinguish a proposal, a stored candidate, measured improvement and an approved source change. These are separate steps; command success is not proof that a candidate improves behavior.
The bundled hooks are experimental integration code. They do not establish an automatic quality gate. Read the audited command and hook limits before relying on them or using a different CLI release.
Prerequisites
- An existing skill directory containing
SKILL.md, the requested operation and an agreed working directory for .j-rig/refiner artifacts.
- A separately installed compatible
@intentsolutions/jrig-cli. Prefer an existing project-pinned installation; do not install or upgrade packages merely to inspect a skill. Use the resolved CLI version and its refine --help as evidence.
- For evaluation or proposal calls, an authorized provider/model, input-data scope, credential source and bounded spend/run scope. A present key is not authorization.
- For source changes, the project's review rules and actual promotion decision.
Auth and data
score and propose can transmit skill or evaluation content to a provider and incur charges. Use only the approved route and runtime secret source; never put a key in a command example, report, committed file or terminal output. The audited CLI supports multiple provider routes; Anthropic is not universally required. Select provider and model explicitly rather than relying on whichever key happens to be present. Respect existing evaluation wrappers and database boundaries; refiner work must not write to a Freshie runtime database.
The offline commands also write local artifacts where indicated below. Use an agreed scratch/project location and do not enable or invoke hooks as a side effect of evaluating a skill. If provider authorization is missing, continue inspection or requested offline preparation and leave provider-dependent steps pending.
Instructions
- Use Glob to find the selected skill and Read its content and evaluation spec. Record its source revision/hash, intended behavior and relevant constraints. Use Bash(git:\*) for authorized diff inspection, preserving unrelated work.
- Inspect the installed CLI version and help using Bash(j-rig:) or the project-pinned Bash(pnpm exec j-rig:) launcher. The command table in the linked reference describes the audited versions, not every future release. Do not silently change tools or route through a global CLI with a different version.
- For requeste…