CtrlK
BlogDocsLog inGet started
Tessl Logo

audience-analyze-search

Read who a market is, starting from a plain-English brief — discover → pivot → read. The discovery-first way into audience-analyze, behind /watt:audience; size is an output, never a target. Aggregates only — never individual records, never an export. Not a user command. Use when a read-shaped ask arrives with a brief and no signals yet — "who's in the market for X", "profile this audience", "an audience profile for my client".

66

Quality

83%

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

75%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 tightly written, well-sequenced procedural skill body that assumes Claude's competence and supplies concrete parameters, clear phases, and failure-mode recovery. The main gap is that the detailed procedures it points to live in context files that are not present in the local bundle, slightly weakening both actionability and progressive disclosure.

Suggestions

Consolidate the repeated 'size is an output, never a target' emphasis into a single canonical statement and reference it, to tighten conciseness.

Inline at least a minimal executable snippet for the materialize step (the count-only entity find with format: "none" and the radius filter) so the core action is copy-paste-ready, not only described.

Either ship the referenced context files (context/discovery.md, scoring.md, profiling.md, record.md, adjacencies.md) in the bundle or note explicitly that they are owned by the parent audience-analyze plugin, so the one-level-deep references resolve verifiably.

DimensionReasoningScore

Conciseness

The body is dense procedural guidance that assumes Claude's competence and does not explain basic concepts, with concrete parameters ('format: "none"', 'entity_type: "person"'); it earns 4 rather than 5 because some emphases repeat across sections ('size is an output' appears in Purpose, step 1, How to behave, and Refuse cleanly) and a few long parentheticals could be trimmed.

4 / 5

Actionability

It gives mostly executable guidance — a concrete command ('cat "<Bundle root>/context/scoring.md"'), specific parameters, role bounds ('5–20 defining, 0–3 must-haves, 0–5 exclusions'), and exact build semantics ('defining any-of, must-haves all-of, exclusions none-of'); it stops short of anchor 5 because the detailed procedures are deferred to referenced context files rather than fully copy-paste-ready inline.

4 / 5

Workflow Clarity

The flow is clearly sequenced into four numbered phases with checkpoints ('let the operator amend before any search', 'end the turn at the pivot question', 'Exclusions are explicit-include only') plus a Failure modes section with recovery guidance; it is not 5 because the main flow lacks an explicit validate→fix→retry loop of the kind anchor 5 illustrates, though the operation is read-only so the destructive-cap does not apply.

4 / 5

Progressive Disclosure

Structure is good — a clear overview (Purpose, Works with, Language) with one-level-deep, well-signaled references to context files ('context/discovery.md', 'context/scoring.md', 'context/profiling.md'); it does not reach 5 because no bundle files exist in references/scripts/assets to confirm the referenced paths resolve, and references use a '<Bundle root>' placeholder rather than verified local paths.

4 / 5

Total

16

/

20

Passed

Description

82%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 well-constructed description that cleanly answers both what and when with concrete quoted trigger phrases and strong distinctiveness from sibling skills. Its only weakness is that the named actions are abstract process verbs rather than concrete capabilities, which keeps specificity at the midpoint.

DimensionReasoningScore

Specificity

It names the domain ('Read who a market is') and three process verbs ('discover → pivot → read'), but these are high-level procedural labels rather than concrete capabilities like 'extract text' or 'fill forms', so coverage is not comprehensive — matching anchor 3 and falling short of the multi-action specificity of anchor 4.

3 / 5

Completeness

It explicitly states both what ('Read who a market is... discover → pivot → read... Aggregates only — never individual records, never an export') and when ('Use when a read-shaped ask arrives with a brief and no signals yet') with concrete trigger phrases, matching the anchor 5 example; it is not anchor 4 because the 'when' is fully explicit rather than merely adequate.

5 / 5

Trigger Term Quality

It quotes three natural phrases a user would actually say ('"who's in the market for X"', '"profile this audience"', '"an audience profile for my client"'), giving good keyword coverage; it stops short of anchor 5's comprehensive synonym/extension coverage since the triggers are narrow to read-shaped audience asks.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche ('The discovery-first way into audience-analyze, behind /watt:audience', 'Not a user command') and explicitly separates from siblings ('size is an output, never a target' vs generate; 'never an export' vs activate), giving minimal conflict risk as in anchor 5.

5 / 5

Total

17

/

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
wattdata/plugin
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.