← Back to Skills Marketplace
derick001

Markdown Linter

by Derick · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
308
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install markdown-linter-cli
Description
Lint Markdown files for formatting issues, broken links, and style consistency.
Usage Guidance
This linter appears to do what it says: it reads Markdown files you point it at and optionally makes HTTP requests to check external links. Before installing or running it, consider: (1) Don’t run it with broad globs ("**/*.md") on untrusted repositories if you’re worried about scanning many files you didn’t intend to expose. (2) Avoid enabling --check-external-links on untrusted input because the tool will make outbound requests to URLs found in the documents (this could be abused to probe internal services or contact attacker-controlled endpoints). (3) Review the full scripts/main.py (the provided snippet was truncated) yourself if you want higher assurance that there are no hidden network endpoints or suspicious behavior. If you need to be extra cautious, run the linter in a sandboxed environment or inspect/execute it locally rather than allowing autonomous agent invocation.
Capability Analysis
Type: OpenClaw Skill Name: markdown-linter-cli Version: 1.0.0 The skill is a standard Markdown linter that performs static analysis on files to identify formatting and style issues (MD001-MD010). The core logic in `scripts/main.py` uses regular expressions to check for header hierarchy, broken internal links, and line length, while the `requests` library is used strictly for validating the reachability of external URLs found within the documents. There is no evidence of data exfiltration, malicious execution, or prompt injection attempts in the documentation or code.
Capability Assessment
Purpose & Capability
Name/description match the provided artifacts. The SKILL.md declares python3 and Python packages (markdown, requests) which are appropriate for a Markdown linter that optionally checks external links. The included script implements linting rules that align with the claimed features.
Instruction Scope
Runtime instructions tell the agent to run scripts/main.py against one or more Markdown files (glob patterns supported). That necessarily reads the target files (expected), and — if --check-external-links is set — performs HTTP requests to URLs found in the documents. Be aware that running with wide globs (e.g., "**/*.md") will cause the tool to open many files in the workspace and enabling external-link checking will make outbound HTTP requests to whichever URLs appear in those files.
Install Mechanism
No install spec is provided (instruction-only install); the skill ships a Python script and expects runtime dependencies to be available. Nothing is downloaded from third-party URLs during install.
Credentials
The skill does not request environment variables, credentials, or config paths. The only potentially sensitive operation is optional network access (requests) when external link checking is enabled; no secrets are required.
Persistence & Privilege
always is false and the skill does not request persistent/system-wide privileges. There is no indication it modifies other skills or global agent config.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install markdown-linter-cli
  3. After installation, invoke the skill by name or use /markdown-linter-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of markdown-linter-cli. - Lints Markdown files for formatting issues, style consistency, and broken/bad links - Supports header hierarchy, image alt text, internal/external link validation, line length, trailing whitespace, and more - Provides configurable CLI options for input files, max line length, rule ignoring, and external link checking - Outputs detailed linting results and summaries in JSON format - Includes rule reference for all checks performed
Metadata
Slug markdown-linter-cli
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Markdown Linter?

Lint Markdown files for formatting issues, broken links, and style consistency. It is an AI Agent Skill for Claude Code / OpenClaw, with 308 downloads so far.

How do I install Markdown Linter?

Run "/install markdown-linter-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Markdown Linter free?

Yes, Markdown Linter is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Markdown Linter support?

Markdown Linter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Markdown Linter?

It is built and maintained by Derick (@derick001); the current version is v1.0.0.

💬 Comments