markdown-novel-viewer — Claude Code skill: Markdown viewer
markdown-novel-viewer is a Claude Code skill that serves Markdown files as reading pages and directories as navigable lists. Read project plans and documentation in a browser.
no license 1 installs ★ 224 updated 2026-10-29
npx skills add NeverSight/learn-skills.dev --skill markdown-novel-viewer -a claude-codeWhat markdown-novel-viewer does
The skill serves Markdown files as reading pages and directories as navigable file lists. The viewer includes light and dark themes, code highlighting, and phase navigation when it detects a plan directory structure. You can move between phases with the arrow keys.
The server runs from scripts/server.cjs and accepts a file or directory path. It can open the browser automatically or run in the background. Node.js and the npm packages marked, highlight.js, and gray-matter are required; install them with npm install from the skill directory. Without those packages, Markdown rendering fails.
The default host is localhost, so access from another device requires --host 0.0.0.0. The default port is 3456; if it is busy, the server picks another available port. Use --stop to stop running servers.
What it helps with
- open a Markdown file in a browser for reading
- browse a directory and follow links into subfolders
- navigate between phases in a detected plan
- run the Markdown viewer in the background
- stop active viewer servers
Example prompts for the agent
- Open
README.mdin the browser with the Markdown viewer. - Browse
plans/and let me navigate to its files. - Start a background view of
plans/my-plan/plan.md.
How to install markdown-novel-viewer
1Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill markdown-novel-viewer -a claude-code2Manually: put the files in place
~/.claude/skills/markdown-novel-viewer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/markdown-novel-viewer/
1Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill markdown-novel-viewer -a codex2Manually: put the files in place
.agents/skills/markdown-novel-viewer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill markdown-novel-viewer -a cursor2Manually: put the files in place
.cursor/skills/markdown-novel-viewer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NeverSight/learn-skills.dev data/skills-md/duc01226/easyplatform/markdown-novel-viewer2Manually: put the files in place
.github/skills/markdown-novel-viewer/SKILL.md1Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill markdown-novel-viewer -a gemini-cli2Platform CLI
gemini skills install https://github.com/NeverSight/learn-skills.dev --path data/skills-md/duc01226/easyplatform/markdown-novel-viewerManually: put the files in place
.devin/skills/markdown-novel-viewer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill markdown-novel-viewer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about markdown-novel-viewer
How do I install markdown-novel-viewer in Claude Code?
Run npx skills add NeverSight/learn-skills.dev --skill markdown-novel-viewer -a claude-code. The skill file is at ~/.claude/skills/markdown-novel-viewer/SKILL.md; install its npm packages with npm install from the skill directory before rendering Markdown.
What does markdown-novel-viewer do?
It starts an HTTP server that displays Markdown files and browsable directory listings in a browser. Detected plan folders also get phase navigation and theme controls.
Which dependencies does the Markdown viewer need?
It needs Node.js and the npm packages marked, highlight.js, and gray-matter. Rendering fails if those packages have not been installed.