AGENT SKILL

monoshot

Render code as an image with theming, annotations, multiple languages, sharable links, and more. Use for local exports, hosted rendering, editor links, theme discovery, skill installation, or MCP setup.

License 许可
MIT
所属仓库
wevm/monoshot
最近更新
2026-11-10
Stars
★ 4
Forks
0

01 前言 Front Matter

name
monoshot
description
Render code as an image with theming, annotations, multiple languages, sharable links, and more. Use for local exports, hosted rendering, editor links, theme discovery, skill installation, or MCP setup.

02 资源文件 143

03 SKILL.md 正文

Monoshot

Render code as an image with theming, annotations, multiple languages, sharable links, and more.

Choose an interface

  • Prefer the CLI when it can run in the current environment. Use the hosted API when it cannot.
  • Use CLI open to load local code in the browser editor.
  • Use CLI render for a local PNG or SVG export. It keeps the source local and requires Chrome or Chromium.
  • Use CLI share to print an editor URL without opening a browser.
  • Use the hosted API for remote services, scripts, or environments where the CLI and a local browser are unavailable. The API returns PNG or standalone HTML.
  • Use MCP when an agent should call Monoshot repeatedly as structured tools.

Do not send private or sensitive source to the hosted API without authorization. Prefer the local CLI when source must remain on the machine.

When the user supplies a snippet, render it line for line. Preserve every line, blank line, indentation, comment, and character. Do not rewrite, reformat, truncate, or add annotations unless the user asks.

Add annotations

Only change a supplied snippet when the user asks for annotations. Use these exact mappings for comment annotations:

  • Info or note: // @log: message renders a blue info row.
  • Success: // @annotate: message renders a green success row.
  • Warning: // @warn: message renders a yellow warning row.
  • Error: // @error: message renders a red error row.

An annotation comment renders as a row at the same position in the snippet. Preserve its text and placement. Replace // with the language's comment prefix when needed.

Keep annotation rows on one line unless the user asks for wrapping. Omit --width for CLI calls and width for API or MCP calls so Monoshot expands the frame to the longest source or annotation line. Do not split, shorten, or reformat annotation text to make it fit.

Use these presentation annotations on a source line:

  • Highlight: // [!code hl]
  • Focus: // [!code focus]
  • Added line: // [!code ++]
  • Removed line: // [!code --]
  • Inferred type: // ^? aligned beneath the expression

Monoshot removes annotation syntax from the rendered image. A standalone line marker can target following lines with a count, such as // [!code hl:2].

Use the CLI

Run Monoshot without a global installation:

npx monoshot <command>

Or npm i monoshot -g to install globally.

Prefer a file argument for repository source because Monoshot infers the language from the extension:

npx monoshot open src/example.ts
npx monoshot render src/example.ts --out example.png
npx monoshot share src/example.ts --theme vitesse-light

Use --code for a short inline snippet, or - for standard input:

npx monoshot render --code 'const answer: number = 42' --out answer.svg
git show HEAD:src/example.ts | npx monoshot render - --lang typescript --out example.png

Open code in the editor

Use open when the user wants to adjust the code, theme, layout, or annotations interactively:

npx monoshot open src/example.ts --theme tempo

The command builds an editor URL and opens it with the platform browser.

Export an image

Use render when the requested result is an image artifact:

npx monoshot render src/example.ts --out example.png
npx monoshot render src/example.ts --type svg --out example.svg

PNG is the default. The output extension also selects PNG or SVG. JavaScript and TypeScript enable Twoslash automatically; add ^? queries where type annotations should appear.

After creating an image, run share with the same code and frame settings. Return the resulting monoshot.dev editor URL alongside the image.

Return an editor link

Use share to print the configured snippet URL without launching a browser:

npx monoshot share src/example.ts --theme github-light

The returned URL carries the snippet and frame settings in its fragment. Use open instead when the browser should launch immediately.

Select a theme and frame

List accepted theme names before choosing a non-default theme:

npx monoshot themes

The open, render, and share commands accept common frame options such as --background, --lang, --padding, --radius, --theme, --title, --title-bar, and --width.

Omit --width for CLI calls and width for API or MCP calls by default. Set a width only when the user asks to wrap or constrain the image. Use scale to increase PNG resolution without widening the layout.

Inspect the current command contract when an option is uncertain:

npx monoshot <command> --help

Use the hosted API

Use the hosted API when the CLI cannot run in the current environment.

Use POST /api/image for a PNG:

curl --fail-with-body https://monoshot.dev/api/image \
  --header 'content-type: application/json' \
  --data '{"code":"const answer: number = 42","lang":"typescript","theme":"vitesse-dark"}' \
  --output answer.png

Use POST /api/document for a self-contained HTML document without scripts or external requests:

curl --fail-with-body https://monoshot.dev/api/document \
  --header 'content-type: application/json' \
  --data '{"code":"const answer: number = 42","lang":"typescript","theme":"vitesse-dark"}' \
  --output answer.html

Both endpoints require code and lang. They accept frame settings including background, padding, radius, theme, title, titleBar, and width. The image endpoint also accepts scale.

JavaScript and TypeScript resolve Twoslash annotations automatically. Add ^? queries where type annotations should appear, or send "twoslash": false to render the notation as source.

List hosted themes with:

curl --fail-with-body https://monoshot.dev/api/themes
curl --fail-with-body 'https://monoshot.dev/api/themes?type=dark'

Read the live OpenAPI schema for current constraints and response formats.

Install the agent skill

Install the hosted skill through Agent Skills discovery:

npx skills add https://monoshot.dev --yes

Alternatively, let the Monoshot CLI install its bundled skill for detected agents:

npx monoshot skills add

The Monoshot CLI installs the skill globally by default. Use --no-global for project-local installation:

npx monoshot skills add --no-global

List the skills exposed by the CLI with npx monoshot skills list.

Install the MCP server

Register Monoshot as an MCP server for detected agents:

npx monoshot mcp add

Use --agent <name> to target one agent or --no-global for project-local registration. Validate startup and tool discovery after registration:

npx monoshot mcp doctor

Prefer MCP over shell commands when the active agent has the Monoshot tools available. Use the same decision boundary: open for interactive editing, render for an image artifact, share for a URL, and themes before selecting an unfamiliar theme.

04 同仓库更多 Skills