CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brand-discovery

Run a structured, resumable multi-session brand identity interview across 8 modules (purpose, positioning, audience, personality, voice, narrative, founder tension) using laddering, 5 Whys, and projective techniques, persisting answers to disk and producing a master brandbook (90_SYNTHESIS.md). Use when creating or repositioning a brand, briefing designers or writers, or making implicit founder knowledge explicit.

70

Quality

88%

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

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

An unusually disciplined process skill: concrete interview scripts, a resumable state protocol with the terminal edge case handled, and anti-patterns that guard each failure mode. The weaknesses are the missing explicit link to the references/ templates and the absence of any write-verification/recovery loop for the checkpoint files.

Suggestions

In the Module sequence section, add one line pointing to the bundle: e.g. 'Use the template for each module from references/{moduleFile}' — the table already lists the exact filenames, so this closes the navigation gap.

Add a read-back verification step to the State write protocol (e.g. re-read state.json after writing and re-initialize on parse failure) so a corrupt checkpoint does not silently break session resumption.

Tighten the terminal-module paragraph in State write protocol and the rationale clauses in Anti-Patterns to their imperative cores — the instructions are already enforceable without the justifications.

DimensionReasoningScore

Conciseness

The body is overwhelmingly imperative rules and protocols with no concept-explanation padding — nothing explains what branding is or why interviews matter in the abstract. Minor over-explanation remains: the terminal-module paragraph ('leaving it populated would cause a future resumption to treat the completed brandbook as still in progress') and the rationale clauses in Anti-Patterns could be trimmed. Not 5 because a few justifications and the duplicated Raw/Synthesis structure spec cost tokens without adding instruction.

4 / 5

Actionability

Guidance is fully concrete and copy-paste ready: verbatim probes ('If the brand were a person, how would they walk into a room?'), an exact state.json schema, exact file paths (modules/{moduleFile}, founders/{participant}.md), and scripted confirmations ('Module X saved. State updated. Next: Y.'). For an instruction-only skill this is the top anchor — no vague direction anywhere.

5 / 5

Workflow Clarity

The sequence is explicit and well-ordered: a numbered session-start protocol that checks for prior progress, an ordered module table, a state checkpoint after every module, saturation signals as decision criteria, and input validation (participant names, moduleFile enumeration, outputPath traversal). Anchor 4 fits because there is a minor validation gap — writes are confirmed to the user but never verified (no read-back of state.json or module files, no recovery step for a corrupt or partially written checkpoint). Not 5 because that error-recovery loop is absent; not 3 because checkpoints and validation are otherwise explicit.

4 / 5

Progressive Disclosure

The bundle is one level deep (references/ with 8 module template files) and the module-sequence table lists the exact filenames, so navigation is easy and no template detail is wrongly inlined. The gap is that the body never states these templates live in references/ — the filename match is implied rather than signaled, risking Claude writing module files from scratch. Not 5 because that explicit pointer is missing; not 3 because the file listing and one-level structure are otherwise clear.

4 / 5

Total

17

/

20

Passed

Description

88%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: concrete, third-person, with explicit what and when clauses and named techniques that make the skill's behavior legible. The only refinements are broader trigger synonyms and sharpening the boundary against single-purpose voice/brandbook skills.

DimensionReasoningScore

Specificity

Multiple concrete actions are named: 'Run a structured, resumable multi-session brand identity interview across 8 modules', 'using laddering, 5 Whys, and projective techniques, persisting answers to disk and producing a master brandbook (90_SYNTHESIS.md)'. Coverage spans method, persistence, and output, matching the 'comprehensive coverage' anchor. Not 4 because the actions cover the skill's full behavior rather than leaving minor gaps.

5 / 5

Completeness

Both parts are explicit: a clear 'what' (structured multi-session interview across named modules, named elicitation techniques, disk persistence, master brandbook output) and a concrete 'Use when' clause with three trigger scenarios. This matches the top anchor exactly; neither part is missing or weakly implied.

5 / 5

Trigger Term Quality

Natural user phrasings present: 'creating or repositioning a brand', 'briefing designers or writers', 'brand identity', 'making implicit founder knowledge explicit'. A few common variants are missing (e.g. 'branding', 'brand guidelines', 'mission/vision'). Not 5 because synonym coverage is good but not comprehensive; not 3 because the included terms are ones users would actually say.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — a multi-session brand-discovery interview with a defined output — and triggers like 'creating or repositioning a brand' are distinct. Minor overlap risk with closely related voice/brand skills since the description mentions the 'voice' module and 'briefing writers'. Not 5 because a user asking only for a brand-voice profile could reasonably trigger this or a dedicated voice skill; not 3 because the interview-and-synthesis framing is well outside generic territory.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

affaan-m/ECC

Path

skills/brand-discovery/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.