context-maintenance

Audits consistency of SPEC, API, CONTEXT, RULES, CHANGELOG across modules.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/DeathKnightH/context-skills --skill context-maintenance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-maintenance
Source: https://github.com/DeathKnightH/context-skills/tree/main/skills/context-maintenance
Command: npx skills add https://github.com/DeathKnightH/context-skills --skill context-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill performs a full audit of the five-piece documentation set (SPEC.md, API.md, CONTEXT.md, RULES.md, CHANGELOG.md) to ensure consistency across modules, surfacing drift after refactors and guiding bulk remediation.

Core Features & Use Cases

  • Layered checks: existence (L1), structure consistency (L2), and changelog/version validation (L3) to enforce the documentation contract.
  • Scope-flexible audits: start from any subdirectory, enabling targeted or project-wide doc health checks in CI/CD pipelines or onboarding workflows.
  • Automation-assisted remediation: generates actionable insights to repair missing files, broken links, and outdated entries across the five-piece docs.

Quick Start

Run the context-maintenance skill against a project folder to perform a full documentation audit.

Frequently Asked Questions about context-maintenance

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

FAQPage Schema
How do I audit project documentation for inconsistencies after a large refactor?

To audit project documentation for inconsistencies after a large refactor, run a full check across your SPEC.md, API.md, CONTEXT.md, RULES.md, and CHANGELOG.md files. The audit enforces a layered contract by performing existence, structure, and changelog checks to surface drift.

What is the best way to check if missing documentation files are breaking my CI/CD pipeline?

Checking for missing documentation files in your CI/CD pipeline involves verifying the existence and structure of your project's docset. You can run scope-flexible audits from any subdirectory to perform health checks and generate actionable insights for repairing missing files.

How do I validate changelog and version consistency across multiple project modules?

Validating changelog and version consistency across multiple project modules requires applying layered checks to your documentation set. The audit performs changelog and version validation to enforce the documentation contract and reports findings for bulk remediation.

Can I run a documentation consistency check from a specific subdirectory rather than the whole project?

Yes, you can run a documentation consistency check from a specific subdirectory rather than the whole project. Scope-flexible audits allow you to start from any subdirectory, enabling targeted doc health checks for multi-module projects and new-team onboarding workflows.

What documentation structure do I need before running an automated doc audit?

Before running an automated doc audit, you need a five-piece documentation structure consisting of SPEC.md, API.md, CONTEXT.md, RULES.md, and CHANGELOG.md. The audit checks this layered contract to identify missing files, broken links, and outdated entries.

Why does my project documentation drift during refactoring and how do I fix it?

Project documentation drifts during refactoring when code changes are not reflected in the docset. To fix it, an audit performs existence, structure, and changelog checks across SPEC, API, CONTEXT, RULES, and CHANGELOG files, generating actionable insights to guide bulk remediation.