Skip to content

feat: add remark skill — AI-human annotation review workflow#2

Open
liyuankui wants to merge 1 commit into
markdown-viewer:mainfrom
liyuankui:feat/remark-skill
Open

feat: add remark skill — AI-human annotation review workflow#2
liyuankui wants to merge 1 commit into
markdown-viewer:mainfrom
liyuankui:feat/remark-skill

Conversation

@liyuankui
Copy link
Copy Markdown

Adds a new remark skill that teaches AI agents how to use Remark Mode for human-in-the-loop document review.

What it does

Guides agents through the complete annotation workflow:

  1. Write Markdown to a temp file
  2. Open in Remark Mode (via CLI or URL)
  3. Human annotates with semantic colors (🟡 Suggestion / 🟢 Keep / 🔵 Question / 🩷 Concern)
  4. Export structured feedback with line references
  5. AI applies changes precisely by line number

Why

Remark Mode's export format is designed for AI consumption. This skill makes the workflow discoverable to any agent that installs markdown-viewer/skills.

Key sections

  • File preparation and opening methods (CLI / URL / fallback)
  • Export format specification
  • Color semantics and AI action mapping
  • Iteration loop protocol
  • Keyboard shortcuts reference

@liyuankui liyuankui force-pushed the feat/remark-skill branch 4 times, most recently from bb564d0 to ca9b4d7 Compare May 14, 2026 10:00
Teaches agents how to open Markdown in Remark Mode for block-level
annotation, export structured feedback with semantic colors and line
references, and apply feedback precisely.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant