knowie-judge

Diagnose coherence and alignment of three core knowledge files with repository state.

25|4|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/timcsy/knowie --skill knowie-judge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: knowie-judge
Source: https://github.com/timcsy/knowie/tree/main/skills/knowie-judge
Command: npx skills add https://github.com/timcsy/knowie --skill knowie-judge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams ensure that the core governance knowledge is coherent and aligned with the project reality by auditing three foundational files and their relationships.

Core Features & Use Cases

  • Self-check: verifies internal consistency within knowledge/principles.md, knowledge/vision.md, and knowledge/experience.md.
  • Cross-reference sanity: detects misalignments between the three files and with the actual project state.
  • Actionable guidance: highlights concrete steps to restore harmony and keep the system healthy.

Quick Start

Ask your AI to perform a knowledge health check on principles.md, vision.md, and experience.md and report alignment with the project.

Frequently Asked Questions about knowie-judge

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

FAQPage Schema
How do I audit knowledge files for consistency with my project repository?

Cross-reference sanity checks detect misalignments between principles.md, vision.md, and experience.md by comparing their contents against the actual project state, including repository structure and git history.

Why does my project documentation have governance gaps and misaligned vision?

Actionable guidance for knowledge file remediation provides concrete steps to restore harmony by flagging governance gaps and recommending specific updates to align principles.md, vision.md, and experience.md with project reality.

What is the best way to check if principles.md and vision.md are internally coherent?

Yes, you can audit experience.md alongside principles.md and vision.md to diagnose the coherence of all three core knowledge files and identify any inconsistencies or misalignments with the current project state.

How do I perform a knowledge health check on my project governance files?

A knowledge consistency audit requires access to the three core governance files (principles.md, vision.md, experience.md) and the project repository structure, including git history and top-level documentation, for accurate cross-referencing.

Can I detect misalignments between knowledge files and actual project state automatically?

If knowledge file auditing identifies inconsistencies, it provides clear, actionable recommendations to restore harmony and flags any governance gaps for remediation to keep the governance system healthy.