j-rig — Skill Refiner

Overview

The Skill Refiner is the eval-guided improvement loop for SKILL.md files.

It analyzes an existing skill against measured behavior, proposes safe, minimal,

bounded edits, and accepts an edit only when it strictly improves. It is the

second product in the Intent Solutions agent-rig stack:

J-Rig Skill Binary Eval   ->   Skill Refiner   ->   Rollout Gate
      (test)                     (improve)             (ship)

The refiner proposes bounded edits (add, delete, or replace operations on the

SKILL.md text) and accepts an edit **only if a held-out eval score strictly

improves** with no regression on any other case. It never rewrites a skill

wholesale, and it never lets a skill judge itself; scoring is delegated to the

separate j-rig eval harness.

This plugin is a thin wrapper. The refiner logic lives in the published

@intentsolutions/refiner package and is exposed through the j-rig refine

command group in the @intentsolutions/jrig-cli binary. This skill invokes that

CLI; it does not reimplement any refiner logic.

Use this skill when:

• Improving an existing skill whose behavior you can measure.
• Bootstrapping a held-out eval set for a skill so you have something to score

against.

• Proposing a bounded SKILL.md edit and checking whether it strictly improves.
• Gating skill edits before they ship (the 3-layer hooks do this automatically).

Do NOT use it to hand-author a brand-new skill from scratch; use

/skill-creator for that. The refiner improves skills that already exist and

already have measurable behavior.

Prerequisites

The subcommands wrap the published j-rig binary. Install it once:

# Global — gives you the `j-rig` command everywhere
npm install -g @intentsolutions/jrig-cli

# Or per-repo (recommended for CI version-pinning)
pnpm add -D @intentsolutions/jrig-cli   # then: pnpm exec j-rig --help

The refine command group is contributed by @intentsolutions/refiner, which

ships as a dependency of the CLI. Model-backed steps (score, propose)

require the ANTHROPICAPIKEY environment variable; the deterministic steps

(bootstrap, apply, status) run fully offline.

Instructions

Each /j-rig subcommand maps one-to-one onto a j-rig refine verb. Run them

against a skill directory (the folder containing the SKILL.md).