Skip to content

markdownlint follow-ups: sweep MD060 table style + extend lint:md to skills/ and root docs #266

Description

@IgorShevchik

Follow-ups carved out of the #214 / #265 markdownlint sweep. Both deferred deliberately; neither blocked #214.

1. Sweep MD060 (table-column-style) and enable it

The #214 sweep left MD060 off: it fired 110 times across the tables in report.md and maintenance.md. The cells contain emoji (✅ / ⛔) — double-width characters that leave the | pipe columns visually unaligned, which markdownlint 0.40.0 flags as mixed-style. That's a cosmetic table reflow, out of scope for the whitespace-only sweep.

It's mechanical — pnpm run lint:md-fix (added in #265) handles MD060 automatically. A dedicated PR can run the reflow over the two files and flip MD060 to true (remove it from the .markdownlint.json off-by-choice list + update the $comment). Good first issue.

2. Extend lint:md beyond AGENTS.md + .github/contributing/

lint:md currently lints only AGENTS.md and .github/contributing/**/*.md. Other human-written Markdown has no lint guard:

  • skills/**/*.md — the contributor-facing SKILL.md files (several hundred lines each).
  • root README.md, CLAUDE.md, RELEASING.md.

As the lint baseline tightens, the unlinted surface grows relatively. Evaluate extending the glob — these files will likely need their own pnpm run lint:md-fix sweep + triage first (they may trip rules currently clean in the guide files).


Context: #214 (closed by #265), #54 (the markdownlint baseline).

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions