lint

Audits Markdown and skill module files for frontmatter and link issues, outputting JSON reports.

1|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/bcbeidel/toolkit --skill lint-bcbeidel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lint
Source: https://github.com/bcbeidel/toolkit/tree/main/plugins/wiki/skills/lint
Command: npx skills add https://github.com/bcbeidel/toolkit --skill lint-bcbeidel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates repository content to surface frontmatter, link, and structural issues without modifying any files.

Core Features & Use Cases

  • Frontmatter validation: ensures required fields like name and description exist and are non-empty.
  • Reference and link checks: detects unreachable URLs and missing local references.
  • Guidance and mitigation: suggests corrective actions and integrates with optional resolver workflows.

Quick Start

Run python <plugin-scripts-dir>/lint.py --root . to perform a fast, offline audit of repository docs and skill modules.

Frequently Asked Questions about lint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit markdown content for broken links and missing frontmatter?

You can audit markdown content by running a read-only validation script that checks frontmatter fields, detects missing local references, and identifies broken links. It reports structural issues via structured JSON without modifying files.

What is markdown frontmatter validation and why do I need it?

Markdown frontmatter validation ensures required metadata fields like name and description exist and are non-empty. It surfaces misconfigurations in repository documents and skill modules so you can correct missing metadata before deployment.

How do I check URL reachability in repository documentation?

You can check URL reachability by running an audit with opt-in link validation enabled. The audit detects unreachable URLs in markdown documents and reports them in structured JSON format with suggested corrective actions.

Does the markdown lint audit modify my repository files?

No, the markdown lint audit is strictly read-only. It validates repository content to surface frontmatter, link, and structural issues without modifying any files, ensuring your source documents remain untouched during the audit process.

Can I use this lint audit for skill modules within a wiki build ecosystem?

Yes, the lint audit applies to both Markdown documents and skill modules within the wiki and build ecosystem. It surfaces misconfigurations, missing metadata, and broken links across these structures and reports findings via structured JSON.

What is the best way to perform a fast offline audit of repository docs?

The best way to perform a fast offline audit is running the validation script with the root directory specified. This quickly scans repository docs and skill modules for frontmatter, link, and structural issues without requiring network connectivity.