repo-markdown-quality
A dedicated linting and formatting tool for keeping project Markdown documentation clean and consistent.
Install
mkdir -p .claude/skills/repo-markdown-quality && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/19308" && unzip -o skill.zip -d .claude/skills/repo-markdown-quality && rm skill.zipInstalls to .claude/skills/repo-markdown-quality
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.
______________________________________________________________________Key capabilities
- →Format repository Markdown files
- →Run linting checks on documentation
- →Repair Markdown quality failures
- →Maintain style consistency in documentation
How it works
It executes automated formatting and linting commands through a Python environment managed by poetry.
Inputs & outputs
When to use repo-markdown-quality
- →Format project documentation files
- →Run linting checks on Markdown
- →Repair documentation quality issues
About this skill
name: repo-markdown-quality description: "Use when you need to format and lint Markdown documentation for Auto-VHS-Deinterlacer."
Repo Markdown Quality Skill
Use this skill for Markdown linting and automatic delinting/formatting work.
When to Use
- Formatting repository Markdown files consistently.
- Running Markdown lint checks in local or CI workflows.
- Repairing Markdown quality failures before tests.
- Updating docs while preserving style consistency.
Standard Workflow
- Run Markdown auto-delint/format first.
- Run Markdown lint scan second.
- Re-run lint after fixing reported findings.
- Keep CI and local pipeline commands aligned.
Commands
.\.VENV\Scripts\python.exe -m poetry run mdformat ..\.VENV\Scripts\python.exe -m poetry run pymarkdown -d MD013,MD033,MD036 scan .
Constraints
- Do not suppress Markdown lint findings globally without explicit request.
- Keep documentation edits minimal and focused on formatting/compliance.
- Keep Markdown stages before test execution in quality pipelines.
When not to use it
- →Suppressing lint findings globally without explicit request
- →Editing documentation beyond formatting or compliance
Prerequisites
Limitations
- →Linting stages must occur before test execution
- →Edits must remain minimal and focused on compliance
How it compares
This approach automates the delinting and formatting process rather than relying on manual style checks.
Compared to similar skills
repo-markdown-quality side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| repo-markdown-quality (this skill) | 0 | 13d | No flags | Beginner |
| doc | 0 | 2mo | Review | Intermediate |
| richpdf | 0 | 2mo | Review | Intermediate |
| feature-doc-updates | 0 | 1mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by ventura8
View all by ventura8 →You might also like
doc
ansys
Write, review, or edit PyMechanical documentation. Use when writing reStructuredText (RST) files, Python docstrings, Sphinx configurations, example scripts, README files, or any doc content for the PyMechanical library. This covers NumPy docstrings, RST file formatting, Google developer style guide
richpdf
0r1xByte
>
feature-doc-updates
liudger
Ensure README and documentation are updated when adding features in python-bsblan. Use when implementing new behavior, parameters, API surface changes, or user-visible capabilities.
pdf-creator
seaworld008
Create PDF documents from markdown with proper Chinese font support using weasyprint. This skill should be used when converting markdown to PDF, generating formal documents (legal, trademark filings, reports), or when Chinese typography is required. Triggers include "convert to PDF", "generate PDF",
zensical
the78mole
> **Scope**: Gives GitHub Copilot precise knowledge of the Zensical documentation setup in > this repository so it can make correct edits to `zensical.toml`, add pages, adjust navigation, > and help with theming without ever reverting to the legacy MkDocs workflow.
document-pro
bighardperson
文档处理技能 - 让 AI 能够读取、解析、提取 PDF、DOCX、PPT 等文档的关键信息。当用户要求分析文档、提取内容、总结报告时触发此技能。