format-markdown-mkdocs

PassAudited by ClawScan on May 1, 2026.

Overview

The skill is a coherent local markdown formatter; users should notice that it runs bundled Node code, writes extra local files, and can edit the original file if that mode is chosen.

This looks safe for ordinary markdown formatting. Before installing, be aware that it may run a bundled Node formatter, create analysis/formatted/backup files, and can directly edit the original file if you choose structural-fixes-only mode.

Findings (3)

Artifact-based informational review of SKILL.md, metadata, install specs, static scan signals, and capability signals. ClawScan does not execute the skill or run runtime probes.

What this means

If the in-place mode is selected, the original markdown file may be changed directly.

Why it was flagged

The skill clearly discloses an option that changes the original file rather than writing only a separate formatted copy.

Skill content
Structural fixes only - Run the structural compatibility script on the original file in-place - No copy created; modifies the original file directly
Recommendation

Use the formatted-copy option or keep version-control/backups when working on important files.

What this means

Users may not realize that using the skill can involve trusting and running bundled Node-based formatter code.

Why it was flagged

The registry presentation is under-declared because the skill ships runnable local code and package files despite being described as instruction-only.

Skill content
No install spec — this is an instruction-only skill. Code file presence: 1 code file(s): scripts/format-structure.mjs
Recommendation

Review the bundled script and dependency files before installation, especially because the source and homepage are not provided.

What this means

Sensitive information from a source document could be duplicated into an additional local analysis file.

Why it was flagged

The workflow creates a persistent local analysis file containing summaries, highlights, formatting issues, and other derived information from the source document.

Skill content
Save analysis to file: `{original-filename}-analysis.md`
Recommendation

Avoid using the skill on sensitive documents unless you are comfortable with local sidecar analysis files being created, and delete those files when no longer needed.