openpress-apply-comments
Use when applying, resolving, clearing, or inspecting pending open-press @openpress-comment markers, including requests like /apply-comments, apply comment, resolve comments, read comments and modify the document, or remove resolved comment markers.
How do I install this agent skill?
npx skills add https://github.com/quan0715/open-press --skill openpress-apply-commentsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill facilitates the application of source code edits based on comment markers found within a project. It utilizes standard development tools like ripgrep and Node.js to locate, decode, and process these markers, following a workflow that includes verification steps like building the project.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
open-press Apply Comments
This is the workflow skill for turning pending @openpress-comment markers into source edits. A comment is resolved only when the requested source change has been made and the marker has been removed.
openpress-collaborate owns whether the agent should propose, refresh, apply a reviewed preview, or edit directly. Use this skill for marker mechanics. If the user asks to apply .openpress/review/current.json, return to openpress-collaborate instead of interpreting the Comments as a separate direct-edit batch.
Responsibilities
- List pending
@openpress-commentmarkers. - Read the decoded comment note, hint, source path, and nearby source.
- Apply the requested edit as a small source change.
- Remove the marker after the edit is complete.
- Leave ambiguous or failed comments in place.
- Verify before reporting completion.
Boundary
- Use
openpressfor the canonical source/generated path table when unsure. - Edit source, not generated output.
- Default to editing the source file that contains the marker.
- Route domain-heavy work to the owning skill:
openpress-create-pagesfor page prose, hierarchy, captions, claims, tone, narrative, page theme, and page components.openpress-create-slidefor deck narrative, slide density, direct slide sources, active theme tokens, core Object API composition, Tailwind semantic styling, and reusable UI primitives.openpress-pluginsfor external diagramming, visual tools, and writing helpers.
- Do not rewrite unrelated sections while resolving one comment.
Workflow
-
Discover comments.
rg "@openpress-comment" press -nIf decoded notes are needed and the framework helper exists, use it:
node --input-type=module -e 'import { listCommentMarkers } from "./packages/core/engine/react/comment-marker.mjs"; console.log(JSON.stringify(await listCommentMarkers({ root: process.cwd() }), null, 2));' -
Pick the requested scope.
- If the user names one comment, resolve only that comment.
- If the user says apply comments without an id, process pending comments in source order.
- Handle comments one at a time; do not batch unrelated rewrites under one marker.
-
Inspect the target.
- Read the source file that contains the marker.
- Inspect nearby lines before editing.
- Use the marker hint and rendered-object metadata when present, but verify against source.
-
Apply the edit.
- Make the smallest source change that satisfies the comment.
- Preserve local style, component APIs, and MDX structure.
- If the request is ambiguous, ask for clarification and leave the marker in place.
-
Remove the resolved marker.
- Delete the
@openpress-commentmarker only after the source edit is complete. - Do not clear a marker just because it was read.
- Clear a marker without applying only when the user explicitly asks.
- Delete the
-
Verify.
npm run buildbuildvalidates structure and renders the full output. When iterating fast on the inner steps:node engine/cli.mjs validate . # structural checks only, no render node engine/cli.mjs export . # rewrite document.json only, no Vite bundle
Completion Report
Report:
- which comment ids were resolved,
- which files changed,
- which comments remain because they were ambiguous or failed,
- which verification commands ran and whether they passed.
Common Mistakes
- Do not edit
public/openpress/,dist-react/,.deploy/, or.openpress/. The separateopenpress-collaborateworkflow alone owns.openpress/review/current.json. - Do not remove unresolved comments.
- Do not rewrite broad sections unless the comment explicitly asks for that.
- Do not claim the browser changed until the source has been exported when export is required.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/quan0715/open-press/openpress-apply-comments">View openpress-apply-comments on skillZs</a>