Skip to main content
skill CX Codex

judgment-distiller — Claude Code skill: decisions and setup

judgment-distiller is a Claude Code skill that turns an accept-or-reject decision and its rationale into a project-scoped learning candidate. It keeps observations separate from broader principles.

MIT ★ 529 updated 2026-11-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ShuaiMXu/happyhands --skill judgment-distiller -a claude-code
Open on GitHub

What judgment-distiller does

judgment-distiller records why a person accepted or rejected a change and shapes that reasoning into a candidate for project learning. It needs the decision and rationale, the finding’s context, and evidence from before and after the change.

Candidates default to project scope and need review before promotion. One judgment cannot establish a universal design rule. If evidence or professional review is missing, the skill returns needs-evidence; a withdrawn judgment remains historical evidence and produces no learning candidate.

What it helps with

  • record why a change was accepted
  • capture the rationale for rejecting a change
  • separate a project observation from a general principle
  • flag missing evidence before proposing a learning candidate

Example prompts for the agent

  • Record why we accepted this change and turn the rationale into a project learning candidate.
  • Review this rejected change, preserving its reason and finding context.
  • Compare the evidence from before and after the change, then identify what is missing.

How to install judgment-distiller

1Skills CLI (Vercel)

npx skills add ShuaiMXu/happyhands --skill judgment-distiller -a claude-code

2Manually: put the files in place

~/.claude/skills/judgment-distiller/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/judgment-distiller/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about judgment-distiller

How do I install judgment-distiller in Claude Code?

Run npx skills add ShuaiMXu/happyhands --skill judgment-distiller -a claude-code. The skill file is at ~/.claude/skills/judgment-distiller/SKILL.md.

What does judgment-distiller do?

It turns the rationale and context behind an accepted or rejected change into a candidate for project learning. It distinguishes observed evidence from inferred principles and requires review before promotion.

Can judgment-distiller derive a universal rule from one decision?

No. A single judgment cannot establish a universal rule, so candidates default to project scope. When evidence or professional review is missing, it returns needs-evidence.

Source text

SKILL.md · MIT
---
name: judgment-distiller
description: "Turn an accept or reject decision and its rationale into a scoped project-learning candidate."
---

# Judgment Distiller

Preserve why a human accepted or rejected a change without over-generalizing.

## Required evidence

- decision and reason
- finding context
- before and after evidence

## Decisions

- Default the candidate to project scope
- Separate observation from inferred principle
- Require review before promotion
- A withdrawn judgment is historical evidence only: return `needs-evidence` with no learning candidate. Retain its original decision and reason for audit; start a new review to reassess it.

## Boundary

One judgment cannot establish a universal design rule.

Return structured evidence, findings, proposed updates and limitations. Use `needs-evidence` when required inputs or professional review are missing. Never invent an Experience Score or promote a project observation into a universal rule.

© ShuaiMXu · MIT · ShuaiMXu/happyhands

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set34

The whole set →
accessibility-reviewer accessibility-reviewer is a Claude Code skill that reviews interface accessibility using browser and source evidence. It checks semantics, keyboard behavior, contrast, and accessible states. CX Codex +1 ★ 529repo stars trust-conversion-reviewer trust-conversion-reviewer is a Claude Code skill that inspects whether visible proof, risk details, and next actions support an informed user choice. CX Codex +1 ★ 529repo stars experience-score-calibrator experience-score-calibrator is a Claude Code skill that calibrates Experience Score dimensions against reviewed evidence. It checks coverage and uncertainty before presenting an aggregate score. CX Codex +1 ★ 529repo stars consistency-auditor consistency-auditor is a Claude Code skill that audits source code against a project Design Foundation to find visual inconsistencies. It flags duplicate literal colors and border-radius values. CX Codex +1 ★ 529repo stars component-reuse-planner component-reuse-planner is a Claude Code skill that decides whether to reuse, extend, or create UI components. The decision relies on the governed project inventory and approved states. CX Codex +1 ★ 529repo stars content-design-reviewer content-design-reviewer is a Claude Code skill that checks interface labels and guidance for clarity and consistency. It ties findings to a user task and its outcome. CX Codex +1 ★ 529repo stars interaction-reviewer interaction-reviewer is a Claude Code skill that reviews interaction flow and control behavior. It detects missing feedback, unnecessary steps, and unsafe UI state transitions. CX Codex +1 ★ 529repo stars information-architecture-reviewer information-architecture-reviewer is a Claude Code skill that audits navigation and content hierarchy against user tasks. It identifies dead ends and ambiguous labels along target flows. CX Codex +1 ★ 529repo stars

Project sponsors

Companies that keep this analytics open