Agents

onmax's agent skill collects every package in one place: which block to use, its syntax, and how to check the result. Install it, or copy the command from the For agents button on any package's page:

npx skills add onmax/comark-ui

This site serves it too, so npx skills add https://comark-ui.onmax.me installs the same skill.

An app that renders these documents for its own agents, like Drop, can ship this skill instead of writing one. comark-ui includes it, so the app copies it at build time and its agents always read the syntax of the plugins it installed:

import { cp } from "node:fs/promises";
import { dirname } from "node:path";
import { fileURLToPath } from "node:url";

const skill = dirname(fileURLToPath(import.meta.resolve("comark-ui/skills/comark-ui/SKILL.md")));
await cp(skill, "skills/comark-ui", { recursive: true });

Keep the folder whole, since SKILL.md links each reference by its path. If your agents only write Markdown, cut each reference at its ## Register heading, which always comes last.

An agent should check a document before it hands it over. comark-linter lists every problem, each with its line:

npx lint-comark duck-audit.md

Marks also need a look, because a box can sit inside the image and still miss its target. comark-annotate render writes a standalone page next to the file. The agent opens it in a browser and takes a screenshot to confirm each mark sits on its target:

npx comark-annotate render duck-audit.md -o duck-audit.html

Agents often write these documents as evidence on a pull request. A review document shows one put together from several plugins. Sharing a review shows how the agent publishes it to Drop, where reviewers comment on the exact spot and the agent reads their comments.