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

82%

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

67%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, genuinely actionable skill body with proper one-level-deep bundle references, a clear step sequence, and strong validation gates. Its main weaknesses are systematic verbatim repetition of the opaque-ref and authorization-gate language (token waste) and reliance on paths outside the bundle for shared contracts.

Suggestions

Define the opaque-ref set (creator_ref, brand_ref, page_ref, ...) once in the Skill Contract and refer back to it ('the opaque refs defined above') instead of repeating the full list in the Handoff Summary, Instructions steps 1/2/4, and the Example — this alone would cut roughly 15-20% of the body.

State the exact-authorization rule once (e.g., in the Skill Contract's Writes bullet) and trim the repeated 'saving never authorizes delivery / separate exact send gate' caveats from the Example and Instructions step 5, keeping one pointer to outreach-manager's gate.

Move the cross-skill chain machinery (visited-set, max-depth 3 termination note) into the shared skill-contract.md reference so the body stays focused on brief generation, and verify that ../../../references/skill-contract.md, ../../../CONNECTORS.md, and sibling SKILL.md paths resolve from wherever the bundle is installed.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows, but the opaque-ref list ("creator_ref, brand_ref, page_ref, shipping_ref, contact_ref, brand_asset_ref, hashtag_ref, promo_code_ref...") and the exact-authorization/send-gate caveats are repeated nearly verbatim in Skill Contract, Handoff Summary, Instructions steps 1/2/4, and the Example — a clear tighten-to-anchor-3 case ("mostly efficient but... could be tightened"). Not 2 because there is no concept padding or fluff, and not 4 because the duplication is systematic rather than a few minor instances.

3 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: quoted invocation patterns ("Generate a TikTok brief for micro-influencers promoting [product], 1 review video..."), a worked Example with the expected output behavior, and specific mechanics like "Mark unresolved wording [needs source]" and "operation: propose" — matching anchor 4's mostly-executable-with-minor-gaps. Not 5 because the actual drafting guidance (master template, key-message phrasing) is delegated to reference files and inline guidance leans toward process governance over brief-writing specifics.

4 / 5

Workflow Clarity

A clear 5-step sequence (gather → generate → vary → save/route → prepare delivery) with explicit checkpoints: a "Done when" checklist, unresolved-placeholder blocking, and the claims dependency tuple. Not 5 because several checkpoints defer to external machinery (outreach-manager's gate, registry proposals) rather than including an inline validate-and-recover loop, leaving minor validation gaps per anchor 4.

4 / 5

Progressive Disclosure

Good structure against the actual bundle: the 106-line overview defers the 467-line template/variation material to the real references/brief-templates.md (its "#brief-variations-by-content-type" anchor exists) and creator-voice-intake.md, both one level deep and well-annotated in Reference Materials. Not 5 because multiple referenced paths (../../../references/skill-contract.md, ../../../CONNECTORS.md, sibling SKILL.md links) do not resolve within this bundle, leaving navigation gaps.

4 / 5

Total

15

/

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 description: explicit trigger phrases in the user's own words, a concrete enumeration of the artifact's contents, third-person voice, and an explicit negative boundary to the closest sibling skill. The only minor limitation is that it describes one producing action with its output components rather than a list of distinct operations.

DimensionReasoningScore

Specificity

"produces a structured creator brief with deliverables, key messages, creative direction, timeline, disclosure rules, and compensation terms" names the domain and comprehensively enumerates the output's concrete components, but describes a single core action rather than several distinct actions, matching anchor 4 ("lists several specific actions; minor gaps") better than anchor 5's multiple distinct actions.

4 / 5

Completeness

Explicitly answers both questions: what ("produces a structured creator brief with deliverables, key messages, creative direction, timeline, disclosure rules, and compensation terms") and when ("Use when the user asks to 'create an influencer brief' or 'write a campaign brief'") with concrete trigger phrases, exactly matching the anchor-5 example pattern. A cap of 3 does not apply since the 'Use when...' clause is present and explicit.

5 / 5

Trigger Term Quality

Includes quoted natural phrases users would actually say — "create an influencer brief", "write a campaign brief" — plus the core nouns (influencer/campaign/creator brief) and bilingual synonyms ("达人合作简报/创作者BF"), giving comprehensive natural-term coverage with synonyms as in anchor 5. Not 4 because no common variation a user would plausibly say is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (creator/campaign briefs) with distinct triggers and an explicit disambiguation boundary — "Not for choosing how to split spend across creators — use budget-optimizer" — keeping conflict risk minimal as in anchor 5. It is not anchor 4 because it does not merely reduce overlap; it actively routes the nearest competing use case elsewhere.

5 / 5

Total

19

/

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.