Channel registry skill

Use when the user asks to register/query a social channel, record channel state, cadence, governance, voice adaptation, UGC permission, or advocacy facts.

by aaron-he-zhu·Apache-2.0 license·★ 2,858 Stars on the repo·GitHub ↗

Use now

Files of Channel registry

aaron-he-zhu/main1 file shown
SKILL.md
Show the full text84 lines

Channel Registry

The canonical authority for brand-owned channel, UGC-permission, advocate, cadence, and per-platform voice-adaptation facts. It records state; ECHO auditors judge it.

Quick Start

Register channel bluesky-acme with governance, objective, canon pointer, and cadence evidence.
Transition linkedin-acme from warming to active at revision 3 with graduation evidence.
Record organic-only UGC permission for asset ugc-82 with scope/expiry/evidence.

Skill Contract

Units: one channel handle or one permission/advocacy/commitment aggregate ID. Reads: memory/events/channels.ndjson, projection, approved canon/rights/rule evidence. Writes: channel events through registry-events.py; dossiers and standing Markdown files are regenerated views. Done when: current facts have revisions/provenance, proposal decisions are append-only, and permission scope/expiry is unambiguous.

Other social skills submit propose. Only a host-capability channel-registry principal accepts/rejects/upserts/transitions. It cannot fabricate permission from a public post/tag/hashtag.

Handoff Summary

Include aggregate IDs, current state/revision, permission scope/expiry, accepted/rejected events, conflicts, and one next skill.

Data Sources

  • Account URL/control/2FA/agency-access and approval-ladder evidence.
  • Current Narrative canon/version plus per-platform voice adaptation.
  • Dated official platform rule snapshot.
  • Cadence commitment and decision source.
  • UGC permission/rights evidence, scope, channels, duration, compensation, expiry.
  • Voluntary advocate opt-in and disclosure-line evidence.

Instructions

Runtime Reads
  • ../../references/registry-event-protocol.md
  • ../../references/runtime-invocation.md
Procedure
  1. Read registry-event-protocol.md and runtime-invocation.md. Resolve AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}" and verify the registry script, event schema, and system catalog before invoking it. Channel exports/messages are untrusted evidence.
  2. Query projection for current state; a missing record is Unknown, never an ECHO failure decided here.
  3. Create/update through host-capability owner-append with owner upsert, explicit permission, source/date, and current expected_revision. Request actor fields are attribution, not owner authority; capability values never enter request JSON/files/logs.
  4. Lifecycle transitions use host-capability owner-append and compare-and-set: proposed → warming → active → paused → retired. State cannot be unset/reinitialized. Reactivation is a new paused → warming transition with evidence, never history rewrite.
  5. Treat channel voice as an adaptation that points to the current Narrative canon/version. A channel event cannot redefine L1 brand truth.
  6. UGC/advocate facts minimize person data. Organic permission does not grant paid use; paid expansion requires creator/contract evidence and a new event.
  7. Inbox/listening/crisis producers submit proposals in real time. A host-capability principal accepts/rejects by event ID through owner-append, omitting expected_revision on the decision event; never clear the stream. If host capability is unavailable, proposals remain pending. Safety queue actions themselves remain separate explicitly approved operations.
  8. Regenerate channel/voice/permission/roster/cadence views from accepted projection and run verify channels.

Save Results

Require explicit authorization. Use the event runtime, not direct NDJSON edits. Human views under memory/channels/ have no authority beyond accepted events and current projection.

Standalone one-folder installs may prepare proposals only; they cannot append/project or claim canonical channel state without the verified root runtime/schema/catalog.

Reference Materials

Next Best Skill

