// Fast, consistent Markdown auto-formatter for typographic cleanup (smart quotes, ellipses), normalized formatting, and optional clean line wrapping for small, readable git diffs. Use when creating, editing, or normalizing Markdown (.md) files, cleaning up LLM-generated Markdown, or when the user mentions flowmark or formatting Markdown.
Fast, consistent Markdown auto-formatter for typographic cleanup (smart quotes, ellipses), normalized formatting, and optional clean line wrapping for small, readable git diffs. Use when creating, editing, or normalizing Markdown (.md) files, cleaning up LLM-generated Markdown, or when the user mentions flowmark or formatting Markdown.
Git-native issue tracking (beads), coding guidelines, knowledge injection, and spec-driven planning for AI agents. Drop-in replacement for bd/Beads with simpler architecture. Use for: tracking issues/beads with dependencies, creating bugs/features/tasks, planning specs, implementing features from specs, code reviews, committing code, creating PRs, loading coding guidelines (TypeScript, Python, TDD, golden testing, Convex, monorepo patterns), code cleanup, research briefs, architecture docs, agent handoffs, and checking out third-party library source code. Invoke when user mentions: tbd, beads, bd, shortcuts, issues, bugs, tasks, features, epics, todo, tracking, specs, planning, implementation, validation, guidelines, templates, commit, PR, pull request, code review, testing, TDD, test-driven, golden testing, snapshot testing, TypeScript, Python, Convex, monorepo, cleanup, dead code, refactor, handoff, research, architecture, labels, search, checkout library, source code review, or any workflow shortcut.
| name | flowmark |
| description | Fast, consistent Markdown auto-formatter for typographic cleanup (smart quotes, ellipses), normalized formatting, and optional clean line wrapping for small, readable git diffs. Use when creating, editing, or normalizing Markdown (.md) files, cleaning up LLM-generated Markdown, or when the user mentions flowmark or formatting Markdown. |
| allowed-tools | Bash(flowmark:*), Bash(uvx:*), Read, Write |
Fast, consistent Markdown auto-formatter. Run it on Markdown you generate or edit so committed diffs stay small and readable. It is conservative and safe to run on every file: it never modifies code blocks or inline code.
Format in place with all auto-formatting (typography, cleanups, semantic line breaks):
flowmark --auto FILE # one file
flowmark --auto . # whole tree (respects .gitignore and .flowmarkignore)
Omit --auto to preview to stdout; pipe stdin with - (e.g. cat FILE | flowmark -).
Flowmark ships as two packages with identical formatting and the same flowmark
command: the fast native Rust port flowmark-rs
(recommended) and the Python reference flowmark.
Prefer flowmark-rs; reach for the Python build only when you need its library API or the
very latest patch release not yet ported to Rust.
If flowmark is not on PATH, run it with a version-pinned runner (never @latest):
# Recommended: fast native Rust port
uvx --from flowmark-rs==__FLOWMARK_RS_VERSION__ flowmark --auto FILE
# Python reference (library API or newest patch releases)
uvx --from flowmark==__FLOWMARK_VERSION__ flowmark --auto FILE
--semantic).Flowmark documents itself. Use the CLI rather than reproducing details here:
flowmark --help — every flag: --semantic, --smartquotes, --ellipses,
--width, --check, list spacing, and file discovery
(--extend-include/--extend-exclude).flowmark --docs — the full guide: editor on-save setup (VS Code/Cursor), project
wiring (pre-commit/CI, .flowmarkignore), config files, the Python library API, and
installing this skill for other agents (flowmark --install-skill).