Agent skill

doc-uxspec-fixer

Automated fix skill that reads review reports and applies fixes to UXSPEC documents - handles 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-uxspec-fixer

Metadata

Additional technical details for this skill

tags
sdd-workflow layer-9-artifact uxspec-artifact quality-assurance
custom fields 
{
    "layer": 9,
    "version": "1.0",
    "priority": "primary",
    "last_updated": "2026-03-01",
    "subtype_code": 52,
    "artifact_type": "UXSPEC",
    "skill_category": "quality-assurance",
    "deliverable_type": "ux",
    "development_status": "active",
    "upstream_artifacts": [
        "REQ",
        "UXSPEC",
        "Review Report"
    ],
    "downstream_artifacts": [
        "Fixed UXSPEC",
        "Fix Report"
    ],
    "architecture_approaches": [
        "ai-agent-based"
    ]
}

SKILL.md

doc-uxspec-fixer

Purpose

Automated fix skill that reads the latest review report and applies fixes to UXSPEC (UX Specification) documents.

Layer: 9.52 (UXSPEC Quality Improvement)

Fixable Issue Types

Automatic Fixes

  • Missing document_type → Add document_type: uxspec-document
  • Missing subtype_code → Add subtype_code: 52
  • Broken internal links → Update to correct paths
  • Missing traceability tags → Add required cumulative tags

Manual Review Required

  • Visual design decisions
  • Interaction pattern choices
  • Accessibility violations

Output Files

File Purpose
Updated UXSPEC YAML Fixed document
UXSPEC-NN.F_fix_report_vNNN.md Fix report

References

  • Template: ai_dev_ssd_flow/09_SPEC/UXSPEC/UXSPEC-MVP-TEMPLATE.yaml
  • Schema: ai_dev_ssd_flow/09_SPEC/UXSPEC/UXSPEC_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