Agent skill for Markdown review
Give Claude Code and Codex a human review gate.
Imark ships an agent skill for Claude Code and Codex. Your coding agent opens its Markdown plan in the Mac app and waits while you read, comment on exact phrases, and choose Approve or Request Changes.
macOS 14+ · 5.8 MB
Updated
What the Imark agent bundle includes
The agent files cover both sides of the workflow: understanding comments already stored in Markdown and starting a new review in the Imark app.
Imark comments skill
Teaches Claude Code and Codex how to read anchored notes, handle orphaned anchors, and mark completed notes as resolved.
imark-review command
Opens a Markdown document in Imark and waits for your explicit decision instead of continuing in the background.
Structured review output
Returns the decision, quoted anchor, note, author, time, section, and nearby context to the agent.
A review gate before autonomous coding
Ask Claude Code or Codex to write the implementation plan first, then open it with the Imark review workflow. The agent pauses while you check the scope, UX, architecture, risks, tests, and completion criteria. It continues only after you approve the plan or address the requested changes.
Comments stay readable to people and agents
Imark stores each note as a structured HTML comment beside its quoted phrase. Normal Markdown renderers hide the note, Git keeps it with the document, and the skill gives the agent the exact context it needs without a separate review service.
Designed for plans, specifications, and RFCs
Use the skill for Markdown documents that need a human decision before work begins. Imark is not a source-code review tool; GitHub and your editor remain the right places to review code changes.
Local, blocking, and explicit
The review happens on the file itself. No plan is uploaded, no browser review server is required, and the command waits as long as you need. Approve when the document is ready, or request changes and let the agent work through every active note.
Questions
What people want to know.
Does the Imark skill work with Claude Code?
Yes. The agent bundle includes instructions and an imark-review command designed for a blocking Claude Code review workflow.
Does the Imark skill work with Codex?
Yes. Codex can use the Imark comments skill to read structured notes and follow the same plan-review workflow.
Does the skill send my Markdown to a server?
No. Imark opens the local file in the Mac app, and the notes remain inside that file as HTML comments.
What happens after I request changes?
The command returns your decision and active notes. The agent addresses each request, reports what changed, marks completed notes as resolved, and can open another review round.
Keep exploring Imark
Markdown comments
Annotate Markdown Files with Inline Comments
Select a phrase, add a comment, and keep the note inside the Markdown file. Imark annotations travel with the document without a cloud service.
Read the guideTechnical Markdown
Markdown Viewer with Mermaid and KaTeX for Mac
Read Markdown with Mermaid diagrams, KaTeX maths, syntax-highlighted code, tables, and local images in a private offline Mac app.
Read the guideOpen .md files on Mac
How to Open Markdown Files on Mac
Open .md files on Mac as rendered documents. Compare TextEdit, editor previews, Quick Look, and a dedicated Markdown viewer such as Imark.
Read the guideRead Markdown like a document.
Download Imark for a focused Markdown viewer built for Mac, Finder, and local files.
Download for macOS