skills.rest
yoshisada
yoshisadaCOMMUNITY
Explore all skills by this author →
GitHub

kiln-claude-audit

Audit CLAUDE.md against the kiln rubric and generate a git-diff-shaped proposal.

Updated Mar 26, 2026
Search Tags:#automation#rubric#CLAUDE.md#git-diff#kiln#claude-audit#diff-proposal
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill kiln-claude-audit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kiln-claude-audit
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-kiln/skills/kiln-claude-audit
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill kiln-claude-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md is often out of sync with kiln usefulness expectations, leading to drift between documented capabilities and runtime behavior; this skill audits CLAUDE.md against the kiln rubric and surfaces a git-diff-shaped removal/archival proposal, without applying edits, for human review.

Core Features & Use Cases

  • Full rubric execution (cheap + editorial signals) on CLAUDE.md.
  • Generates a deterministic git-diff-shaped proposal written to .kiln/logs for human review.
  • No automatic edits; outputs are intended to guide maintainers in archiving or removing outdated material.

Quick Start

Run the kiln-claude-audit skill on a repository containing CLAUDE.md to generate a diff proposal in .kiln/logs.

Frequently Asked Questions about kiln-claude-audit

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

FAQPage Schema
How do I audit CLAUDE.md for outdated or drifted content?▼

Auditing CLAUDE.md involves running a rubric against the file to detect drift from expected behavior, generating a git-diff-shaped removal or archival proposal for human review without applying automatic edits.

What is a git-diff-shaped proposal for file archival?▼

A git-diff-shaped proposal is a deterministic output format that describes proposed removals or archivals, written to log files so maintainers can review exactly what should change before manually applying edits.

Can I automatically apply changes when auditing CLAUDE.md?▼

No, the audit never applies automatic edits. It writes a diff-shaped proposal to the .kiln/logs directory, ensuring all removal or archival decisions are reviewed and executed manually.

How do I generate a removal proposal for CLAUDE.md without modifying the file?▼

Run the audit skill on a repository containing CLAUDE.md. It executes cheap and editorial signals against a usefulness rubric, producing a diff proposal in .kiln/logs that remains empty if no drift is detected.

Does the CLAUDE.md audit support custom rubric paths?▼

Yes, the audit supports optional overrides for rubric paths and best-practices caches, allowing customization of the evaluation criteria applied to the CLAUDE.md file during the drift detection process.

What happens if no drift is detected in CLAUDE.md?▼

If drift is not detected during the rubric execution, the produced git-diff-shaped proposal remains empty, indicating no outdated material was found and no removal or archival actions are necessary.

Related Skills

Explore More Software Engineering Skills→
lexicalninjalexicalninja

setup-project

Create a federal procurement proposal review directory structure with template files and CLAUDE.md.

Community
Intermediate
jorgeochipinti97jorgeochipinti97

claude-md-keeper

Detect drift between CLAUDE.md and project state, then generate a reviewable proposed diff.

Community
Advanced
yoshisadayoshisada

kiln-init

Initialize kiln in an existing repository with harness, scaffolding, and workflow hooks.

Community
Intermediate
bbvch-aibbvch-ai
9

implement-feedback-from-pr

Implements GitHub PR review feedback for the aihub-core monorepo with lint and tests.

Official
Advanced