Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add NeverSight/learn-skills.dev --skill markdown-novel-viewer -a claude-code
Open on GitHub

What 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.md in 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-code

2Manually: put the files in place

~/.claude/skills/markdown-novel-viewer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/markdown-novel-viewer/

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.

Similar skills

All skills for Writing and docs →

From the same set6

Project sponsors

Companies that keep this analytics open