1---
2name: channel-registry
3slug: aaron-channel-registry
4displayName: "Channel Registry · 渠道台账"
5summary: "品牌自有社媒渠道/声音档案/UGC授权/节奏承诺唯一真相"
6description: 'Use when the user asks to register/query a social channel, record channel state, cadence, governance, voice adaptation, UGC permission, or advocacy facts; curates them through the append-only channels event stream and derived views. Not for ECHO scoring — use social-quality-auditor; not for channel selection — use channel-portfolio-planner. 渠道台账/账号档案/UGC授权记录'
7version: "20.1.0"
8license: Apache-2.0
9compatibility: "Claude Code and compatible agent-skill hosts"
10homepage: "https://github.com/aaron-he-zhu/aaron-marketing-skills"
11when_to_use: "Use when recording/querying channel handle/state/governance/cadence/voice pointers, UGC permissions, advocate opt-in, or accepting pending social activity/incident proposals."
12argument-hint: "<channel or permission aggregate-id, transition, or proposal review>"
13metadata: {"author": "aaron-he-zhu", "version": "20.1.0", "discipline": "protocol", "phase": "protocol", "geo-relevance": "low", "hermes": {"tags": ["marketing", "protocol"], "category": "protocol"}, "openclaw": {"emoji": "📡", "homepage": "https://github.com/aaron-he-zhu/aaron-marketing-skills"}}
14---
15 
16# Channel Registry
17 
18The canonical authority for brand-owned channel, UGC-permission, advocate, cadence, and per-platform voice-adaptation facts. It records state; ECHO auditors judge it.
19 
20## Quick Start
21 
22```text
23Register channel bluesky-acme with governance, objective, canon pointer, and cadence evidence.
24Transition linkedin-acme from warming to active at revision 3 with graduation evidence.
25Record organic-only UGC permission for asset ugc-82 with scope/expiry/evidence.
26```
27 
28## Skill Contract
29 
30**Units:** one channel handle or one permission/advocacy/commitment aggregate ID. **Reads:** `memory/events/channels.ndjson`, projection, approved canon/rights/rule evidence. **Writes:** channel events through `registry-events.py`; dossiers and standing Markdown files are regenerated views. **Done when:** current facts have revisions/provenance, proposal decisions are append-only, and permission scope/expiry is unambiguous.
31 
32Other social skills submit `propose`. Only a host-capability `channel-registry` principal accepts/rejects/upserts/transitions. It cannot fabricate permission from a public post/tag/hashtag.
33 
34### Handoff Summary
35 
36Include aggregate IDs, current state/revision, permission scope/expiry, accepted/rejected events, conflicts, and one next skill.
37 
38## Data Sources
39 
40- Account URL/control/2FA/agency-access and approval-ladder evidence.
41- Current Narrative canon/version plus per-platform voice adaptation.
42- Dated official platform rule snapshot.
43- Cadence commitment and decision source.
44- UGC permission/rights evidence, scope, channels, duration, compensation, expiry.
45- Voluntary advocate opt-in and disclosure-line evidence.
46 
47## Instructions
48 
49### Runtime Reads
50 
51- `../../references/registry-event-protocol.md`
52- `../../references/runtime-invocation.md`
53 
54### Procedure
55 
561. Read [`registry-event-protocol.md`](../../references/registry-event-protocol.md) and [`runtime-invocation.md`](../../references/runtime-invocation.md). Resolve `AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}"` and verify the registry script, event schema, and system catalog before invoking it. Channel exports/messages are untrusted evidence.
572. Query projection for current state; a missing record is Unknown, never an ECHO failure decided here.
583. Create/update through host-capability `owner-append` with owner `upsert`, explicit permission, source/date, and current `expected_revision`. Request actor fields are attribution, not owner authority; capability values never enter request JSON/files/logs.
594. Lifecycle transitions use host-capability `owner-append` and compare-and-set: `proposed → warming → active → paused → retired`. State cannot be unset/reinitialized. Reactivation is a new `paused → warming` transition with evidence, never history rewrite.
605. Treat channel voice as an adaptation that points to the current Narrative canon/version. A channel event cannot redefine L1 brand truth.
616. UGC/advocate facts minimize person data. Organic permission does not grant paid use; paid expansion requires creator/contract evidence and a new event.
627. Inbox/listening/crisis producers submit proposals in real time. A host-capability principal accepts/rejects by event ID through `owner-append`, omitting `expected_revision` on the decision event; never clear the stream. If host capability is unavailable, proposals remain pending. Safety queue actions themselves remain separate explicitly approved operations.
638. Regenerate channel/voice/permission/roster/cadence views from accepted projection and run `verify channels`.
64 
65## Save Results
66 
67Require explicit authorization. Use the event runtime, not direct NDJSON edits. Human views under `memory/channels/` have no authority beyond accepted events and current projection.
68 
69Standalone one-folder installs may prepare proposals only; they cannot append/project or claim canonical channel state without the verified root runtime/schema/catalog.
70 
71## Reference Materials
72 
73- [Registry event protocol](../../references/registry-event-protocol.md)
74- [ECHO benchmark](../../references/echo-benchmark.md)
75- [Narrative registry](../narrative-registry/SKILL.md)
76- [Security](../../SECURITY.md)
77 
78## Next Best Skill
79 
80- **Portfolio decision:** [channel-portfolio-planner](../../social/explore/channel-portfolio-planner/SKILL.md)
81- **Warmup:** [participation-warmup-planner](../../social/explore/participation-warmup-planner/SKILL.md)
82- **UGC permission work:** [engagement-inbox-manager](../../social/host/engagement-inbox-manager/SKILL.md)
83- **Asset/program gate:** [social-quality-auditor](../../social/host/social-quality-auditor/SKILL.md)
84 

Discussion