docs-compliance-codebase

Audit Markdown documentation against codebase references using scan and lint scripts.

Updated Dec 13, 2025
One-click install
npx skills add https://github.com/Posteriot/makalah-app --skill docs-compliance-codebase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-compliance-codebase
Source: https://github.com/Posteriot/makalah-app/tree/main/.codex/skills/project/docs-compliance-codebase
Command: npx skills add https://github.com/Posteriot/makalah-app --skill docs-compliance-codebase

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill eliminates uncertainty about documentation accuracy by auditing Markdown guides against real code paths, naming, and platform expectations so teams avoid misleading or outdated content.

Core Features & Use Cases

  • Scope clarification: Guides users to define the docs targets, audience, and coverage before beginning work.
  • Automated scanning and linting: Executes the scan_codebase.py mapping plus lint_markdown.py to identify structural faults and missing links.
  • Compliance review: Compares documentation to rules in references/compliance-rules.md, ensuring terminology, API, and platform claims match the actual repo state.
  • Use Case: When releasing a new feature, use this Skill to confirm the public README, API guides, and integration notes all faithfully describe the current backend flags, routes, and dependencies.

Quick Start

Describe the documentation scope, run the scan and lint scripts, and summarize the compliance gaps with the rubric before requesting revisions.

Frequently Asked Questions about docs-compliance-codebase

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

FAQPage Schema
How do I audit Markdown documentation against my codebase before a release?

To audit Markdown documentation against a codebase, define your scope, run the scan_codebase and lint_markdown scripts, then apply manual rubric checks to validate API and configuration accuracy.

Why does my documentation compliance check fail on terminology consistency?

Documentation compliance checks fail on terminology consistency when Markdown guides contain outdated API routes or naming that no longer match the actual repository state, requiring a lint_markdown scan to identify structural faults.

What's the best way to align API guides with current backend routes and dependencies?

The best way to align API guides with backend routes is to execute an automated codebase scan mapping, lint the Markdown for missing links, and compare claims against compliance rules.

Can I use markdown linting to find missing links and structural faults in technical docs?

Yes, you can use markdown linting to find missing links and structural faults by running the lint_markdown script, which identifies formatting issues before you proceed to compliance validation.

Do I need to manually check compliance rules after running an automated codebase scan?

Yes, you need to manually check compliance rules after running an automated codebase scan because the scripts identify structural faults, while manual rubric checks validate terminology and platform specifics accuracy.

When do I need to run a documentation audit for platform specifics and configurations?

You need to run a documentation audit for platform specifics and configurations right before releases to ensure public guides and integration notes faithfully describe current backend flags, routes, and dependencies.