Serve a markdown file/directory as a calm, book-like reader via a local HTTP server (127.0.0.1 only); good for long-form docs like RFCs and plans. Supports Mermaid, dark/light mode, and a nav sidebar.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Local HTTP server rendering markdown files with a calm, book-like reading experience.
Note: mk:brainstorming --html and mk:plan-creator --html produce self-contained
HTML files that open directly in the browser — they do not use or need this server.
This skill requires npm dependencies. Install once from the project root:
cd .agents/skills/markdown-reader
npm install
Dependencies: marked, highlight.js, gray-matter
Without installation you will get Error 500: Error rendering markdown.
# View a markdown file (opens browser automatically)
node .agents/skills/markdown-reader/scripts/server.cjs \
--file ./tasks/plans/my-plan/plan.md
# Browse a directory
node .agents/skills/markdown-reader/scripts/server.cjs \
--dir ./tasks/plans
# Background mode (foreground process for Codex task runners)
node .agents/skills/markdown-reader/scripts/server.cjs \
--file ./README.md \
--foreground
# Stop all running instances
node .agents/skills/markdown-reader/scripts/server.cjs --stop
The server binds to 127.0.0.1 (localhost) only. Served files are not reachable from
other devices on the network — this is intentional.
Start with --file or --dir; use --foreground when the host needs to keep the process
attached. The default port is 3456 and increments through 3500 if busy. End the lifecycle with
--stop; never leave a reader process running after the task.
| Need | Route |
|---|---|
| CLI flags, routes, persistent state | references/reader-operations.md |
| Reader features, plan navigation, shortcuts, Mermaid | references/reader-experience.md |
| Architecture and troubleshooting | references/reader-operations.md |
The server binds only to 127.0.0.1. It validates every file against its allowed directories;
traversal attempts return 403. Referenced images must be relative to the source markdown file.
Self-contained HTML from mk:brainstorming --html or mk:plan-creator --html opens directly
and does not need this server.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Use this skill to generate well-branded interfaces and assets for MeowKit (AI Agent Toolkit for Claude Code), either for production or throwaway prototypes/mocks/etc. Contains essential design guidelines, colors, type, fonts, assets, and UI kit components for prototyping.
The English summary is being prepared. Showing the original description.
Turn a raw idea into ONE honest recommendation: interview one question at a time until confirmed, then give a verdict with trade-offs and a checklist. Not for options or debate.
The English summary is being prepared. Showing the original description.
Browser automation CLI for agents: navigate, click/fill, screenshot, extract data, test apps, Electron/Slack, cloud browsers. NOT for the user's real Chrome profile/cookies (mk:chrome-profile).
The English summary is being prepared. Showing the original description.
Detects the right agent and complexity tier at Phase 0 orient; runs first in every workflow. NOT for runtime agent routing inside a single skill.
The English summary is being prepared. Showing the original description.
Angular v20+ patterns: components, signals, services, forms, routing, HTTP, testing, SSR. Auto-activates on .ts files in Angular projects (angular.json detected).
The English summary is being prepared. Showing the original description.
Design and review durable REST, GraphQL, RPC, or event API contracts: shape, compatibility, pagination, error semantics. Discovers existing consumers first. Not implementation, schema, or release.
The English summary is being prepared. Showing the original description.