An agentic skills framework & software development methodology that works.
Skill lifecycle system for Claude Code skills
Skill Conductor is a meta-level skill for building other skills with an architecture-first process. It guides you through design, build, test, evaluate, package, and improvement loops, with binary question-based judging and a held-out gate for changes.
Builders who write or maintain reusable skills for Claude Code and want a more disciplined way to validate them.
You can create and improve skills with clearer architecture choices, better evaluation, and fewer bad rewrites.
What it does
Architecture-first workflow
Forces a design step before implementation, with patterns like sequential, iterative, context-aware, domain intelligence, and multi-MCP coordination.
BinEval judging
Uses binary yes/no quality questions with evidence instead of a single vague score, and passes only when critical questions are yes.
Gated self-update loop
Feeds failing evaluation questions back into targeted edits, then checks for regressions before accepting changes.
Pressure testing
Includes pressure-test guidance and micro-test protocols for checking whether a skill still works under tougher prompts.
Skill authoring principles
Bundles research-backed authoring rules such as no-process-in-description, MOC structure, one-term-per-concept, and cut-the-fat.
Claude Code plugin support
Can be installed as a Claude Code plugin as well as through skills.sh.
How to get it
- 1Run
# skills.sh — installs into ~/.claude/skills npx skills add smixs/skill-conductor
- 2Run
# Claude Code plugin /plugin marketplace add smixs/skill-conductor /plugin install skill-conductor@smixs
README
Skill Conductor
A skill that creates, evaluates, and improves other skills. Meta-level.
Architecture-first skill lifecycle: design → build → test → evaluate → package.
Most skill tools jump straight to "write SKILL.md." Conductor makes you choose the architecture first — because rewriting a wrong pattern costs more than writing it right.
Install
# skills.sh — installs into ~/.claude/skills
npx skills add smixs/skill-conductor
# Claude Code plugin
/plugin marketplace add smixs/skill-conductor
/plugin install skill-conductor@smixs
v3.2.0 — Evidence-based upgrade: form-matching, judge calibration, pressure testing
- Principle #10: Match the form to the failure — classify the baseline failure before writing a rule; prohibitions bulletproof discipline failures but measurably backfire on shaping failures (obra/superpowers wording tests + Guardrails polarity data). Plus: no nuance clauses, exemption clauses don't scope.
- Critique-before-verdict judges — all three eval agents (grader, comparator, bineval) now write the detailed evidence critique BEFORE committing to the 1/0 verdict, with a borderline few-shot example in each (Hamel Husain's judge methodology).
- Threshold-blind judging — the BinEval judge no longer computes the overall score or the GATE; the orchestrator aggregates. A judge that knows the bar is biased toward it.
- Automatic cross-family judge calibration — a second judge from a different model family answers the same bank; stable disagreement flags a badly worded question, not a dispute. Self-preference-bias guard on final acceptance.
- Variance discipline — improvements on non-critical questions count only when they reproduce in 2 consecutive runs; the 3-iteration cap now carries its STICK rationale.
references/pressure-testing.md— micro-test protocol (no-guidance control, 5+ reps, variance as a metric) + pressure scenarios for discipline skills (7 pressure types, forced A/B/C choice, rationalization tables).- Pushy description formula —
[What] + Use when [4-5 phrasings] + "even if they don't explicitly say '<canonical term>'" + Do NOT use for [...], deduped to a single canonical home in Principle #2. - Question bank v1.1 — 5 new questions: pushy triggers, nuance clauses, directive reference loading, time-rot language, redundant-content (E:A:R).
- Self-hosted proof — this release was produced by Conductor evaluating and improving itself: 3 gated iterations, dual-family judges (Claude + GPT via codex), all critical questions passing.
v3.1.0 — Gated self-update: held-out gate + edit budget (SkillOpt core)
- Held-out gate for body edits — Mode 2 IMPROVE now splits evals into train/held-out (
scripts/split_evals.py, deterministic, stratified by optionalevals[].category). Lessons and edits come from TRAIN only; a candidate is accepted iff no held-out assertion regresses (flip-confirmation re-run for noise), train pass-rate strictly improves, and no new critical failure. Methodology borrowed from microsoft/SkillOpt. - Edit budget — at most 3 atomic edits per iteration (one edit = one lesson, labeled); no wholesale rewrites, so gate rejections stay attributable.
- Case transitions — assertion-level diff parent→candidate (improved / regressed / persistent-fail / stable-success) recorded as an additive
transitionsblock in benchmark.json. - Refactor —
split_eval_setgeneralized intoutils.split_evals(stratify_key=...);run_loop.py(Mode 5 OPTIMIZE) delegates to it, split unchanged bit-for-bit.
v3.0.0 — BinEval scoring, English canon, dual-channel install
- BinEval evaluation — replaces the old 5-axis 1-10 scoring with atomic binary yes/no questions across 5 dimensions (Discovery, Clarity, Structure, Robustness, Completeness). Each answer carries grounding evidence; the pass criterion is a gate on critical questions, not an opaque number. Adapted from "Ask, Don't Judge" (arXiv 2606.27226).
- Deterministic + LLM split —
eval_skill.py --jsonemits structural checks as binary question records; an evaluator agent answers the judgment questions with evidence and a self-update loop feeds failing questions back into edits. - 9 authoring principles — a universal canon (pre-flight, no-process-in-description, MOC, fresh-practitioner author, TWI "why", blind-agent test, inline checklists, one-term-per-concept, cut-the-fat) in
references/sop-practices.md, applied to every skill. - Dual-channel install — one repo, one source of truth, installable via skills.sh and the Claude Code plugin marketplace.
v3: SOP practices + smoke tests
references/sop-practices.md— 80 years of Standard Operating Procedure wisdom applied to skill authoring. Inline checklists at risk-points, pre-flight checks, programmatic validation, exception handling patterns. Use for procedural skills (client intake, onboarding, reporting, escalation)scripts/test_smoke.py— fast safety net for skill-conductor scripts themselves. Verifies critical scripts execute on known-good skills, fail on known-bad, produce expected output shapes. Run:uv run scripts/test_smoke.py- Updated eval agents (grader, comparator, analyzer) with refined rubrics
- Improved
package_skill.py,eval_skill.py, and schema validation - Updated
patterns.mdandschemas.mdwith tighter definitions
v2: Anthropic's eval engine meets architecture-first design
Anthropic updated their skill-creator with serious eval infrastructure. We took the best of it:
From Anthropic's skill-creator:
- 3 specialized agents: grader (assertion checking + claim extraction), comparator (blind A/B testing), analyzer (post-hoc root cause analysis)
- Parallel eval execution with isolated contexts (no cross-contamination)
- Automated description optimization with train/test split (60/40)
- Benchmark tracking: pass rate, tokens, time with variance analysis
- HTML eval viewer with qualitative + quantitative tabs
What Conductor adds on top:
- Architecture before code. 5 patterns (Sequential, Iterative, Context-Aware, Domain Intelligence, Multi-MCP) with selection criteria. Pick wrong = rewrite everything later
- Degrees of freedom. Low (deterministic scripts) → Medium (pseudocode) → High (free text). Match freedom to risk tolerance
- TDD RED before writing. Verify the agent fails WITHOUT the skill first. If it already handles the task — you don't need a skill
- Quality scoring with a gate (now BinEval — see v1.0.0). Numbers and evidence, not a "vibe check"
- Skill categorization. Capability uplift (teaching something new) vs Encoded preference (sequencing known abilities). Different skills need different testing strategies
Synthesized from
- Anthropic Skill Creator — eval infrastructure, grader/comparator/analyzer agents, benchmark pipeline
- The Complete Guide to Building Skills for Claude — architecture patterns, success metrics
- Superpowers / writing-skills by Jesse Vincent — TDD approach, the "description trap" discovery, match-the-form-to-the-failure, the micro-test protocol, pressure scenarios and rationalization tables
- Skills Best Practices by Minko Gechev — three-stage LLM validation, eval methodology
- hamelsmu/evals-skills by Hamel Husain — critique-before-verdict judge outputs, borderline few-shot examples, judge calibration discipline
- grafana/skills — skill-authoring — the pushy description pattern in production, judge score-variance discipline ("three consecutive local passes before shipping")
- softaworks/agent-toolkit — skill-judge — the Expert/Activation/Redundant knowledge-delta taxonomy, directive loading triggers, the freedom-consequence test
- neolabhq/context-engineering-kit — threshold-blind judges (never tell the judge the bar)
- trailofbits/skills — skill-improver — the stop-hook pattern for unattended improvement loops (referenced, not implemented)
Methodology foundations
- Standard Operating Procedures: A Writing Guide — Richard Stup, Penn State Extension. Format selection, hierarchical vs. flowchart procedures.
- Procedure Writing: Principles and Practices — Wieringa, Moore & Barnes (Battelle Press, 1998). Imperative steps, removing modal weasel-words.
- Toyota TWI (Training Within Industry) — the "Job Instruction" method: step → key point → why; the 5 Whys root-cause practice (Job Methods manual, The Roots of Lean).
- McDonald's Operations Manual — the canonical 600+ page SOP system; checklists at the point of use. The manual itself is proprietary; it is documented in John F. Love's McDonald's: Behind the Arches.
- Ask, Don't Judge: Binary Questions for Interpretable LLM Evaluation and Self-Improvement — the BinEval method behind Conductor's evaluation.
- Guardrails Beat Guidance (5000+ Claude Code runs on SWE-bench) — rule polarity: helpful rules are negative constraints, harmful ones positive directives → Principle #10.
- TICK: Generated Checklists Improve LLM Evaluation and Generation — checklist as spec + eval + feedback; refinement plateaus and degrades past 3–4 iterations → the 3-iteration cap.
- CheckEval and Prosa — binary decomposition makes judges reproducible across model families → cross-family judge calibration.
- Self-Preference Bias in Rubric-Based Evaluation — judges favor their own family even on binary rubrics → the out-of-family acceptance rule.
- LLMs Cannot Self-Correct Reasoning Yet and BIG-Bench Mistake — self-correction needs an external gate; models fix errors well only when an external checker locates them → the gated self-update loop.
- SkillJuror — progressive disclosure with explicit loading triggers beats both flat files and passive reference lists → directive loading rules.
- SkillReducer — >60% of public skill-body text changes no agent behavior → the actionability test in Principle #9.
- IFScale and Prompt Design at Scale — compliance collapses near 80 simultaneous rules; format matters less than rule count → the rule budget and MOC structure.
6 Modes
| Mode | What it does |
|---|---|
| CREATE | Architecture selection → TDD baseline → scaffold → write → verify → refactor |
| IMPROVE | Diagnose → eval loop → self-update loop (failing questions → targeted edits) → iterate |
| VALIDATE | Structural checks + trigger testing + BinEval scoring |
| REVIEW | Pass/fail quality gate for third-party skills before you install them |
| OPTIMIZE | Auto-tune the description for accurate triggering with a train/test split |
| PACKAGE | Validate structure + package as .skill for distribution |
Architecture patterns
Choose before writing a single line:
| Pattern | Use when |
|---|---|
| Sequential workflow | Clear step-by-step process |
| Iterative refinement | Output improves with cycles |
| Context-aware selection | Same goal, different tools by context |
| Domain intelligence | Specialized knowledge beyond tool access |
| Multi-MCP coordination | Workflow spans multiple services |
Eval infrastructure
┌─────────┐
│ SKILL │
└────┬────┘
│
┌──────────┼──────────┐
│ │ │
┌────▼────┐ ┌──▼───┐ ┌───▼────┐
│ Grader │ │ A/B │ │Analyzer│
│ │ │Blind │ │ │
│assertions│ │compare│ │root │
│+ claims │ │ │ │cause │
└─────────┘ └──────┘ └────────┘
│ │ │
└──────────┼──────────┘
│
┌─────▼─────┐
│ Benchmark │
│ mean±std │
└───────────┘
Quality is scored with BinEval: binary yes/no questions per dimension, each answered with evidence; the skill passes when every critical question answers yes — not when a scalar clears a threshold.
Installation layout
skills/
└── skill-conductor/
├── SKILL.md
├── agents/
│ ├── grader.md
│ ├── comparator.md
│ ├── analyzer.md
│ └── bineval.md
├── eval-viewer/
│ ├── generate_review.py
│ └── viewer.html
├── references/
│ ├── patterns.md
│ ├── schemas.md
│ ├── sop-practices.md
│ ├── bineval-method.md
│ ├── quality-questions.md
│ ├── pressure-testing.md
│ └── runtime-setup.md
├── assets/
│ └── eval_review.html
└── scripts/
├── init_skill.py
├── eval_skill.py
├── run_eval.py
├── run_loop.py
├── improve_description.py
├── aggregate_benchmark.py
├── generate_report.py
├── package_skill.py
├── quick_validate.py
├── test_smoke.py
└── utils.py
Claude Code: the install commands above drop it into .claude/skills/. Auto-activates when the agent detects a skill-building task.
Key discovery
Never put process steps in the skill description. If your description says "exports assets, generates specs, creates tasks" — the model follows the description and skips the body. Tested experimentally.
# ✅ Good
description: Analyze design files for developer handoff. Use when user uploads .fig files.
# ❌ Bad - model follows this and ignores SKILL.md body
description: Exports Figma assets, generates specs, creates Linear tasks, posts to Slack.
License
MIT — see LICENSE.
Files in the repo
- .claude-plugin
- assets
- skills
- .gitignore
- LICENSE
- README.md
Discussion (0)
Ask about usage, or say what you built with itSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.
Public repository for Agent Skills
Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

Production-grade engineering skills for AI coding agents.