skills.rest
sd0xdev
sd0xdevCOMMUNITY
Explore all skills by this author →
𝕏@Develop0xGitHub

doc-review

Review Markdown documents for architecture, security, and documentation quality.

187|24|Updated Jan 30, 2026
Search Tags:#markdown#codex#document review#documentation quality#tech spec#review loop
One-click install
npx skills add https://github.com/sd0xdev/sd0x-dev-flow --skill doc-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-review
Source: https://github.com/sd0xdev/sd0x-dev-flow/tree/main/skills/doc-review
Command: npx skills add https://github.com/sd0xdev/sd0x-dev-flow --skill doc-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Document reviews are often manual, inconsistent, and time-consuming. This skill provides a Codex-assisted workflow to assess markdown documents (tech specs, design docs, API references) for clarity, accuracy, and completeness.

Core Features & Use Cases

  • Codex-assisted reviews for architecture, completeness, and accuracy of Markdown documents
  • Tech-spec verification and doc refactoring to improve clarity and consistency
  • Gate-based workflow with actionable recommendations and looped revisions
  • Use Case: Review a new tech spec with /codex-review-doc to identify must-fix items, then loop revisions using /codex-review-doc --continue <threadId> until mergeable
  • Commands: /codex-review-doc, /review-spec, /doc-refactor, /update-docs

Quick Start

Run /codex-review-doc to auto-detect Markdown docs requiring review, start the Codex MCP review flow, and follow the gate to final mergeable status.

Frequently Asked Questions about doc-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate markdown document reviews for tech specs?▼

You can automate markdown document reviews by running /codex-review-doc to auto-detect files, assess architecture and completeness, and enforce a gate-based loop for iterative revisions until the tech spec reaches mergeable status.

How does the Codex MCP review gate workflow work for design docs?▼

The Codex MCP review gate workflow applies structured evaluation to design docs, generates actionable recommendations for must-fix items, and allows looping revisions with /codex-review-doc --continue <threadId> until passing the merge gate.

Can I use this skill to check API references for accuracy and consistency?▼

Yes, this skill applies Codex-assisted reviews to API references and other markdown artifacts to verify accuracy, consistency, and completeness across your repositories using structured reference prompts.

What is the best way to refactor documentation for clarity?▼

The best way to refactor documentation for clarity is using the /doc-refactor command, which leverages Codex MCP to evaluate and improve markdown structure, consistency, and overall documentation quality.

Do I need Codex MCP integration to review architecture and security in markdown?▼

Yes, Codex MCP integration is required as the skill relies on it to enforce structured evaluation across architecture, security, and documentation quality dimensions during the markdown review process.

Related Skills

Explore More Content & Communication Skills→
tecnologia-ibtechtecnologia-ibtech

create-mcp

Automates scaffolding and configuration of MCP servers for Codex from OpenAPI specs.

Community
Advanced
pbuchmanpbuchman
8

nitpick-nuker

Automate GitHub PR review comment triage and fix actionable feedback until CI passes.

Community
Advanced
KameniAlexNeaKameniAlexNea

git-workflow

Stage and commit Git changes with descriptive messages.

Community
Basic
mindroom-aimindroom-ai
232

docs-review

Review project documentation for accuracy, completeness, and consistency with the codebase.

Official
Intermediate