Agent skill

Apply Comments

by simonliu-ai-product in simonliu-ai-product/open-doc

A skill your agent uses when the user asks to apply, process, or clear the comments they left in the open-doc inspector — phrases like "apply the comments", "apply my edits", "I left notes on the…

MITAuto-check passedFrontend & Design

Install Apply Comments

skills CLI
$ npx skills add simonliu-ai-product/open-doc --skill apply-comments -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install simonliu-ai-product/open-doc apply-comments --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/simonliu-ai-product/open-doc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/core/skills/apply-comments .claude/skills/apply-comments && rm -rf skills-src

Use ~/.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/

Facts

Skill name
apply-comments
GitHub stars
108
Token cost
~948 tokens
SKILL.md length
475 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to apply, process, or clear the comments they left in the open-doc inspector — phrases like "apply the comments", "apply my edits", "I left notes on the…

  • Works in 6 steps: Find the pending comments → Read each one in context → Make the edit → …
  • The user asks to apply
  • SKILL.md covers Step 1 — Find the pending…, Step 2 — Read each one in…, Step 3 — Make the edit and Step 4 — Remove the marker, plus 2 more sections
  • Calls curl

What it does

Apply Comments is an agent skill from simonliu-ai-product/open-doc. Use this skill when the user asks to apply, process, or clear the comments they left in the open-doc inspector — phrases like "apply the comments", "apply my edits", "I left notes on the document", "process the markers", "/apply-comments". It finds every @doc-comment marker under docs/, makes the edit each one asks for, then removes the marker. Do NOT use for authoring new documents — that is create-doc.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design. The repository describes itself as: The document framework built for agents — write reports as React, get real A4 pages, an outline, page numbers, and a PDF. The licence is MIT.

When your agent uses it

  • The user asks to apply
  • Clear the comments they left in the open-doc inspector — phrases like apply the comments
  • I left notes on the document
  • Process the markers

Example prompts

  • “apply the comments”
  • “apply my edits”
  • “I left notes on the document”
  • “/apply-comments”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Find the pending comments
  2. Read each one in context
  3. Make the edit
  4. Remove the marker
  5. Verify
  6. Hand off

What it can do on your machine

Read from SKILL.md and the folder at commit af6095d. 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

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    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

Apply Comments loads about 948 tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 475 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~948

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 simonliu-ai-product/open-doc at commit af6095d, republished under its MIT licence (© simonliu-ai-product). 475 words, ~948 tokens.

