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.
中文简介正在准备中。当前显示原文说明。
查看安装方法安装前可以查看交给 AI 代理的指令内容。
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.
还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
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.
中文简介正在准备中。当前显示原文说明。
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.
中文简介正在准备中。当前显示原文说明。
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).
中文简介正在准备中。当前显示原文说明。
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.
中文简介正在准备中。当前显示原文说明。
Angular v20+ patterns: components, signals, services, forms, routing, HTTP, testing, SSR. Auto-activates on .ts files in Angular projects (angular.json detected).
中文简介正在准备中。当前显示原文说明。
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.
中文简介正在准备中。当前显示原文说明。