skills.rest
FerEscobarDev
FerEscobarDevCOMMUNITY
Explore all skills by this author →
Website𝕏@Ferescobar2710GitHub

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
One-click install
npx skills add https://github.com/FerEscobarDev/Specture --skill audit-knowledge-ferescobardev
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
planstack-aiplanstack-ai
8

init

Scaffold Plan Stack workflow directories, templates, and configuration files.

Official
Intermediate
nexus-substratenexus-substrate
18

documentation-management

Update canonical documentation sources and verify indexing and frontmatter conventions.

Official
Advanced
ThePhoenixAgencyThePhoenixAgency

continuous-learning

Identify patterns, document decisions, and extract lessons from session data.

Official
Basic
baskarajatibaskarajati

Firestore Index Sync

Compare Firestore index documentation with firestore.indexes.json and generate a minimal patch to align them.

Community
Intermediate