CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brief-generator

Use when the user asks to "create an influencer brief" or "write a campaign brief"; produces a structured creator brief with deliverables, key messages, creative direction, timeline, disclosure rules, and compensation terms. Not for choosing how to split spend across creators — use budget-optimizer. 达人合作简报/创作者BF

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

73%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.

The body delivers a clear, well-validated workflow — numbered steps, an explicit completion checklist, and authorization gates for every risky action — with heavy detail correctly split into a 467-line bundled reference file. Its weaknesses are token efficiency (the nine-ref inventory repeated verbatim three times, plus motivational filler) and reliance on family-wide conventions (HOT, WARM, registry-events.py) that are not defined in the bundled files, plus one dangling/mislabeled reference.

Suggestions

Define the opaque-ref set (creator_ref through voice_source_ref) once — e.g. in the Skill Contract — and refer to it elsewhere instead of enumerating all nine refs verbatim in Reads, Writes, and the Handoff Summary.

Delete the motivational opener "Good briefs lead to better content, fewer revisions, and stronger partnerships" and similarly compress the Data Sources prose, which restates connector behavior already covered by the reference links.

Fix the STAR-benchmark reference: the link text says references/star-benchmark.md but the target is ../../../references/star-benchmark.md, which does not exist in the bundle — either bundle the file or correct the path/label so navigation is unambiguous.

DimensionReasoningScore

Conciseness

The nine opaque refs (creator_ref, brand_ref, page_ref, shipping_ref, contact_ref, brand_asset_ref, hashtag_ref, promo_code_ref, voice_source_ref) are enumerated verbatim three times (Reads, Writes, Handoff Summary), and the intro line "Good briefs lead to better content, fewer revisions, and stronger partnerships" is motivational filler. Mostly efficient but noticeably tightenable, fitting the level-3 anchor better than level 4 where over-explanation would be only minor.

3 / 5

Actionability

Concrete, executable guidance throughout: numbered steps, exact save path pattern (memory/influencer/brief-generator/YYYY-MM-DD-<topic>.md), the '[needs source]' marker, and a worked Example with input and expected output. Falls short of level 5 because key operations lean on family conventions never defined in this bundle (HOT, WARM, "registry-events.py operation: propose", "named offsets" in projections), leaving minor execution gaps from this file alone.

4 / 5

Workflow Clarity

Clear five-step sequence (gather → generate → vary → save/route → delivery prep) with an explicit "Done when" checklist, a feedback loop for unresolved claims (mark '[needs source]', block creator-ready status until resolved), and explicit authorization gates for saving and sending. This matches the anchor with explicit validation steps, checklists, and error-recovery loops.

5 / 5

Progressive Disclosure

Good structure against the actual bundle: the two real reference files (references/brief-templates.md, 467 lines; references/creator-voice-intake.md, 81 lines) are one level deep, well-signaled with purpose descriptions, and contain no nested references. Kept from level 5 by the mislabeled STAR-benchmark link (text says references/star-benchmark.md but the target is ../../../references/star-benchmark.md, absent from the bundle) and several out-of-bundle paths that cannot be navigated from this skill's files.

4 / 5

Total

16

/

20

Passed

Description

100%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.

The description is a model example: concrete 'what' with six enumerated components, an explicit 'Use when' clause with natural trigger phrases, bilingual synonyms, and an explicit boundary against the sibling budget-optimizer skill. Third-person voice and concise phrasing with no fluff.

DimensionReasoningScore

Specificity

"produces a structured creator brief with deliverables, key messages, creative direction, timeline, disclosure rules, and compensation terms" enumerates six concrete output components, matching the comprehensive-coverage anchor rather than the level-4 'several actions with minor gaps' anchor.

5 / 5

Completeness

Explicitly answers both questions: 'what' (structured creator brief with six named components) and 'when' ("Use when the user asks to..." with concrete trigger phrases). It also adds a negative boundary, exceeding the level-4 anchor whose 'when' is less explicit.

5 / 5

Trigger Term Quality

Quotes the exact natural phrases a user would say — "create an influencer brief", "write a campaign brief" — and adds bilingual synonyms ("达人合作简报/创作者BF"), covering the natural trigger vocabulary including variations. Only peripheral phrasings like 'draft a brief' are absent, which does not pull it below the comprehensive anchor.

5 / 5

Distinctiveness Conflict Risk

Clear niche (creator/campaign briefs) with distinct triggers and an explicit disambiguation clause — "Not for choosing how to split spend across creators — use budget-optimizer" — so conflict with adjacent marketing skills is actively prevented.

5 / 5

Total

20

/

20

Passed

Validation

75%

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

CriteriaDescriptionResult

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: 16 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

influencer/target/brief-generator/SKILL.md

Reviewed

Table of Contents

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.