markdown-review

Scan plugin markdown files for hygiene, architecture, and A2A protocol issues.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/djwmobley/pipeline --skill markdown-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-review
Source: https://github.com/djwmobley/pipeline/tree/main/skills/markdown-review
Command: npx skills add https://github.com/djwmobley/pipeline --skill markdown-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdown documentation for pipelines often becomes inconsistent, hard to audit, and difficult to enforce structure; this skill provides automated health checks and fixes to keep plugin markdown clean and navigable.

Core Features & Use Cases

  • Scans plugin markdown for file hygiene, information architecture, and A2A protocol compliance.
  • Generates prioritized findings and automated fixes to maintain consistent, machine-friendly documentation.
  • Helps teams enforce inline-checklists and cross-file references to support reliable agent orchestration.

Quick Start

Invoke the Markdown Review to scan all plugin markdown files, classify findings across hygiene, architecture, and A2A gaps, and generate prioritized fixes.

Frequently Asked Questions about markdown-review

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

FAQPage Schema
How do I check markdown documentation health for A2A protocol compliance?

To check markdown documentation health for A2A protocol compliance, scan plugin repositories to analyze file hygiene, information architecture, and A2A requirements, generating prioritized findings and automated fixes.

What is the best way to enforce consistent structure across markdown pipeline files?

The best way to enforce consistent structure across markdown pipeline files is applying a tiered review process that classifies information architecture gaps and delivers automated fixes to maintain machine-friendly documentation.

How do I fix broken cross-file references in markdown documentation?

You fix broken cross-file references in markdown documentation by running automated reviews that enforce inline-checklists and cross-file references, outputting actionable findings to support reliable agent orchestration.

Can I automate markdown hygiene checks for agent orchestration pipelines?

Yes, you can automate markdown hygiene checks for agent orchestration pipelines by scanning plugin markdown files to ensure reliable context loading and instruction fidelity through automated health checks and fixes.

What markdown issues prevent reliable context loading in pipeline plugins?

Markdown issues that prevent reliable context loading include inconsistent file hygiene, poor information architecture, and missing A2A protocol requirements, which automated review identifies and fixes to maintain navigable documentation.