Agent skill · yonatangross
review-artifact-comments
Works through review comments in a plan or research artifact: replies, resolves, hands off to iterate-plan or iterate-research, approves when none are open. Use when an artifact file has reviewer comments.
What it needs
About 2k tokens when loaded.
What this skill does
review-artifact-comments Comments live inside the artifact, in the block at its end (format: the create-plan skill's references/artifact-layout.md). A reviewer adds one with the script or types it into the block by hand; both are read the same way. Nothing here deletes a comment. Steps 1. Pick the artifact. Use the file given. Otherwise list the task directory and ask which one: 2. Read the artifact in full, then its open comments: 3. Ask how to proceed unless the user already said (AskUserQuestion), for example: revise the artifact from the comments (hand off to /ork:iterate-plan or /ork:iterate-research) revise and resolve the comments it settles investigate the comments and reply with findings, no revision 4. Work one comment at a time. Check the claim in the code before answering. Reply with what you found or changed: Resolve only when told to, or when the reply records a fix already made. 5. Approve only for the reviewer, never for the author. The approver is the reviewing seat, and --ref names the LAND message or comment id the approval rests on. The script refuses while a comment is open or when --by is the artifact's author (exit 1), and without --by or --ref (exit 2): An approved artifact with no open comment is the "phase done" signal other tools read. Adding a comment as a reviewer Rules Never resolve or approve on your own initiative; those are the reviewer's calls. Never edit the comment block with Write or Edit.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills yonatangross/review-artifact-comments--f47ff6