菜单
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.
用 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.
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.
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-edit |
| description | 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. |
Revise an existing entry in place, keeping its voice and its frontmatter intact. colophon locates the entry and supplies the voice; you do the editing.
The user wants to change an existing post in a colophon project (not create a new one).
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.
Find the entry. List entries to get the source file and metadata:
colophon posts # slug, title, type, author, persona, tags
colophon posts --author <a> --tag <t> # narrow it
Match the user's description to a row; the file is under the source's directory (see
colophon sources). Read the file.
Re-load the voice so edits sound consistent with the rest of the post:
colophon persona context <persona-from-frontmatter> --topic "<the post's subject>"
If the post has no persona:, infer the voice from the post itself and similar posts.
Edit the file in place. Preserve:
slug: (pinned — changing it breaks the URL; use aliases: for intentional moves),author:, date:),[[wikilinks]].Preview the change.
colophon serve --open=<slug> # opens that post; or --open=latest
colophon isn't installed, surface the install command and ask — never install it silently.hero_alt:/image_alt: for banners), and a logical heading order — fix these if you
touch a section that violates them.colophon-metadata.