| name | mdsmith-fix |
| description | Run `mdsmith fix` on Markdown files in the current workspace. Auto-fixes whitespace, headings, code fences, bare URLs, list indentation, table alignment, and generated sections (catalog, include, toc, build) in place, looping until edits stabilize. Trigger when the user asks to "fix my markdown", "run mdsmith fix", "clean up lint", or "regenerate sections". |
| user-invocable | true |
| argument-hint | [path | .] |
| allowed-tools | Bash(mdsmith:*), Bash(git rev-parse:*), Bash(go run ./cmd/mdsmith:*) |
mdsmith fix
Run mdsmith fix on the argument, defaulting
to . (entire workspace) when no argument is
given.
Steps
-
Locate the workspace root:
git rev-parse --show-toplevel
Run every subsequent command from that path.
Without git, use the current directory.
-
Detect the mdsmith CLI. Try, in order:
mdsmith version
go run ./cmd/mdsmith version
If only the second succeeds, substitute
go run ./cmd/mdsmith for mdsmith below.
-
Run the fix:
mdsmith fix -- <path>
where <path> is the skill argument, or .
when none was given.
-
If the command exits non-zero, surface the
full stderr to the user.
-
Report the fix summary from the last line of
stderr, which reads:
stats: checked=N fixed=N failures=N unfixed=N.
Notes
mdsmith fix loops up to 10 passes. It exits
0 even when files change — a non-zero exit
means the CLI itself failed (binary missing,
config parse error, etc.).
