Menu
Auto-fix markdown lint issues across all .md files and report what changed
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Write Bash commands that don't trigger unnecessary permission prompts. Use Read/Edit/Grep instead of head/tail/sed/awk/cat/echo; split chained commands (&&, ;, ||) into separate Bash calls; drop diagnostic suffixes like `; echo "EXIT=$?"`. The allowlist matches whole command strings — every mismatch costs the user attention.
Commit user-named files atomically via scripts/commit-pathspec.sh (which wraps `git commit -m "..." -- <files>` and writes the provenance token the pre-commit hook validates). Applies the CLAUDE.md "Pre-commit hook failures on unrelated changes" protocol when the hook fails. Never adds --no-verify silently — explicit user approval is required.
Scaffold a new epic file in docs/developers/tasks/open/ and run housekeep
Scaffold a new idea file in docs/developers/ideas/open/ and regenerate the ideas OVERVIEW.md
Set a task to active — updates status, moves to active/, runs housekeep. Also resumes paused tasks (paused/ → active/ or active/ with closed prerequisites).
Mark a task as closed — writes effort_actual, moves the file to closed/, runs housekeep, and commits
| name | fix-markdown |
| description | Auto-fix markdown lint issues across all .md files and report what changed |
Run markdownlint-cli2 in fix mode across all Markdown files and report what was changed.
Steps:
Record which .md files currently have unstaged changes:
git diff --name-only -- '*.md'
Run:
make lint-markdown
Compare the git status before and after to determine which files were auto-fixed by the linter.
Report:
If files were fixed, remind the user to review the changes and stage them before
committing. The pre-commit hook runs markdownlint on staged .md files automatically.
Do not stage or commit — leave that to the user.