assess-docs

Validate project documentation against artifact norms and generate a prioritized gap report.

7|3|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/nesnilnehc/ai-cortex --skill assess-docs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: assess-docs
Source: https://github.com/nesnilnehc/ai-cortex/tree/main/skills/assess-docs
Command: npx skills add https://github.com/nesnilnehc/ai-cortex --skill assess-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automatically validates project documentation against artifact norms and front-matter readiness, surfacing gaps and guiding minimal-fill actions.

Core Features & Use Cases

  • Compliance scanning: validate docs in docs/ against artifact norms.
  • Layer readiness: score each layer (requirements, architecture, milestones, roadmap, backlog) for readiness.
  • Gap reporting: produce a prioritized gap list and minimal fill plan.

Quick Start

Run a full docs health check and generate the doc-assessment artifact at docs/calibration/doc-assessment.md.

Frequently Asked Questions about assess-docs

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

FAQPage Schema
How do I assess project documentation health and readiness?▼

Run a full docs health check to validate artifact norms and front-matter readiness across required layers. It generates a living doc-assessment artifact at docs/calibration/doc-assessment.md containing a prioritized gap report and minimal-fill plan.

What is documentation compliance scanning for layered artifacts?▼

Compliance scanning validates docs in docs/ against artifact norms. It scores layer readiness for requirements, architecture, milestones, roadmap, and backlog, then produces a prioritized gap list and minimal fill plan.

Can I generate a gap report for missing requirements and architecture docs?▼

Yes, generating a gap report validates required documentation layers like requirements and architecture. It outputs a prioritized gap list and minimal-fill plan to guide missing doc creation.

Does documentation readiness scoring work without external dependencies?▼

Yes, documentation readiness scoring works without external dependencies. It automatically analyzes project docs against artifact norms and front-matter rules to produce a gap report.

What is the best way to validate front-matter readiness in project docs?▼

The best way to validate front-matter readiness is running an automated docs health check. It scans project documentation against artifact norms and outputs a prioritized gap report with a minimal-fill plan.

When do I need a minimal-fill plan for documentation gaps?▼

You need a minimal-fill plan after running a docs health check that identifies missing or non-compliant artifacts. It provides prioritized actions to fill documentation gaps across required layers efficiently.