unified-docs

Enforce lifecycle, metadata, and dependency rules for project documentation.

Updated May 3, 2026
One-click install
npx skills add https://github.com/venhdev/skills --skill unified-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unified-docs
Source: https://github.com/venhdev/skills/tree/main/skills/unified-docs
Command: npx skills add https://github.com/venhdev/skills --skill unified-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Project documentation often becomes outdated, inconsistent, or non-compliant with team standards, leading to broken references, unclear current truth, and wasted time during audits or onboarding. This Skill eliminates those issues by enforcing strict metadata schemas, lifecycle rules, and dependency tracking for all common project doc types.

Core Features & Use Cases

  • 3-Layer Mode Routing: Efficiently loads only the rules needed for the current task, with modes for Read (check doc status), Create (build new compliant docs), Maintain (update existing docs and fix metadata), and Audit (run full health checks of the doc corpus).
  • Arg-Triggered Workflows: Skip mode selection with quick shortcuts like --audit-codebase for a full corpus audit or --create-plan to generate a structured implementation plan with gate conditions for a new feature.
  • Enforced Doc Type Rules: Built-in contracts for plans, specs, ADRs, how-to guides, explanations, and TIL notes ensure every doc follows the correct lifecycle, frontmatter schema, and cascade dependency rules.
  • Cascade Dependency Management: Automatically tracks depends-on and updates relationships between docs, flags broken links to archived or superseded content, and provides repair guidance to keep the doc graph accurate.

Quick Start

Use the unified-docs skill with the --audit-codebase argument to run a full health check of your project's documentation, or use --create-plan to generate a structured implementation plan for a new feature.

Frequently Asked Questions about unified-docs

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

FAQPage Schema
How do I audit project documentation for outdated and non-compliant files?

To audit project documentation for outdated files, run a full corpus health check that validates frontmatter schemas, identifies broken dependency links, and flags non-compliant doc types. This provides automated documentation health validation across the entire repository.

How do I enforce consistent frontmatter metadata schemas for specs and ADRs?

Enforcing consistent frontmatter metadata schemas for specs and ADRs requires applying built-in doc type contracts during creation and maintenance. The system validates required metadata fields against strict schemas to ensure every document follows team standards.

What is the best way to track cascade dependencies between how-to guides and explanations?

Tracking cascade dependencies between how-to guides and explanations involves mapping depends-on and updates relationships within the doc graph. The system automatically flags broken links to archived content and provides repair guidance to keep relationships accurate.

Can I generate a structured implementation plan with gate conditions for a new feature?

Yes, you can generate a structured implementation plan with gate conditions for a new feature using the plan creation workflow. This enforces correct lifecycle rules and frontmatter schemas from the start, ensuring the plan complies with project documentation standards.

Does documentation lifecycle management work for TIL notes and plan documents?

Documentation lifecycle management works for TIL notes and plan documents by applying enforced doc type rules. It ensures these specific document types follow correct lifecycles, maintain accurate frontmatter, and integrate properly into the cascade dependency graph.

Why do my documentation dependencies break when I archive or supersede old specs?

Documentation dependencies break when archiving or superseding old specs because downstream documents still reference the outdated content. The audit mode detects these broken links in the cascade dependency graph and provides repair guidance to update or remove the invalid references.