Proof Markdown Collaboration
EveryInc/compound-engineering-plugin
Publishes, reads, comments on, or edits shared markdown documents through the hosted Proof editor's web API.
Opens markdown files in a formatted cmux panel beside the terminal that re-renders on every change, handy for plans and task lists.
Install Cmux Markdown Viewer Panel
$ npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install basicmachines-co/basic-memory cmux-markdown --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cmux-markdown .claude/skills/cmux-markdown && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "cmux-markdown" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/.agents/skills/cmux-markdown into .claude/skills/cmux-markdown/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-markdown", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/basicmachines-co/basic-memory/tree/main/.agents/skills/cmux-markdownType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install basicmachines-co/basic-memory cmux-markdown --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/cmux-markdown .agents/skills/cmux-markdown && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cmux-markdown" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/.agents/skills/cmux-markdown into .agents/skills/cmux-markdown/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-markdown", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install basicmachines-co/basic-memory cmux-markdown --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/cmux-markdown .cursor/skills/cmux-markdown && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cmux-markdown" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/.agents/skills/cmux-markdown into .cursor/skills/cmux-markdown/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-markdown", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/basicmachines-co/basic-memory.git --path .agents/skills/cmux-markdown--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install basicmachines-co/basic-memory cmux-markdown --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/cmux-markdown .gemini/skills/cmux-markdown && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cmux-markdown" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/.agents/skills/cmux-markdown into .gemini/skills/cmux-markdown/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-markdown", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install basicmachines-co/basic-memory cmux-markdownInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/cmux-markdown .github/skills/cmux-markdown && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cmux-markdown" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/.agents/skills/cmux-markdown into .github/skills/cmux-markdown/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-markdown", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install basicmachines-co/basic-memory cmux-markdown --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/cmux-markdown .opencode/skills/cmux-markdown && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cmux-markdown" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/.agents/skills/cmux-markdown into .opencode/skills/cmux-markdown/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-markdown", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
cmux-markdown- GitHub stars
- 4.1k
- Used in
- 2 other repos
- Token cost
- ~527 tokens
- SKILL.md length
- 185 words
- Files
- 4 (incl. references)
- Skills in repo
- 49
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Opens markdown files in a formatted cmux panel beside the terminal that re-renders on every change, handy for plans and task lists.
- Showing an agent plan or task list in a rendered panel next to the terminal
- SKILL.md covers Agent usage, Rendering and Deep-dive references
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Watching documentation or a changelog update live as it is edited
What it does
The agent writes a .md file and opens it with cmux markdown open, which splits a panel next to the current terminal. The panel re-renders whenever the file changes on disk, including atomic replacements from editor saves or sed -i. Options place it in a given workspace, surface or window, and relative paths resolve against the working directory with the absolute path printed back.
Agents should write the full file before opening it so the panel never shows a half-written plan, then overwrite or append as work progresses. The viewer renders headings, code blocks, tables, nested lists, blockquotes, links, rules and inline images in light and dark mode. The skill suggests adding a plan-display note to a project's AGENTS.md, and references cover command syntax and live-reload behavior.
When your agent uses it
- Showing an agent plan or task list in a rendered panel next to the terminal
- Watching documentation or a changelog update live as it is edited
- Following notes that another process appends to progressively
Example prompts
- “Write the migration plan to PLAN.md and open it in cmux.”
- “Open design.md in a side panel so I can watch it update.”
- “Add a Plan Display note to AGENTS.md so future plans open in cmux.”
Requirements
- The cmux terminal app with its markdown command
What it can do on your machine
Read from SKILL.md and the folder at commit 6982cfc. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Cmux Markdown Viewer Panel loads about 527 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 185 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from basicmachines-co/basic-memory at commit 6982cfc, republished under its AGPL-3.0 licence (© basicmachines-co). 185 words, ~527 tokens.
Download SKILL.mdSave it as
.claude/skills/cmux-markdown/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- name
- cmux-markdown
- description
- Open markdown files in a formatted viewer panel with live reload. Use when you need to display plans, documentation, or notes alongside the terminal with rich rendering (headings, code blocks, tables, lists).
Markdown Viewer with cmux
Write a .md file, open it in a panel, and the panel re-renders whenever the file changes on disk. Use it for agent plans and task lists alongside the terminal, documentation and changelogs while working, and notes another process updates progressively.
cmux markdown open plan.md # split next to the current terminal
cmux markdown open /path/to/PLAN.md
cmux markdown open design.md --workspace workspace:2 # also --surface, --windowRelative paths resolve against the caller's cwd and ~ expands; the resolved absolute path comes back in the output.
Agent usage
Write the full plan file first, then open it, so the panel never shows a partially written file. After that, overwrite or append freely: each write triggers a re-render, and atomic replacement (editor saves, sed -i, VS Code) is handled.
To instruct coding agents in a project, add to its AGENTS.md:
## Plan Display
When creating a plan or task list, write it to a `.md` file and open it in cmux:
cmux markdown open plan.md
The panel renders markdown with rich formatting and auto-updates when the file changes.Rendering
Headings h1-h6 (dividers on h1/h2), fenced code blocks in monospace, inline code with a highlighted background, tables with alternating row colors, nested ordered and unordered lists, blockquotes with a left border, bold/italic/strikethrough, clickable links, horizontal rules, and inline images. Light and dark mode both supported.
Deep-dive references
| Reference | When to Use |
|---|---|
| references/commands.md | Full command syntax, options, output shape, panel behavior |
| references/live-reload.md | File watching, atomic writes, unavailable-file state, performance |
© basicmachines-co, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 3 other files (references) in .agents/skills/cmux-markdown of basicmachines-co/basic-memory.
- SKILL.md
- agents/openai.yaml
- references/commands.md
- references/live-reload.md
Open the folder on GitHubat commit 6982cfc
Used in 2 other repositories
We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in basicmachines-co/basic-memory, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Cmux Markdown Viewer Panel next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Cmux Markdown Viewer Panel this skillbasicmachines-co/basic-memory | 4.1k | 2 repos | ~527 | Automated safety check: Pass | AGPL-3.0 | |
| Proof Markdown CollaborationEveryInc/compound-engineering-plugin | 25k | — | ~1.9k | Automated safety check: Notes | MIT | |
| Clean Content FetchLeoYeAI/openclaw-master-skills | 2.2k | — | ~574 | Automated safety check: Pass | MIT | |
| X Article Publisherwshuyi/x-article-publisher-skill | 868 | 2 repos | ~3.6k | Automated safety check: Pass | MIT | |
| Markvisgeekplux/markvis | 1.6k | — | ~786 | Automated safety check: Pass | MIT | |
| URL to Markdown Fetcherjoeseesun/qiaomu-markdown-proxy | 508 | — | ~1.4k | Automated safety check: Pass | MIT |
Similar skills
Clean Content Fetch
LeoYeAI/openclaw-master-skills
获取干净、可读的网页正文内容，适合现代网页、博客、新闻、公告和微信公众号文章抓取；支持网页正文提取、内容清洗、去噪、Markdown 输出，适用于普通 fetch 效果不佳、页面噪音较多或动态渲染干扰的场景。Clean content fetch for modern web pages, article extraction, WeChat article capture, content…
X Article Publisher
wshuyi/x-article-publisher-skill
Publish Markdown articles to X (Twitter) Articles editor with proper formatting.
Markvis
geekplux/markvis
A skill your agent uses when the user wants a chart of numbers in Markdown (bar, line, area, scatter, pie, hist, heatmap, funnel, waterfall, radar, gauge, sankey, treemap, dumbbell, bullet, boxplot…
URL to Markdown Fetcher
joeseesun/qiaomu-markdown-proxy
Converts a URL or PDF into clean Markdown, with dedicated routes for WeChat articles, Feishu docs, arXiv papers and login-gated pages, before any summary or rewrite.
React Zmage Integration
Caldis/react-zmage
A skill your agent uses when adding the react-zmage React image viewer to an existing React, Next.js, MDX, CMS, markdown, or rich text image surface.
More from basicmachines-co/basic-memory
All 49 skills in this repocmux Settings Editor
basicmachines-co/basic-memory
Views, sets, unsets and validates cmux settings in ~/.config/cmux/cmux.json with a helper script that checks keys against the schema.
cmux Window and Pane Control
basicmachines-co/basic-memory
End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs…
cmux Workspace Scoping
basicmachines-co/basic-memory
Keeps agent actions scoped to the cmux workspace and terminal that invoked it, and lays out pane and surface commands that avoid disrupting the user's own focus.
Basic Memory Repo Images
basicmachines-co/basic-memory
Produces PR, changelog and two-week retro images for the Basic Memory repository from evidence in PR bodies, saved to fixed paths under docs/assets/infographics.
Logfire Instrumentation
basicmachines-co/basic-memory
Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.
Basic Memory Onboarding
basicmachines-co/basic-memory
Guides a newcomer to Basic Memory through designing a personal knowledge system, then teaches its use and sets up their assistant to load it each session.
Related
Questions about Cmux Markdown Viewer Panel
What does Cmux Markdown Viewer Panel do?
Opens markdown files in a formatted cmux panel beside the terminal that re-renders on every change, handy for plans and task lists. md file and opens it with cmux markdown open, which splits a panel next to the current terminal. The panel re-renders whenever the file changes on disk, including atomic replacements from editor saves or sed -i.
When should I use Cmux Markdown Viewer Panel?
Cmux Markdown Viewer Panel fits situations like: showing an agent plan or task list in a rendered panel next to the terminal; watching documentation or a changelog update live as it is edited; following notes that another process appends to progressively.
How do I install Cmux Markdown Viewer Panel in Claude Code?
Run `npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a claude-code`. Or copy the skill folder (.agents/skills/cmux-markdown in basicmachines-co/basic-memory) into .claude/skills/cmux-markdown in your project. Claude Code loads it when a task matches its description.
How do I install Cmux Markdown Viewer Panel in Codex?
Run `npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a codex`. Or copy the skill folder (.agents/skills/cmux-markdown in basicmachines-co/basic-memory) into .agents/skills/cmux-markdown in your project. Codex loads it when a task matches its description.
Can I use Cmux Markdown Viewer Panel in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add basicmachines-co/basic-memory --skill cmux-markdown -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cmux-markdown, .gemini/skills/cmux-markdown, .github/skills/cmux-markdown and .opencode/skills/cmux-markdown in your project.
What does Cmux Markdown Viewer Panel need to run?
SKILL.md names no scripts, command-line tools or credentials: Cmux Markdown Viewer Panel is instructions for the agent only. Our summary lists: The cmux terminal app with its markdown command.
Does Cmux Markdown Viewer Panel access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Cmux Markdown Viewer Panel safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Cmux Markdown Viewer Panel use?
Cmux Markdown Viewer Panel is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Cmux Markdown Viewer Panel use?
About 527 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 582 tokens, read only when the agent opens those files.
What are the alternatives to Cmux Markdown Viewer Panel?
Skills that share tags, products or a category with Cmux Markdown Viewer Panel: Proof Markdown Collaboration (EveryInc/compound-engineering-plugin, 25k stars), Clean Content Fetch (LeoYeAI/openclaw-master-skills, 2.2k stars), X Article Publisher (wshuyi/x-article-publisher-skill, 868 stars) and Markvis (geekplux/markvis, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Cmux Markdown Viewer Panel?
basicmachines-co (a GitHub organization) maintains it in basicmachines-co/basic-memory, which has 4,107 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 7, 2026.
Source: basicmachines-co/basic-memory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.