Agent skill

doc-dspec-fixer

Automated fix skill that reads review reports and applies fixes to DSPEC documents - handles broken links, content structure issues, and iterative improvement

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-fixer

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": [
        "REQ",
        "DSPEC",
        "Review Report"
    ],
    "downstream_artifacts": [
        "Fixed DSPEC",
        "Fix Report"
    ],
    "architecture_approaches": [
        "ai-agent-based"
    ]
}

SKILL.md

doc-dspec-fixer

Purpose

Automated fix skill that reads the latest review report and applies fixes to DSPEC (Documentation Specification) documents. Enables iterative improvement cycles between review and fix phases.

Layer: 9.51 (DSPEC Quality Improvement)

Upstream: REQ, DSPEC, Review Report

Downstream: Fixed DSPEC, Fix Report

Fixable Issue Types

Automatic Fixes

Issue Type Fix Action
Missing document_type Add document_type: dspec-document
Missing subtype_code Add subtype_code: 51
Broken internal links Update to correct paths
Missing traceability tags Add required cumulative tags
YAML syntax errors Fix formatting issues

Semi-Automatic Fixes

Issue Type Fix Action
Missing content outline sections Generate placeholders
Incomplete audience definition Add template sections

Manual Review Required

Issue Type Action
Content accuracy issues Requires subject matter expert
Audience mismatch Requires stakeholder input
Style guide violations May require editorial review

Output Files

File Purpose
Updated DSPEC YAML Fixed document
DSPEC-NN.F_fix_report_vNNN.md Fix report documenting changes

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