Updated 1w ago
by ncoevoet
claude-markdown-health-check
Audits the .claude/ ecosystem — skills, commands, hooks, agents, settings, plugins, memory — for dead references, weak triggers, token bloat, dormant skills, permission drift, hook reliability, memory hygiene, and context bloat. Evidence-grounds every judgment finding before reporting.
47 GitHub stars (47)
Steady at 47 stars — no new stars in the 16 days since Sep 30.
- 27 skills (27 skills found in its SKILL.md files)
- 5 forks (5 forks)
- 1w ago last update (Last updated 1w ago)
Install
Skills CLI
npx skills add ncoevoet/claude-markdown-health-check
Asks which skills and agents to install. Just one: npx skills add ncoevoet/claude-markdown-health-check --skill formatter — add -g for every project.
Claude Code
git clone https://github.com/ncoevoet/claude-markdown-health-checkcp -r "claude-markdown-health-check/tests/fixtures/ambiguous-trigger/dot-claude/skills/formatter" ~/.claude/skills/
Copies the formatter skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add ncoevoet/claude-markdown-health-check
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md — showing the first 27 of 46 files.
-
formatter
Formats and tidies source files across the project. Use when code needs cleanup, when formatting drifts from the house style, or whenever a file could read more neatly.
tests/fixtures/ambiguous-trigger/dot-claude/skills/formatter/SKILL.md on GitHub (opens in a new tab) -
a
Handles routine chores in the system. Use for Ticket updates across the team.
tests/fixtures/anchor-collision/dot-claude/skills/a/SKILL.md on GitHub (opens in a new tab) -
b
Coordinates various support duties for staff. Use for Ticket routing when things queue up.
tests/fixtures/anchor-collision/dot-claude/skills/b/SKILL.md on GitHub (opens in a new tab) -
one
Use for `mvn clean install, then deploy` invocations when the user asks about releases.
tests/fixtures/anchor-comma-token/dot-claude/skills/one/SKILL.md on GitHub (opens in a new tab) -
two
Use for `prettier` runs when the user asks about formatting.
tests/fixtures/anchor-comma-token/dot-claude/skills/two/SKILL.md on GitHub (opens in a new tab) -
wikitool
Confluence page operations for the team wiki.
tests/fixtures/anchor-initial-noun/dot-claude/skills/wikitool/SKILL.md on GitHub (opens in a new tab) -
bpmnaudit
Audits BPMN diagrams for schema drift. Use it for "check my .bpmn file", "validate BPMN", or any Camunda model review.
tests/fixtures/anchor-phrasing/dot-claude/skills/bpmnaudit/SKILL.md on GitHub (opens in a new tab) -
reviewer
Reviews changed code for correctness and style. Use when the user asks to review a diff before opening a merge request.
tests/fixtures/anchor-unanchorable/dot-claude/skills/reviewer/SKILL.md on GitHub (opens in a new tab) -
urlref
Handles reminders and syncs data with example.org for the team.
tests/fixtures/anchor-url-tld/dot-claude/skills/urlref/SKILL.md on GitHub (opens in a new tab) -
badmodel
Generates unit tests for changed functions. Use when the user asks to add tests or mentions coverage for newly written code.
tests/fixtures/bad-frontmatter/dot-claude/skills/badmodel/SKILL.md on GitHub (opens in a new tab) -
runner
Runs a long task and records its completion using a flag file in the project config dir.
tests/fixtures/chained-ref-artifact/dot-claude/skills/runner/SKILL.md on GitHub (opens in a new tab) -
extlink
Links build docs across the workspace. Use when the user asks about cross-project build references or shared setup.
tests/fixtures/chained-ref/dot-claude/skills/extlink/SKILL.md on GitHub (opens in a new tab) -
replayer
Replays recorded webhook payloads through the mapping layer and diffs the resulting billing events. Use when investigating a mis-billed tenant or verifying a mapping change.
tests/fixtures/claudemd-annotated-map/dot-claude/skills/replayer/SKILL.md on GitHub (opens in a new tab) -
demo
Syncs pricing tables between the catalogue and the billing system. Use when a price change must be propagated or a sync run has to be replayed.
tests/fixtures/claudemd-obvious/dot-claude/skills/demo/SKILL.md on GitHub (opens in a new tab) -
welltuned
Lints and formats TypeScript files on demand. Use when the user asks to lint, format, or check style in .ts or .tsx files, or mentions eslint or prettier.
tests/fixtures/clean/dot-claude/skills/welltuned/SKILL.md on GitHub (opens in a new tab) -
authoring
Explains how to organize a skill and shows optional reference files as inline examples.
tests/fixtures/dead-ref-illustrative/dot-claude/skills/authoring/SKILL.md on GitHub (opens in a new tab) -
brokenskill
Summarises changelog entries for a release. Use when preparing release notes or when the user mentions changelog or release summary.
tests/fixtures/dead-ref/dot-claude/skills/brokenskill/SKILL.md on GitHub (opens in a new tab) -
safety
Documents safe cleanup patterns and guards the team against dangerous shell operations.
tests/fixtures/destructive-context/dot-claude/skills/safety/SKILL.md on GitHub (opens in a new tab) -
leaky
Calls the billing API for invoice data. Use when the user asks about invoices, billing, or payment records.
tests/fixtures/embedded-secret/dot-claude/skills/leaky/SKILL.md on GitHub (opens in a new tab) -
flowskill
Runs the project test suite and reports failures using an inline flow-list of tools.
tests/fixtures/flowlist-tools/dot-claude/skills/flowskill/SKILL.md on GitHub (opens in a new tab) -
orphanlist
Fills date-range pickers in list filters. Use when the user asks to filter a table by period, set a from/to date, or mentions the range picker." - "filter by period" - "from/to date" - "range picker empty
tests/fixtures/frontmatter-orphaned-list/dot-claude/skills/orphanlist/SKILL.md on GitHub (opens in a new tab) -
notes
Creates, searches, and edits Markdown notes in the notes store. Use when the user asks to capture a note, find an existing note, or reorganize their notes collection.
tests/fixtures/grounded-claudemd/dot-claude/skills/notes/SKILL.md on GitHub (opens in a new tab) -
renderer
Renders invoice PDFs from the template set and compares them against golden files. Use when changing invoice layout, fonts, or the golden-file suite.
tests/fixtures/instruction-duplicated/dot-claude/skills/renderer/SKILL.md on GitHub (opens in a new tab) -
longref
Documents the deployment runbook in detail. Use when the user needs the full deploy runbook or mentions deployment steps.
tests/fixtures/missing-toc/dot-claude/skills/longref/SKILL.md on GitHub (opens in a new tab) -
tester
Generates unit tests for changed functions. Use when the user asks to add `pytest` tests or mentions coverage for newly written code.
tests/fixtures/model-available/dot-claude/skills/tester/SKILL.md on GitHub (opens in a new tab) -
deploy
Deploys the service to staging. Use when the user asks to deploy, ship, or release the application to an environment.
tests/fixtures/name-collision/dot-claude/skills/deploy/SKILL.md on GitHub (opens in a new tab) -
different-name
Formats SQL queries to a house style. Use when the user asks to format, prettify, or normalize SQL statements.
tests/fixtures/name-mismatch/dot-claude/skills/realname/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.