菜单
Add cross-references between colophon posts — wikilinks and "related posts" — so entries connect to each other. Use when the user asks to link posts together, add related/see-also links, or wire up internal references on their colophon blog.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Review a colophon site's received webmentions for spam/abuse and distill the bad ones into small, general glob rules in the committed blocklist (.colophon/webmention-block.yml), so moderation survives the cache's full regenerate. Use when the user asks to moderate, clean up, or block webmention spam/replies.
Fill or improve a colophon post's metadata — the description, the seo: block (title/description/keywords/social), tags reusing the site's existing vocabulary, and (rarely) a glossary entry for genuinely obscure jargon. Use when the user asks to add SEO, a summary/description, social copy, tags, or a glossary definition to a post.
Write a new blog post (or page) for a colophon site in a chosen author's byline and persona's voice. Use when the user asks to draft, write, or create a new post/article/entry for their colophon blog. colophon supplies the voice context and scaffolds the file; you write the prose.
Revise an existing colophon blog post — retitle, expand a section, tighten, or fix — while preserving the author's voice and the frontmatter contract. Use when the user asks to edit, rewrite, expand, shorten, or fix an existing post on their colophon site.
Preview, validate, and publish a colophon site — run doctor, build, serve a local preview, and deploy to the configured publishers. Use when the user asks to preview, build, check, deploy, or publish their colophon blog.
| name | colophon-crosslink |
| description | Add cross-references between colophon posts — wikilinks and "related posts" — so entries connect to each other. Use when the user asks to link posts together, add related/see-also links, or wire up internal references on their colophon blog. |
colophon resolves [[wikilinks]] across every source at build time (an unresolved link
degrades to plain text). Use them to connect posts instead of inventing URLs.
The user wants to add internal links / related-post references between existing entries.
This skill drives the colophon CLI. Before the first command, confirm it's installed:
command -v colophon || echo "colophon not found"
If it's missing, stop and offer the install — don't install it silently:
go install github.com/jmylchreest/colophon/cmd/colophon@latest (or a release binary). Proceed
only once it's on PATH.
List the candidate targets (and their tags, to find relevant ones):
colophon posts --json # every entry: slug, title, tags, type
colophon posts --tag <topic> # entries on a related topic
Pick genuinely related entries — overlapping tags or subject matter, not every post. Prefer 2–5 strong links over a dump.
Add the links in the source file(s):
… as covered in [[Raft leader election]] …
(link by the target's title or slug; [[title|custom text]] sets the anchor text).## Related
- [[Raft leader election]]
- [[Designing for partition tolerance]]
Verify they resolve. Rebuild and check none fell back to plain text:
colophon serve --open=<slug>
An unresolved [[link]] means the target title/slug didn't match — fix the reference.
colophon isn't installed, surface the install command and ask — never install it silently.colophon posts). Don't invent targets.