moai-workflow-docs

name	moai-workflow-docs
description	Enhanced documentation unified validation (2 UV scripts migrated to builder-skill-uvscript, 3 workflow scripts retained)
version	2.0.0
modularized	true
scripts_enabled	true
scripts_migration	{"date":"2025-11-30T00:00:00.000Z","migrated_count":2,"migrated_location":"builder-skill-uvscript","reason":"UV script consolidation with unified builder-skill_ prefix","remaining_scripts":3}
last_updated	"2025-11-30T00:00:00.000Z"
compliance_score	61
auto_trigger_keywords	["docs","workflow"]
scripts	[{"name":"extract_mermaid_details.py","purpose":"Mermaid diagram detail extraction and rendering test guide generation","type":"python","command":"uv run .claude/skills/moai-workflow-docs/scripts/extract_mermaid_details.py","zero_context":false,"version":"1.0.0","last_updated":"2025-11-30T00:00:00.000Z"},{"name":"generate_final_comprehensive_report.py","purpose":"Phase 4: Generate final comprehensive validation report","type":"python","command":"uv run .claude/skills/moai-workflow-docs/scripts/generate_final_comprehensive_report.py","zero_context":false,"version":"1.0.0","last_updated":"2025-11-30T00:00:00.000Z"},{"name":"validate_korean_typography.py","purpose":"Korean-specific validation script (Phase 3)","type":"python","command":"uv run .claude/skills/moai-workflow-docs/scripts/validate_korean_typography.py","zero_context":false,"version":"1.0.0","last_updated":"2025-11-30T00:00:00.000Z"}]
color	red

⚠️ Partial UV Script Migration Notice

2 of 5 UV CLI scripts have been consolidated into the builder-skill-uvscript skill on 2025-11-30.

Migrated scripts:

• builder-skill_lint_docs.py (previously lint_korean_docs.py)
• builder-skill_validate_diagrams.py (previously validate_mermaid_diagrams.py)
• Find migrated scripts in: .claude/skills/builder-skill-uvscript/scripts/

Remaining scripts (3 workflow-specific scripts retained in this skill):

• extract_mermaid_details.py
• generate_final_comprehensive_report.py
• validate_korean_typography.py

Usage:

• Migrated: uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_lint_docs.py
• Retained: uv run .claude/skills/moai-workflow-docs/scripts/extract_mermaid_details.py

Quick Reference (30 seconds)

Purpose: Comprehensive documentation validation framework with 5 specialized phases.

Core Phases:

1. Markdown Linting - Syntax, structure, links validation
2. Mermaid Diagrams - Diagram syntax and type checking
3. Mermaid Details - Code extraction and rendering guide
4. Korean Typography - UTF-8, spacing, encoding validation
5. Report Generation - Aggregated quality report

Key Benefits:

• Catch errors before publication
• Multi-language support (Korean, English, Japanese, Chinese)
• Diagram syntax validation
• Typography consistency
• Actionable recommendations

Available Scripts: 5 validation and reporting scripts

Usage Pattern:

1. Load skill: Skill("moai-workflow-docs")
2. Check SKILL.md for "When to use"
3. Execute script with --help flag
4. Run script with options
5. Only read source if --help insufficient

: Don't read script source code unless necessary. All scripts are self-documenting via flag.