Use case / SBPA-002

Analyze Markdown documentation quality

User Problem

A user has generic Markdown docs that are hard to scan and wants a reviewable quality checklist.

Proof Claim Boundary

Operator dogfooding and product capability evidence only; no natural demand, GEO success, AI citation, AI recommendation, traffic, lead, revenue, or conversion claim.

Manual install only: yes. Hosted execution: false.

Sanitized Prompt

I want Codex to review sample Markdown docs and return a prioritized checklist of weak sections and rewrite suggestions.

When To Use

A user has generic Markdown docs that are hard to scan and wants a reviewable quality checklist.
Use this workflow when the expected output is documentation quality audit; weak sections; rewrite plan.

When Not To Use

Do not use this workflow to bypass the stated safety boundary: L1 local analysis. No automatic rewrite, docs publication, or account access.
Do not treat the tested workflow as evidence of natural demand, AI citation, AI recommendation, traffic, lead, or conversion improvement.

Matched Solution

Analyze Markdown documentation quality is the canonical solution route for this scenario.

MCP Workflow

search_solutions -> get_solution_detail -> recommend_solution_skills -> get_solution_install_plan

Endpoint: https://mcp.getskillary.com/mcp
Manual install only: Yes
Hosted execution: No

Recommended Skill Bundle

primary skill

Markdown Link Validator

markdown-link-validator

Skill detail Download skill

supporting skill

Markdown Authoring Helper

markdown-authoring-helper

Skill detail

supporting skill

Codebase Analysis Probe

codebase-analysis-probe

Skill detail

How Codex Explains And Executes The Plan

Confirm docs folder, target audience, and known concerns; audit structure, references, clarity, and actionability; identify weak sections; propose rewrite guidance.

What You Need To Confirm

Confirm the sanitized task inputs, expected output, and scope before Codex starts.
Confirm whether Codex should return a plan only or may make reviewed local changes.
Approve any manual package download, local file change, command execution, account action, or deployment separately.
Review the verification checklist and stop if the result crosses the stated risk boundary.

Expected Output

Documentation quality audit; weak sections; rewrite plan.

Verification Checklist

Weak sections are concrete and prioritized.
Reference issues are separated from style issues.
No private docs, credentials, publication, hosted execution, or private console action.

Risk Boundary

L1 local analysis. No automatic rewrite, docs publication, or account access.

manual_install_only: true
hosted_execution: false

What Was Not Done

No docs were published, no private docs were included, no file edit was implied, and no production system changed.

Readiness By GEO Stage

crawl: future crawlable use-case page; SEO supporting diagnostics only
index: future indexable V1 page and internal links; SEO supporting diagnostics only
understand: explains documentation quality checklist capability
retrieve: covers Markdown docs quality natural-language demand
cite: adds citable target URL, skill URLs, MCP workflow URL, and claim boundary
click: provides next-step CTAs
convert: CTA readiness only; no conversion evidence

Next Actions

Operator dogfooding and product capability evidence only; no natural demand, GEO success, AI citation, AI recommendation, traffic, lead, revenue, or conversion claim.

View solution View primary skill Install guide MCP usage guide Inquiry

Tracking readiness only; no click or conversion evidence is generated by this local gate.