CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

audience-belief-mapper

Use when the user asks to "map what our buyers believe", "capture the objections we keep hearing", or "find the switching forces that move the beachhead"; produces a belief map of the beachhead — held beliefs and mental models, the recurring objections and their reframes, and the JTBD four forces (push of the problem, pull of the new, anxiety of switching, habit of the present) — each item sourced from interviews or win-loss notes (User-provided) and labeled Measured / User-provided / Estimated, with any unverified quote or comparative claim marked "[needs source]" and routed to the claims candidates, never adjudicated here. Not for demographic or persona profiling — use audience-mapper; not for the positioning canvas — use positioning-truth-tracer. 受众信念/异议地图/切换四力/流失语言

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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 instruction skill with a clear contract, sequenced steps, and a done-when checklist. Its weaknesses are verbosity from heavy repetition of the claims-routing boilerplate and sibling-skill links, and the fact that its one mechanical operation (the registry-events propose request) is referenced repeatedly but never actually shown.

Suggestions

State the claims-routing rule ('[needs source] → memory/events/claims.ndjson via an authorized operation: propose request to registry-events.py') once in the Skill Contract and refer back to it from the instructions, instead of repeating the full phrase six times.

Show the concrete propose-request format once (the actual fields registry-events.py expects) so the claims-sweep step is fully executable rather than repeatedly named.

Consolidate the sibling-skill links into a single Reference Materials or Next Best Skill section; currently audience-mapper, positioning-truth-tracer, and strategic-narrative-designer are each linked in three or four separate sections.

DimensionReasoningScore

Conciseness

The routing phrase 'via an authorized `operation: propose` request to `registry-events.py`' is repeated six times across the contract, instructions, and save sections, and the same sibling-skill links appear in four places (Scope guard, Skill Contract, Reference Materials, Next Best Skill). It is mostly efficient and assumes Claude's competence, but the repetition is noticeable padding that could be tightened — matching the 3 anchor rather than 4.

3 / 5

Actionability

The seven instructions give concrete, executable guidance: exact memory paths ('memory/narrative/audience-belief-mapper/YYYY-MM-DD-<topic>.md'), a defined output shape (objection · frequency-source · reframe candidate), and a labeling scheme. It is not a 5 because the one quasi-mechanical operation — submitting to claims.ndjson — never shows the actual propose request syntax, leaving a gap in the most technical step.

4 / 5

Workflow Clarity

Steps are clearly sequenced from anchoring to assembly, with an explicit 'Done when' checklist, a stop-and-route condition if no persona base exists, and an ask-before-write guard on memory. It falls short of the 5 anchor because there are no error-recovery or feedback loops, and the unshown propose syntax leaves the claims-sweep step without a verifiable checkpoint.

4 / 5

Progressive Disclosure

The body is well-sectioned (Quick Start, Skill Contract, Data Sources, Instructions, Save Results, Reference Materials) with one-level-deep, clearly signaled references such as 'tale-benchmark.md — TALE framework; this skill feeds the T, A, and E sub-items'. It is not a 5 because no bundle files exist here to verify the referenced paths (which point outside the skill, e.g. '../../../references/tale-benchmark.md'), and the Reference Materials list substantially duplicates links already given in Scope guard, Skill Contract, and Next Best Skill.

4 / 5

Total

15

/

20

Passed

Description

92%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 deliverables, explicit use-when triggers in the user's own words, and explicit disambiguation against sibling skills. Its only weakness is density — the labeling/routing rules and the trailing Chinese summary pad it, and a few common trigger phrasings (e.g. 'why we lose deals') are missing.

DimensionReasoningScore

Specificity

The description enumerates the full deliverable comprehensively: 'a belief map of the beachhead — held beliefs and mental models, the recurring objections and their reframes, and the JTBD four forces (push of the problem, pull of the new, anxiety of switching, habit of the present)', plus sourcing and labeling rules. This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); it is not a 4 because there are no minor gaps in what the skill produces.

5 / 5

Completeness

It explicitly answers 'when' with an 'Use when the user asks to...' clause containing three concrete trigger phrases, and 'what' with a detailed inventory of the belief map's contents. This is the 5 anchor verbatim in shape (explicit what AND when with concrete trigger phrases); a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural quoted triggers like 'map what our buyers believe', 'capture the objections we keep hearing', and 'find the switching forces that move the beachhead' are exactly what a user would say, and 'objections', 'win-loss notes' add coverage. It falls short of the 5 anchor because common variants such as 'why we lose deals' or plain 'customer objections' phrasing are not covered, though jargon like 'beachhead' and 'JTBD' is at least defined inline.

4 / 5

Distinctiveness Conflict Risk

Explicit boundary routing — 'Not for demographic or persona profiling — use audience-mapper; not for the positioning canvas — use positioning-truth-tracer' — gives it a clear niche with distinct triggers and minimal conflict risk. It is not a 4 because the overlap with adjacent skills is not just minor but actively disambiguated.

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing, 2 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

narrative/trace/audience-belief-mapper/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.