Can I integrate Dewey Health into a CI/CD pipeline?

Yes, Tier 1 checks are specifically designed to be fast and CI-friendly, allowing you to catch structural documentation issues automatically during the build process.

What issues does the skill identify?

It identifies missing required sections, broken cross-references, stale validation dates, readability issues, source drift, and gaps in coverage compared to the project's goals.

How does the three-tier validation process work?

Tier 1 uses Python for fast, deterministic structural checks; Tier 2 uses Claude for qualitative content assessment; and Tier 3 surfaces subjective decisions that require human intervention.

What is Dewey Health?

Dewey Health is a Claude Code skill designed to validate the quality, structure, and freshness of documentation and knowledge bases using a multi-tiered approach.

How do I run a full audit of my knowledge base?

You can initiate a comprehensive review by running the command `/dewey:health audit` within your Claude Code environment.

Dewey Knowledge Base Health

Name: Dewey Knowledge Base Health
Author: bcbeidel

bybcbeidel

•

Learning & Documentation

Ensures the quality, accuracy, and structural integrity of knowledge bases through multi-tier validation and automated reporting.

Dewey Health is a specialized validation suite designed to maintain high-quality knowledge bases by combining fast deterministic checks with LLM-assisted analysis. It operates across three tiers: Tier 1 performs automated structural and readability audits; Tier 2 utilizes Claude to evaluate source drift and content depth; and Tier 3 surfaces complex relevance decisions for human review. By generating actionable health reports and tracking historical quality scores, it helps teams identify coverage gaps, refresh stale information, and ensure that AI-ready documentation remains accurate, grounded, and well-structured.

Key Features

01Coverage gap analysis against defined agent roles and responsibilities

02Automated structural checks for frontmatter, section hierarchy, and readability

03Intelligent freshness tracking with staleness reporting and urgency sorting

04Three-tier validation combining Python scripts, LLM analysis, and human judgment

052 GitHub stars

06Historical health score logging and documentation utilization tracking

Use Cases

01Automating quality assurance for large-scale documentation projects

02Maintaining technical accuracy through scheduled content freshness audits

03Identifying and filling gaps in organizational knowledge bases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bcbeidel/dewey health

For use in Claude.ai and ChatGPT

Download Skill