메뉴
Validate Markdown syntax, formatting, and links using markdownlint-cli2 and markdown-link-check. Use when committing docs changes, checking broken links, or validating Markdown in pull requests.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | markdown-validation |
| description | Validate Markdown syntax, formatting, and links using markdownlint-cli2 and markdown-link-check. Use when committing docs changes, checking broken links, or validating Markdown in pull requests. |
| license | Apache-2.0 |
| metadata | {"author":"y-miyazaki","version":"1.0.1"} |
.md extension (required)**/*.md)Return structured Markdown in accordance with references/common-output-format.md.
Structured validation results from two tools: markdownlint-cli2 → markdown-link-check.
Return ## Checks Summary, ## Checks (Failed/Deferred Only), and ## Issues.
scripts/validate.sh for comprehensive validation. Do not run individual commands.bash scripts/validate.sh (or bash scripts/validate.sh <path> for scoped validation).| Condition | Severity | Action |
|---|---|---|
scripts/validate.sh missing | Fatal | Stop; report missing script |
No .md files under target path | Info | Report no reviewable markdown; stop |
| markdownlint-cli2 or link-check tool missing | Recoverable | Defer checks for that tool; note in deferred table |
| External link timeout or transient network | Recoverable | Defer link-check item; note network-only failure |
| Single tool fails, other succeeds | Recoverable | Report passing tool; defer failed tool with exit status |
| All tools fail | Fatal | Return status: failed with per-tool stderr summaries |
common-checklist.md unavailable | Fatal | Stop; report missing dependency |
common-output-format.md unavailable | Recoverable | Use inline output contract |
Validate Markdown files and report only failed checks.bash scripts/validate.sh ./docs/Review SKILL.md quality for Waza readiness and agent-skills-instructions compliance. Use when evaluating SKILL.md quality, checking compliance with skill authoring standards, preparing skills for release, reviewing skill PRs, or running waza readiness checks.
Survey and update CHANGELOG.md from unreleased commits and undocumented releases (conventional, renovate, chore, pin/finalize subjects, and git tags). Use when the user asks to check, review, or update the changelog, or when automation supplies commit/release detect JSON. Default is survey only; edit CHANGELOG.md only when the user explicitly requests a fix or automation sets may_edit in Constraints.
Triage failing CI on integration branches and/or PR heads, classify failures, apply minimal fixes when actionable. Use when the user asks to triage or fix CI failures, when automation detects failed workflow runs, or when automation supplies detection JSON. Default is survey only; edit files only when the user explicitly requests a fix or automation sets may_edit in Constraints.
Detect documentation drift and patch affected docs — via git diff (hooks, manual) or structured detect JSON from an external caller. Keeps references, links, tables, and nav entries accurate. Use when syncing docs after code changes, before PRs, on doc sync requests, or when automation reports documentation drift. Default is survey only; edit documentation files only when the user explicitly requests a fix or caller constraints allow edits. Not for new document creation (use docs-creator) or markdown linting (use markdown-validation).
Review GitHub Actions workflows for correctness, security, and maintainability. Use when reviewing GitHub Actions workflow PRs, checking workflow security, evaluating CI/CD pipeline design, or assessing permissions and secret handling.
Validate GitHub Actions workflows for syntax and security with actionlint, ghalint, and zizmor. Use when committing workflow changes, running CI validation, or checking workflow security issues.