markdown-review

Opens local Markdown files in a centered tmux Glow popup for review and editing.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/wesbragagt/nixos-config --skill markdown-review-wesbragagt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-review
Source: https://github.com/wesbragagt/nixos-config/tree/main/home/skills/markdown-review
Command: npx skills add https://github.com/wesbragagt/nixos-config --skill markdown-review-wesbragagt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reading and reviewing Markdown documents in a terminal often means raw text dumps or switching to a separate editor. This Skill renders Markdown files in a centered tmux popup with Glow, wrapping content at 100 columns and reloading files automatically after edits. ## Core Features & Use Cases - Single-file review: Run glow-review path/to/document.md to open one Markdown file or directory in a centered tmux popup. - Multi-file selection: Run mk with no arguments to pick multiple Markdown files with fzf, then navigate between them in Glow's file list. - In-place editing: Press e inside Glow to open the current file in Neovim via $EDITOR; Glow reloads the document when Neovim exits. - Use Case: After drafting an implementation plan in docs/, ask the agent to open it for review, read it in the rendered popup, and press e to fix typos without leaving the terminal. ## Quick Start Ask the agent to open docs/implementation-plan.md for review in the terminal using the markdown-review skill.

Frequently Asked Questions about markdown-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preview Markdown files in the terminal?

Run glow-review followed by the file path to render a Markdown file in a centered tmux popup using Glow. The document wraps at 100 columns and reloads automatically after edits.

How to review multiple Markdown files at once in a terminal?

Run mk with no arguments to select multiple Markdown files using fzf. Press Tab to select files and Enter to open Glow's file list, where you can move between the chosen documents.

Can I edit a Markdown file while previewing it with Glow?

Yes. While Glow displays a local document, press e to open the same file in Neovim via $EDITOR. When you exit Neovim, Glow returns and reloads the updated document.

Does glow-review work outside of tmux?

No. glow-review opens a centered tmux popup, so it requires an active tmux session. Popup contents are outside pane scrollback and cannot be captured for verification.

What are the limitations of reviewing Markdown in a tmux popup?

The popup renders only local readable Markdown files and cannot be screenshotted or captured by the agent. Editing is a manual user action; the agent must not send the e key automatically.