← Back to Skills Marketplace
Markdown Linter
by
WANGJUNJIE
· GitHub ↗
· v1.0.0
848
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install markdown-linter
Description
Validates Markdown files in the workspace for broken local links, missing file references, and basic syntax issues. Use to maintain documentation integrity a...
Usage Guidance
This linter appears to do what it says: it walks the workspace, reads Markdown files, and checks whether linked files exist. It does not transmit data or require credentials. Two practical cautions before using it on sensitive workspaces: (1) if Markdown files contain links that point to absolute paths (starting with '/'), the linter will check those absolute system paths and will report whether they exist — avoid scanning untrusted content that could intentionally probe your filesystem; (2) as with any code-runner, review the included files yourself and run the test in an isolated/sandbox environment first. If you need to prevent absolute-path checks, run the linter with a controlled rootDir or modify the code to explicitly treat leading '/' as relative to the project root only.
Capability Analysis
Type: OpenClaw Skill
Name: markdown-linter
Version: 1.0.0
The skill is classified as suspicious due to its use of file system access (`fs.readdirSync`, `fs.statSync`, `fs.readFileSync`, `fs.existsSync`) in `index.js`. While this file access is plausibly needed for the skill's stated purpose of validating Markdown files, the instructions classify such capabilities without clear malicious intent as 'suspicious'. There is no evidence of intentional harmful behavior like data exfiltration, persistence, or prompt injection attempts in SKILL.md, but the broad file reading capability presents a potential vector for misuse if the agent is prompted to scan sensitive directories.
Capability Assessment
Purpose & Capability
Name/description (Markdown linter) aligns with what the package does: recursively find .md files, check local link targets, header/code-block heuristics. The included test script exercises the linter in a small temporary directory which is consistent with the declared purpose.
Instruction Scope
The runtime instructions and index.js stay within scope (reading workspace files, validating links). One noteworthy behavior: links starting with '/' are handled via path.join(rootDir, linkUrl) in code comments, but because path.join will treat an absolute linkUrl as an absolute path, the linter will end up checking absolute system paths (e.g., '/etc/passwd') if such links appear in scanned Markdown. The linter does not send data externally or access environment variables.
Install Mechanism
No install spec is provided (instruction-only), and there are no declared dependencies. This lowers risk: nothing is downloaded or written during installation beyond normal use of the included JS files.
Credentials
The skill requests no environment variables, no credentials, and no config paths. The code only uses fs/path APIs and does not reference process.env or other secrets.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system configuration, and requires no persistent privileges. It runs on-demand and can be invoked by the agent as normal.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install markdown-linter - After installation, invoke the skill by name or use
/markdown-linter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of markdown-linter.
- Validates Markdown files for broken local links and missing file references.
- Checks header hierarchy consistency.
- Ensures code blocks use language identifiers where needed.
- Produces detailed JSON output of issues found.
Metadata
Frequently Asked Questions
What is Markdown Linter?
Validates Markdown files in the workspace for broken local links, missing file references, and basic syntax issues. Use to maintain documentation integrity a... It is an AI Agent Skill for Claude Code / OpenClaw, with 848 downloads so far.
How do I install Markdown Linter?
Run "/install markdown-linter" 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 (open-source). 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 WANGJUNJIE (@wanng-ide); the current version is v1.0.0.
More Skills