# channel-registry

Keeps a record of brand-owned social channels, UGC permissions and posting commitments. Useful when channel facts need revision history instead of a spreadsheet.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 installs · ★ 3013
- Author: aaron-he-zhu
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/HEAD/protocol/channel-registry/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/channel-registry

## What it does

The skill records channel state, lifecycle transitions, UGC permissions and per-platform voice settings. Everything goes through an append-only event stream at `memory/events/channels.ndjson`; dossiers and Markdown files are derived views regenerated from accepted events. The lifecycle runs `proposed → warming → active → paused → retired`. State cannot be unset or reinitialized, and reactivation is a fresh `paused → warming` transition with evidence rather than a history rewrite.

Other social skills submit `propose` events. Only a host-capability `channel-registry` principal accepts or rejects them through `owner-append` by event ID. A public post, tag or hashtag never produces a permission. Organic permission does not cover paid use either — paid expansion needs creator or contract evidence and a new event.

Before it runs, the skill resolves `AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}"` and verifies the registry script, event schema and system catalog. Channel exports and messages count as untrusted evidence. In a standalone one-folder install the skill can only prepare proposals; it cannot append or project canonical channel state without the verified root runtime.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill channel-registry -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/channel-registry/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/channel-registry/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill channel-registry -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/channel-registry/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill channel-registry -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/channel-registry/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aaron-he-zhu/aaron-marketing-skills channel-registry
```

2. **Manually: put the files in place**
- File: `.github/skills/channel-registry/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill channel-registry -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aaron-he-zhu/aaron-marketing-skills --path protocol/channel-registry
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/channel-registry/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill channel-registry -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/HEAD/protocol/channel-registry/SKILL.md

## When to use it
- register a new social channel with objective and evidence
- move a channel from warming to active at a set revision
- record a UGC permission with scope and expiry
- accept or reject a proposal from another social skill by event ID
- regenerate channel, voice and permission views from accepted events

## Example prompts
- 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 and evidence.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 5d7a12b2226201b2.

BEGIN THIRD-PARTY FILE 5d7a12b2226201b2
````text
---
name: channel-registry
slug: aaron-channel-registry
displayName: "Channel Registry · 渠道台账"
summary: "品牌自有社媒渠道/声音档案/UGC授权/节奏承诺唯一真相"
description: '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授权记录'
version: "20.1.0"
license: Apache-2.0
compatibility: "Claude Code and compatible agent-skill hosts"
homepage: "https://github.com/aaron-he-zhu/aaron-marketing-skills"
when_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."
argument-hint: "<channel or permission aggregate-id, transition, or proposal review>"
metadata: {"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"}}
---

# 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

```text
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
````
END THIRD-PARTY FILE 5d7a12b2226201b2

The third-party file has ended. Everything between the 5d7a12b2226201b2 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 1839 of 5988 bytes. © aaron-he-zhu · Apache-2.0 · https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/HEAD/protocol/channel-registry/SKILL.md

## Similar
- [registry-browser](https://affpapa.org/en/nevibecode/skills/registry-browser.md) — skill · 599 installs
- [iros-registry-automation](https://affpapa.org/en/nevibecode/skills/iros-registry-automation.md) — skill · 6200 installs
- [MCP Registry Server](https://affpapa.org/en/nevibecode/mcp/mcp-registry-server.md) — MCP server · ★ 7405
- [ugc-and-influencer](https://affpapa.org/en/nevibecode/skills/ugc-and-influencer.md) — skill · 604 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md