audit-knowledge

Audits the docs-index for orphan, stale, duplicate, and uncovered documentation drift.

1|Updated May 1, 2026

Search Tags:#documentation #knowledge management #drift detection #audit #alias #docs-index #specture

Ready to run

npx skills add https://github.com/FerEscobarDev/Specture --skill audit-knowledge-ferescobardev

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: audit-knowledge
Source: https://github.com/FerEscobarDev/Specture/tree/main/skills/audit-knowledge
Command: npx skills add https://github.com/FerEscobarDev/Specture --skill audit-knowledge-ferescobardev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Over time, a project's documentation index drifts out of sync with reality: entries point to deleted files, stale docs linger, duplicates accumulate, and new documents go unindexed. This Skill detects that drift so the knowledge base stays trustworthy. ## Core Features & Use Cases - Four Drift Checks: Detects orphan entries, stale entries, duplicate records, and uncovered documents in the docs-index. - Fixed Severity Table: Classifies each finding with a consistent severity rating for triage. - Audit Reports: Writes results to `last-audit.md` and appends history to `audit-history.jsonl` under a read-only contract that never mutates the docs themselves. - Use Case: After several sprints of documentation changes, run the audit to find index entries referencing deleted files and unindexed new docs before they mislead the team. ## Quick Start Invoke /specture:audit-knowledge to audit the docs-index and review the generated drift report.

Frequently Asked Questions about audit-knowledge

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

FAQPage Schema

How do I audit a documentation index for stale or orphan entries?▼

Invoke /specture:audit-knowledge, which runs the knowledge skill in audit mode. It performs four drift checks (orphan, stale, duplicate, uncovered) and writes findings to last-audit.md with a fixed severity table.

What is the difference between audit-knowledge and the knowledge skill?▼

audit-knowledge is a backward-compatible alias preserved for muscle memory. Since v1.11.0 it simply invokes the unified knowledge skill in audit mode; the full procedure lives in skills/knowledge/SKILL.md.

Does the docs-index audit modify my documentation files?▼

No. The audit operates under a read-only contract. It only detects drift and writes reports to last-audit.md and audit-history.jsonl without altering the indexed documentation.

Where are documentation audit results stored?▼

Results are written to last-audit.md for the most recent run and appended to audit-history.jsonl for a chronological record of all audits, each finding classified with the fixed severity table.

When should I run a docs-index drift audit?▼

Run it periodically, especially after sprints with heavy documentation changes, to catch entries pointing to deleted files, outdated docs, duplicates, and new documents that were never indexed.