Download SKILL.mdSave it as .claude/skills/apply-comments/SKILL.md (or your agent's skills folder).
name
apply-comments
description
Use this skill when the user asks to apply, process, or clear the comments they left in the open-doc inspector — phrases like "apply the comments", "apply my edits", "I left notes on the document", "process the markers", "/apply-comments". It finds every `@doc-comment` marker under `docs/`, makes the edit each one asks for, then removes the marker. Do NOT use for authoring new documents — that is `create-doc`.

Apply inspector comments

In the viewer the user leaves notes from the Comments panel (M) or the element panel in edit mode, and the panel's Copy request for the agent button hands you /apply-comments docs/<id> — when a path is given, work on that document only. Each note is written into the document source as a marker:

tsx
<p style={p}>
  {/* @doc-comment id="c-4591fd61" ts="2026-08-15T15:40:52.644Z" text="<base64url>" */}
  從 FastMCP 開發、容器化…
</p>

The marker is always the first child of the element the note is about — that is your anchor. text is base64url-encoded JSON: {"note": "...", "hint": "p"}.

Step 1 — Find the pending comments

If the request named a document (docs/<id>), look only there.

bash
grep -rn "@doc-comment" docs/

If the dev server is running you can read them decoded instead, which is easier:

bash
curl -s "http://localhost:5273/__comments?docId=<id>"

That returns { comments: [{ id, line, ts, note, hint }] }. If neither turns anything up, tell the user there are no pending comments and stop.

Step 2 — Read each one in context

For every marker, read the surrounding element — not just the marked line. A note like "make this shorter" is meaningless without the paragraph it sits in. Open the file with Read around the marker's line (±40 lines is usually enough) so you can see the element, its styles, and its neighbours.

Group comments by document, and handle them oldest ts first — later notes may refine earlier ones.

Step 3 — Make the edit

Apply what the note asks for, following the doc-authoring skill: it owns the type scale, the flow/vertical-budget rules, and the design tokens. In particular:

  • Edit the element the marker is anchored to. Never reformat the whole file.
  • A note about wording changes the text; a note about weight, color, or size changes the inline style — prefer var(--od-*) tokens over new hard-coded values.
  • If the change makes a fixed page overflow, split the page or move the content into the flow() section (references/pagination.md).
  • If a note is ambiguous ("fix this"), do the smallest reasonable interpretation and say what you assumed at hand-off. Don't guess at a large rewrite.
  • If a note asks for something the framework can't do (per-page orientation, a splitting table), say so in the hand-off and leave the marker in place.
Show full SKILL.md (128 more words)Show less

Step 4 — Remove the marker

Delete the marker line for every comment you actually applied. Leave markers you deliberately skipped, and say which ones and why.

bash
# with the dev server running
curl -s -X DELETE "http://localhost:5273/__comments?docId=<id>&id=<comment-id>"

Or delete the {/* @doc-comment … */} line directly with Edit. Removing it by hand is fine — the marker is a plain JSX comment.

Step 5 — Verify

  • No @doc-comment marker remains for an applied note: grep -rn "@doc-comment" docs/.
  • The document still compiles: it hot-reloads in the browser; check the terminal for a Vite error.
  • Run the "Self-review before finishing" checklist in doc-authoring for any page you touched.

Step 6 — Hand off

Tell the user, in one short list:

  • What you changed, one line per comment.
  • Anything you skipped and why.
  • Any assumption you made on an ambiguous note.

Do not restate the whole document.

© simonliu-ai-product, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/core/skills/apply-comments of simonliu-ai-product/open-doc.

Open the folder on GitHubat commit af6095d

Compare with similar skills

Apply Comments 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.

Apply Comments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apply Comments this skillsimonliu-ai-product/open-doc108—~948Automated safety check: PassMIT
Web Artifacts Builderanthropics/skills180k41 repos~769Automated safety check: PassApache-2.0
React Doctormakeplane/plane61k12 repos~657Automated safety check: PassAGPL-3.0
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Figma Design System Builderwarpdotdev/warp65k2 repos~4.4kAutomated safety check: PassAGPL-3.0
Web Interface Guidelines Reviewervercel-labs/openreview1.7k97 repos~308Automated safety check: PassNone

Similar skills

  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 41 repos~769 tokens
    Frontend & DesignAuto-check passed
  • React Doctor

    makeplane/plane

    Scans React code for lint, accessibility, bundle size and architecture issues, reports a health score and checks that changes do not lower it.

    61k GitHub starsUsed in 12 repos~657 tokens
    Frontend & DesignAuto-check passed
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Web Interface Guidelines Reviewer

    vercel-labs/openreview

    Official

    Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…

    1.7k GitHub starsUsed in 97 repos~308 tokens
    Frontend & DesignAuto-check passed
  • Tailwindcss Development

    anonaddy/anonaddy

    Always invoke when the user's message includes 'tailwind' in any form.

    4.9k GitHub starsUsed in 10 repos~865 tokens
    Frontend & DesignAuto-check passed

More from simonliu-ai-product/open-doc

  • Doc Authoring

    simonliu-ai-product/open-doc

    Technical reference for writing or editing open-doc pages — file contract, the A4/B4/A3 page canvas, print type scale, the vertical budget that decides where a page breaks, tables, charts, table of…

    108 GitHub stars~6.8k tokensUpdated 3 days ago
    Auto-check passed
  • Create Doc

    simonliu-ai-product/open-doc

    A skill your agent uses when the user wants to create, draft, author, or generate a new document, report, whitepaper, proposal, memo, or spec in this open-doc repo.

    108 GitHub stars~2.4k tokensUpdated 3 days ago
    Auto-check passed
  • Current Doc

    simonliu-ai-product/open-doc

    Resolve which document, page, and (optionally) selected element the user is currently viewing in the open-doc dev server.

    108 GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed
  • Doc Runtime Patterns

    simonliu-ai-product/open-doc

    Implementation patterns for the @open-doc/core runtime — the split between the viewer and the published bundle, virtual modules, the flow pipeline, the ops layer, dev-only plugins, and the…

    108 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • Print Layout Review

    simonliu-ai-product/open-doc

    Reviews page layout, typography, and pagination code in open-doc against a print craft bar — the sheet is the deliverable, not the screen.

    108 GitHub stars~2k tokensUpdated 3 days ago
    Auto-check passed
  • Viewer UI Guidelines

    simonliu-ai-product/open-doc

    Design and accessibility rules for the open-doc viewer chrome — the browser shell, sidebars, thumbnail rail, outline, assets and design panels, inspector overlay, and menus.

    108 GitHub stars~1.6k tokensUpdated 3 days ago
    Auto-check passed

Questions about Apply Comments

What does Apply Comments do?

A skill your agent uses when the user asks to apply, process, or clear the comments they left in the open-doc inspector — phrases like "apply the comments", "apply my edits", "I left notes on the…. Apply Comments is an agent skill from simonliu-ai-product/open-doc. Use this skill when the user asks to apply, process, or clear the comments they left in the open-doc inspector — phrases like "apply the comments", "apply my edits", "I left notes on the document", "process the markers", "/apply-comments".

When should I use Apply Comments?

Apply Comments fits situations like: the user asks to apply; clear the comments they left in the open-doc inspector — phrases like apply the comments; I left notes on the document; process the markers.

How do I install Apply Comments in Claude Code?

Run `npx skills add simonliu-ai-product/open-doc --skill apply-comments -a claude-code`. Or copy the skill folder (packages/core/skills/apply-comments in simonliu-ai-product/open-doc) into .claude/skills/apply-comments in your project. Claude Code loads it when a task matches its description.

How do I install Apply Comments in Codex?

Run `npx skills add simonliu-ai-product/open-doc --skill apply-comments -a codex`. Or copy the skill folder (packages/core/skills/apply-comments in simonliu-ai-product/open-doc) into .agents/skills/apply-comments in your project. Codex loads it when a task matches its description.

Can I use Apply Comments 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 simonliu-ai-product/open-doc --skill apply-comments -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apply-comments, .gemini/skills/apply-comments, .github/skills/apply-comments and .opencode/skills/apply-comments in your project.

What does Apply Comments need to run?

Going by SKILL.md and its folder, Apply Comments needs the command-line tools its instructions call (curl).

Does Apply Comments access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Apply Comments 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 Apply Comments use?

Apply Comments is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apply Comments use?

About 948 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Apply Comments?

Skills that share tags, products or a category with Apply Comments: Web Artifacts Builder (anthropics/skills, 180k stars), React Doctor (makeplane/plane, 61k stars), Impeccable (bestofjs/bestofjs, 3.1k stars) and Figma Design System Builder (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apply Comments?

simonliu-ai-product (a GitHub organization) maintains it in simonliu-ai-product/open-doc, which has 108 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

Source: simonliu-ai-product/open-doc on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.