judgment_log

Writes structured judgment logs recording decisions, evidence, confidence, and next verification steps.

4|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/synthaicode/XRefKit --skill judgment-log-synthaicode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: judgment_log
Source: https://github.com/synthaicode/XRefKit/tree/main/skills/os/judgment_log
Command: npx skills add https://github.com/synthaicode/XRefKit --skill judgment-log-synthaicode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI-assisted work often produces non-trivial decisions whose reasoning, evidence, and uncertainty are lost once the session ends. This Skill preserves those judgments in a standardized, reviewable log so decisions remain inspectable and reusable later. ## Core Features & Use Cases - Structured Judgment Records: Captures the decision, decision status (proposed, accepted, rejected, unknown, deferred), evidence, evidence type, confidence, alternatives, and open questions using a canonical schema. - Evidence Classification: Separates observed facts from inferred conclusions and classifies evidence as deterministic, context_extracted, or inferred, downgrading weakly supported conclusions to unknown. - Use Case: After reviewing a code change and deciding to reject it based on partial evidence, use this Skill to write a judgment log in work/judgments/ that records the decision, the exact evidence paths, remaining open questions, and the next recommended verification step. ## Quick Start Write a judgment log for the decision to reject the mail sender change, using the evidence in the review notes and marking confidence as medium.

Frequently Asked Questions about judgment_log

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record an AI decision with its evidence and confidence?▼

Use the judgment log workflow: provide the work type, target, decision, evidence paths, and confidence level. The Skill writes a structured log in work/judgments/ capturing decision status, evidence type, alternatives, open questions, and the next verification step.

What is a judgment log in AI-assisted workflows?▼

A judgment log is a structured record of a non-trivial decision that stores the decision, its status, supporting evidence, evidence classification, confidence, alternatives, and open questions. It keeps AI reasoning reviewable and reusable after the session ends.

How are facts separated from inferred conclusions in a judgment log?▼

Evidence is classified as deterministic, context_extracted, or inferred during planning. Conclusions supported only by inferred evidence are downgraded to unknown status unless explicit provisional acceptance exists, preserving uncertainty instead of overstating it.

What happens when evidence is missing for a decision?▼

The log is still written, but the decision status is recorded as unknown with the missing evidence explicitly noted. This prevents inferred-only judgments from being presented as completed facts.

When should I not use a judgment log?▼

Skip it for trivial or fully deterministic decisions with no meaningful alternatives or uncertainty. The Skill is intended for non-trivial judgments where confidence is mixed, alternatives exist, or the reasoning should be inspectable later.