How do I install the Preview Versions skill?

Run npx skillmds@latest add comarkdown/preview-versions in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Preview Versions safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Preview Versions?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Preview Versions free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Preview Versions?

comarkdown (@comarkdown) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Preview Versions by comarkdown — Agent Skill

Name: Preview Versions
Author: comarkdown

Preview Versions

Preview documentation at a branch, commit or pull request without changing production. Use when debugging content on /tree/:branch, /blob/:sha or /pr/:number, or explaining how ISR and GitHub-pinned content work.

comarkdown fadb9e2 1.5 KB Updated Sep 17, 2026

File contents

Preview versions

Content is served at request time. Production is pinned to a commit SHA; any branch, commit or pull request can be previewed through versioned URLs.

Mode	URL	Content
prod	`/getting-started/introduction`	pinned production SHA
tree	`/tree/main/getting-started/introduction`	latest commit touching the content directory
blob	`/blob/<sha>/getting-started/introduction`	immutable commit
pr	`/pr/<number>/getting-started/introduction`	the PR's head commit (follows new pushes)

Commit and PR previews are authorized: a /blob/ SHA must be in production history or belong to a PR (same-repo, or a fork PR carrying the preview:enabled label), and /pr/ applies the same rule. Unauthorized refs answer 404.

Raw markdown mirrors exist at /raw/** for production pages only — preview pages serve HTML.

Two cache tiers: ISR-cached page HTML at the edge, and a per-parser-version, per-content-SHA runtime cache for parsed Markdown bodies. A GitHub push to the production branch hits /api/revalidate and purges ISR.

Keyboard shortcut g h toggles the version-history panel on a docs page.

Read more: Architecture, Versioned previews.

Frequently asked questions