Agent Skills: doc-dspec-audit

Unified DSPEC quality gate - validates structure, detects issues, computes DOC-Ready score, and produces report for fixer

UncategorizedID: vladm3105/aidoc-flow-framework/doc-dspec-audit

Install this agent skill to your local

pnpm dlx add-skill https://github.com/vladm3105/aidoc-flow-framework/tree/HEAD/.claude/skills/doc-dspec-audit

Skill Files

Browse the full folder contents for doc-dspec-audit.

Download Skill

Loading file tree…

.claude/skills/doc-dspec-audit/SKILL.md

Skill Metadata

Name
doc-dspec-audit
Description
Unified DSPEC quality gate - validates structure, detects issues, computes DOC-Ready score, and produces report for fixer

doc-dspec-audit

Purpose

Unified DSPEC quality gate that combines structural validation, content review, and DOC-Ready scoring into a single comprehensive audit.

Layer: 9.51 (DSPEC Quality Gate)


DOC-Ready Score Calculation

| Component | Weight | Scoring Criteria | |-----------|--------|------------------| | Content Coverage | 25% | All REQ topics addressed | | Audience Alignment | 20% | Audience analysis complete | | Structure Completeness | 20% | Content outline complete | | Style Compliance | 15% | Style guide referenced | | Accessibility | 10% | Accessibility requirements met | | Traceability | 10% | All cumulative tags present |

Thresholds:

  • PASS: ≥85%
  • CONDITIONAL: 75-84%
  • FAIL: <75%

Output Files

| File | Purpose | |------|---------| | DSPEC-NN.A_audit_report_vNNN.md | Comprehensive audit report |


References

  • Template: ai_dev_ssd_flow/09_SPEC/DSPEC/DSPEC-MVP-TEMPLATE.yaml
  • Schema: ai_dev_ssd_flow/09_SPEC/DSPEC/DSPEC_MVP_SCHEMA.yaml