Agent skill

doc-dspec-reviewer

Comprehensive content review and quality assurance for DSPEC documents - validates documentation specification completeness, audience alignment, content coverage, and identifies issues requiring manual attention

View SKILL.md on GitHub Repository
Stars 10
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/doc-dspec-reviewer

Metadata

Additional technical details for this skill

tags
sdd-workflow layer-9-artifact dspec-artifact quality-assurance
custom fields 
{
    "layer": 9,
    "version": "1.0",
    "priority": "primary",
    "last_updated": "2026-03-01",
    "subtype_code": 51,
    "artifact_type": "DSPEC",
    "skill_category": "quality-assurance",
    "deliverable_type": "document",
    "development_status": "active",
    "upstream_artifacts": [
        "DSPEC"
    ],
    "downstream_artifacts": [],
    "architecture_approaches": [
        "ai-agent-based"
    ]
}

SKILL.md

doc-dspec-reviewer

Purpose

Comprehensive content review and quality assurance for Documentation Specification (DSPEC) documents. This skill performs deep content analysis beyond structural validation, checking content coverage, audience alignment, style compliance, and identifying issues that require manual review.

Layer: 9.51 (DSPEC Quality Assurance)

Upstream: DSPEC (from doc-dspec-autopilot)

Downstream: None (final QA gate before TASKS generation)

When to Use

Use doc-dspec-reviewer when:

  • After DSPEC Generation: Run immediately after doc-dspec-autopilot completes
  • Manual DSPEC Edits: After making manual changes to DSPEC
  • Pre-TASKS Check: Before running doc-tasks-autopilot
  • Periodic Review: Regular quality checks on existing DSPECs

Review Checklist

1. Content Coverage Review

  • All REQ topics addressed
  • Information architecture logical
  • Content depth appropriate for audience
  • Examples sufficient and relevant

2. Audience Alignment Review

  • Primary audience clearly defined
  • Technical level appropriate
  • Prerequisites realistic
  • Terminology appropriate for audience

3. Structure Review

  • Logical flow of topics
  • Section hierarchy appropriate
  • Navigation aids specified
  • Cross-references defined

4. Style Compliance Review

  • Style guide referenced
  • Voice and tone consistent
  • Formatting standards met
  • Terminology consistent

5. Accessibility Review

  • Visual content has alt text specs
  • Color contrast considered
  • Reading level appropriate
  • Multi-format considerations

6. Traceability Review

  • All cumulative tags present
  • REQ requirements mapped
  • Source references complete

Review Report Format

markdown
# DSPEC-NN Review Report

## Summary
- **Document**: DSPEC-NN_{slug}
- **Review Date**: YYYY-MM-DD
- **DOC-Ready Score**: NN%
- **Status**: PASS/FAIL

## Findings

### Critical Issues
1. [Issue description]

### Warnings
1. [Warning description]

### Recommendations
1. [Improvement suggestion]

## Metrics
| Metric | Value | Target |
|--------|-------|--------|
| Content Coverage | NN% | 100% |
| Audience Alignment | NN% | 90% |
| Style Compliance | NN% | 85% |

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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

vladm3105/aidoc-flow-framework

doc-spec-reviewer

Comprehensive content review and quality assurance for SPEC documents - validates YAML structure, REQ coverage, interface definitions, and identifies issues requiring manual attention

10 3
Explore
vladm3105/aidoc-flow-framework

doc-prd-fixer

Automated fix skill that reads review reports and applies fixes to PRD documents - handles broken links, element IDs, missing files, and iterative improvement

10 3
Explore
vladm3105/aidoc-flow-framework

doc-procspec-autopilot

Automated PROCSPEC (Process Specification) generation from REQ - generates specifications for SOPs, runbooks, playbooks, and operational procedures

10 3
Explore
vladm3105/aidoc-flow-framework

doc-riskspec-autopilot

Automated RISKSPEC (Risk Specification) generation from REQ - generates specifications for risk matrices, impact assessments, and mitigation plans

10 3
Explore
vladm3105/aidoc-flow-framework

doc-ptest-autopilot

Automated PTEST generation and review orchestration for performance category and threshold validation

10 3
Explore
vladm3105/aidoc-flow-framework

doc-adr-autopilot

Automated ADR generation pipeline from BRD Architecture Decision Requirements - analyzes topics, generates Context-Decision-Consequences records

10 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results