marketing-psychology
When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' or 'consumer behavior.' This skill provides 70+ mental models organized for marketing application.
52
58%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./config/claude/skills/marketing-psychology/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-structured description with excellent trigger term coverage and clear 'when to use' guidance. Its main weakness is the lack of specific concrete actions—it tells you what it contains (70+ mental models) but not what specific tasks it helps accomplish. Adding 2-3 concrete action verbs would elevate the specificity.
Suggestions
Add specific concrete actions such as 'Identifies relevant cognitive biases for campaigns, maps persuasion frameworks to messaging, analyzes consumer decision-making patterns' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (psychological principles applied to marketing) and mentions '70+ mental models organized for marketing application,' but does not list specific concrete actions like 'analyze consumer decisions,' 'apply cognitive biases to copy,' or 'map persuasion frameworks to campaigns.' | 2 / 3 |
Completeness | Clearly answers both 'what' (provides 70+ mental models organized for marketing application of psychological principles) and 'when' (explicit 'Use when' clause with specific trigger terms and use cases). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' and 'consumer behavior' are all terms users would naturally use when seeking this kind of help. | 3 / 3 |
Distinctiveness Conflict Risk | The intersection of psychology/behavioral science with marketing is a clear niche. The specific trigger terms like 'cognitive bias,' 'mental models,' 'why people buy' are distinct enough to avoid conflicts with general marketing or general psychology skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a comprehensive encyclopedia of marketing psychology models but fails as a SKILL.md due to extreme verbosity and poor progressive disclosure. It explains many concepts Claude already knows, presents everything inline rather than splitting into referenced files, and provides conceptual rather than executable guidance. The quick reference table and task-specific questions are strengths, but the overall structure needs significant restructuring to be token-efficient and actionable.
Suggestions
Split the 70+ models into category-specific reference files (e.g., PRICING-PSYCHOLOGY.md, PERSUASION.md, GROWTH-MODELS.md) and keep SKILL.md as a concise overview with the quick reference table and links to detailed files.
Remove basic definitions of well-known concepts (sunk cost fallacy, Pareto principle, etc.) and focus only on the non-obvious marketing applications that Claude wouldn't already know.
Add concrete, executable artifacts: copy templates, A/B test hypotheses, landing page wireframe structures, or specific implementation checklists rather than conceptual 'Marketing application' paragraphs.
Add a decision-tree workflow: given a user's challenge, how to systematically select, apply, and validate the right mental models, including verification steps to test whether the applied psychology is working.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at 400+ lines. Many models are explained with basic definitions Claude already knows (e.g., what sunk cost fallacy is, what Pareto principle means). The skill explains 70+ mental models inline with redundant 'Marketing application' sections that often state obvious implications. This could be reduced by 60-70% without losing actionable value. | 1 / 3 |
Actionability | Each model includes a 'Marketing application' section with specific guidance, and the quick reference table maps challenges to models. However, the guidance is mostly conceptual rather than executable—there are no concrete code examples, templates, copy frameworks, or step-by-step implementation instructions. It tells you what to do conceptually but not exactly how. | 2 / 3 |
Workflow Clarity | The 'How to Use This Skill' section provides a basic 4-step workflow and the task-specific questions at the end add structure. However, there's no clear decision tree or process for selecting which models to apply, no validation steps, and no feedback loops for testing whether the applied psychology actually worked. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with 70+ models all inline. The content desperately needs to be split into separate files (e.g., pricing-psychology.md, persuasion-models.md, growth-models.md) with the SKILL.md serving as an overview with references. The Related Skills section at the end hints at cross-references but the core content is entirely undisclosed. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- freekmurze/dotfiles
- Commit
3974caa
- 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.