markdown_expert
Provides structural analysis and formatting guidelines for Markdown documents.
Install
mkdir -p .claude/skills/markdown-expert && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15783" && unzip -o skill.zip -d .claude/skills/markdown-expert && rm skill.zipInstalls to .claude/skills/markdown-expert
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Expertise in Markdown structure, AST analysis, and common formatting patterns.Key capabilities
- →Analyze Markdown document structure
- →Refactor Markdown content for readability
- →Generate Markdown content with consistent formatting
- →Validate header hierarchy in Markdown
- →Ensure consistent list marker styles
- →Validate link syntax and reference-style links
How it works
The skill applies domain knowledge of Markdown structure, Abstract Syntax Trees (AST), and formatting rules to analyze, refactor, or generate Markdown content. It focuses on readability, structural consistency, and adherence to best practices.
Inputs & outputs
When to use markdown_expert
- →Refactoring markdown docs
- →Validating header hierarchy
- →Cleaning up markdown structure
About this skill
Markdown Expert Skill
Use this skill when analyzing, refactoring, or generating Markdown content.
Domain Knowledge
- Structure: Markdown consists of Blocks (Headers, Paragraphs, Lists) and Inline elements (Links, Emphasis, Code).
- AST: Common parsers like
remarkormarkdown-itrepresent Markdown as a tree. - Rules:
- Ensure headers follow a logical hierarchy (no skipping levels).
- Use consistent list marker styles (
-or*). - Validate link syntax and reference-style links.
Task Guidance
- When asked to analyze a document, focus on:
- Reading difficulty.
- Structural consistency.
- Potential for refactoring (e.g., long sections into sub-headers).
- When implementing "Clean Architecture" for Markdown, keep the Domain entities (e.g.,
MarkdownDocument,MarkdownSection) pure and agnostic of any specific parser if possible.
When not to use it
- →When the content is not in Markdown format
- →When the task does not involve structural analysis or formatting of Markdown
Limitations
- →Focuses on Markdown structure, AST analysis, and common formatting patterns
- →Requires headers to follow a logical hierarchy
- →Requires consistent list marker styles
How it compares
This skill applies architectural principles and AST analysis to Markdown, ensuring maintainability and consistency, which is more rigorous than manual formatting or basic linting.
Compared to similar skills
markdown_expert side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| markdown_expert (this skill) | 0 | 6mo | No flags | Intermediate |
| ml-paper-writing | 48 | 6mo | Review | Advanced |
| docs-review | 10 | 8mo | No flags | Beginner |
| claude-md-improver | 21 | 7mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
ml-paper-writing
davila7
Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verification workflows.
docs-review
metabase
Review documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation markdown files.
claude-md-improver
anthropics
Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".
write-docs
tldraw
Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.
update-docs
vercel
This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature", "document this feature", "review docs completeness", "add docs for this change", "what documentation is affected", "docs impact", or mentions "docs/", "docs/01-app", "docs/02-pages", "MDX", "documentation update", "API reference", ".mdx files". Provides guided workflow for updating Next.js documentation based on code changes.
wiki-architect
microsoft
Analyzes code repositories and generates hierarchical documentation structures with onboarding guides. Use when the user wants to create a wiki, generate documentation, map a codebase structure, or understand a project's architecture at a high level.