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.