Name: vault-canonical-promotion
Author: zhu8233

Imported from zhu8233/agents-knowledge-db (skills/vault-canonical-promotion/SKILL.md). Install upstream with npx skills add zhu8233/agents-knowledge-db --skill vault-canonical-promotion. Copyright stays with the author.

Vault Canonical Promotion

Overview

This skill exists to stop agents from publishing working notes as official knowledge too early. It routes durable material through a promotion process instead of silent direct edits.

If your agent supports MCP, 优先 use the governance MCP server for proposal, queue, review, and apply operations. Use this skill as the compatibility layer when MCP is unavailable.

Promotion Conditions

The candidate should have:

a resolved topic_id
valid source lineage
curation-level stability
long-term reuse value
a clear home in canonical knowledge

Read references/promotion-criteria.md before promoting.

Standard Flow

Confirm the source note lives in intake or curation
Check whether canonical already exists for the topic
If canonical exists and you are not Hermes/human, prepare a proposal instead of overwriting
Add or update promotion-queue.json
Add ledger entry
Leave final merge to Hermes or a human

Allowed Actions

create promotion candidate
update queue item
prepare proposal note
recommend canonical target path

Disallowed Actions

silent overwrite of canonical notes
reclassifying raw notes as canonical without curation
skipping queue update

Common Mistakes

treating polished wording as proof of canonical readiness
publishing without checking for existing canonical home
forgetting to record why this note deserves promotion

Install vault-canonical-promotion and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "zhu8233-agents-knowledge-db-vault-canonical-promotion", "kind": "skill", "name": "vault-canonical-promotion", "description": "Use when curated vault material may need to become stable canonical knowledge, or when an agent wants to update an existing canonical note without direct authority. Applies when promotion criteria, proposal files, registry updates, and merge safety matter.", "publisher": "zhu8233", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use when curated vault material may need to become stable canonical knowledge, or when an agent wants to update an existing canonical note without direct authority. Applies when promotion criteria, proposal files, registry updates, and merge safety matter." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/zhu8233/agents-knowledge-db", "path": "skills/vault-canonical-promotion/SKILL.md", "ref": "46b8cb353244b00168bdd17caf047f8a5320a9c8", "url": "https://github.com/zhu8233/agents-knowledge-db/blob/46b8cb353244b00168bdd17caf047f8a5320a9c8/skills/vault-canonical-promotion/SKILL.md", "key": "zhu8233/agents-knowledge-db/skills/vault-canonical-promotion/SKILL.md" } }, "instructions": "# Vault Canonical Promotion\n\n## Overview\n\nThis skill exists to stop agents from publishing working notes as official knowledge too early. It routes durable material through a promotion process instead of silent direct edits.\n\nIf your agent supports MCP, 优先 use the governance MCP server for proposal, queue, review, and apply operations.\nUse this skill as the compatibility layer when MCP is unavailable.\n\n## Promotion Conditions\n\nThe candidate should have:\n\n- a resolved `topic_id`\n- valid source lineage\n- curation-level stability\n- long-term reuse value\n- a clear home in canonical knowledge\n\nRead", "cost": { "context_tokens": 362 } }

vault-canonical-promotion

About