channel-portfolio-planner

Use when the user asks to "pick which social channels to run", "should we be on X platform or 小红书", or "plan our organic social channel portfolio"; produces an audience/objective-first portfolio with capability/access matrix, cadence-budget reality check, declared ECHO operating profile, boundary routing, and proposed-state registry events. Not for recording canonical channel facts — use channel-registry. 社媒渠道选择/渠道组合规划/平台能力矩阵/自然社媒

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured instruction skill with an actionable contract, a gated 8-step workflow, and clean one-level reference navigation. The main improvement opportunity is reducing the repeated scope-guard/boundary language that recurs across sections.

Suggestions

State the scope guard / 'does not own canonical facts' boundary once in the Scope guard section and reference it from later sections instead of restating it in Data Sources, Instructions, and Save Results.

Consolidate the ECHO and registry-event reminders so each appears in one authoritative location rather than being repeated across the Instructions and Save Results sections.

Dimension	Reasoning	Score
Conciseness	The body is dense and assumes Claude's competence without explaining basics, but the scope/boundary refrain ('not for canonical facts', 'never write dossiers') recurs across the Scope guard, Instructions, and Save Results sections and could be trimmed.	4 / 5
Actionability	Names exact executable artifacts — `registry-events.py`, `scripts/connectors/pageviews.py` and `hn.py`, paths like `memory/events/channels.ndjson`, concrete matrix columns (publish/comments/DMs/insights) and tiers (primary/secondary/watch) — giving fully actionable guidance for an instruction-only skill.	5 / 5
Workflow Clarity	Eight clearly sequenced numbered steps with explicit validation gates (NEEDS_INPUT stop-and-route when audience evidence is absent, cadence-budget fit check, a 'Done when' contract, and termination rules), which matches the anchor for clear sequence plus feedback/error routing.	5 / 5
Progressive Disclosure	The SKILL.md is an overview that points to well-signaled, one-level-deep references (skill-contract.md, echo-benchmark.md, social-platform-access.md, CONNECTORS.md, SECURITY.md) each with a one-line purpose, with no nested reference chains.	5 / 5
	Total	19 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description with concrete trigger phrases, a clear what/when pair, and an explicit boundary clause against the sibling channel-registry skill. The only minor gap is that outputs are named as deliverables rather than sharp action verbs.

Dimension	Reasoning	Score
Specificity	Names the domain and lists several concrete deliverables ('capability/access matrix, cadence-budget reality check, declared ECHO operating profile, boundary routing, and proposed-state registry events'), but these are deliverable nouns rather than the crisp verb-driven actions of the anchor-5 example, so it sits just below the top.	4 / 5
Completeness	Explicitly answers both 'what' (produces an audience/objective-first portfolio with the listed components) and 'when' (concrete 'Use when...' trigger phrases), with an added 'Not for...' boundary clause.	5 / 5
Trigger Term Quality	Quoted natural phrases users would actually say ('pick which social channels to run', 'should we be on X platform or 小红书', 'plan our organic social channel portfolio') plus synonym/Chinese keyword coverage match the comprehensive anchor.	5 / 5
Distinctiveness Conflict Risk	Clear niche (organic social channel portfolio planning) with an explicit disambiguation ('Not for recording canonical channel facts — use channel-registry') minimizing overlap with adjacent skills.	5 / 5
	Total	19 / 20 Passed

Validation

75%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 27 suspicious	Warning
referenced_paths_exist	Referenced path issues: 5 missing, 4 deeper-than-1-level	Warning

	Total	12 / 16 Passed

Repository: aaron-he-zhu/aaron-marketing-skills
Path: social/explore/channel-portfolio-planner/SKILL.md
Commit: 9df28a0

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.