1---2name: teabranch-open-responses-server-open-responses-server3description: Markdownlint Skill4---56# Markdownlint Skill78Lint all documentation markdown files and optionally auto-fix issues.910## Quick Usage1112### Check all docs1314```bash15bash .claude/skills/markdownlint/scripts/lint-docs.sh16```1718### Auto-fix fixable issues1920```bash21bash .claude/skills/markdownlint/scripts/lint-docs.sh --fix22```2324### Check specific files2526```bash27bash .claude/skills/markdownlint/scripts/lint-docs.sh docs/events-and-tool-handling.md28```2930## What Gets Linted3132By default the script lints:3334- `docs/*.md` — top-level documentation35- `index.md` — Jekyll home page36- `CLAUDE.md` — repo guidance37- `.claude/skills/**/*.md` — skill definitions3839Excluded by default:4041- `docs/plan/` — historical planning archives42- `docs/prompts/` — prompt templates43- `docs/pip-publish-instructions.md` — legacy doc44- `docs/using-uv.md` — legacy doc4546## Configuration4748The script uses whichever config is found first:49501. Project-level `.markdownlint-cli2.yaml` (in repo root)512. Global `~/.markdownlint-cli2.yaml`523. markdownlint built-in defaults5354The global config disables:5556- **MD013** (line length) — too noisy for content-heavy docs and tables57- **MD060** (table pipe spacing) — stylistic preference5859## Workflow6061After editing any `.md` file:62631. Run `bash .claude/skills/markdownlint/scripts/lint-docs.sh`642. If issues found, run with `--fix` to auto-fix what can be fixed653. Manually fix remaining issues664. Re-run to verify clean6768## Common Rules6970| Rule | What It Checks |71| --- | --- |72| MD001 | Heading levels increment by one |73| MD004 | Consistent unordered list style (dashes) |74| MD009 | No trailing spaces |75| MD022 | Blank lines around headings |76| MD025 | Single H1 per document (use front matter title) |77| MD031 | Blank lines around fenced code blocks |78| MD032 | Blank lines around lists |79| MD040 | Fenced code blocks should have a language |80| MD047 | Files end with a single newline |8182---83> Source: [teabranch/open-responses-server](https://github.com/teabranch/open-responses-server) — distributed by [TomeVault](https://tomevault.io).84<!-- tomevault:4.0:skill_md:2026-06-28 -->
Run npx skillmds@latest add tomevault-io/teabranch-open-responses-server-open-responses-server in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Markdownlint Skill It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.