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.
66
58%
Does it follow best practices?
Impact
Pending
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 reads like a psychology textbook rather than an actionable skill file. It explains dozens of concepts Claude already knows well, consuming enormous token budget without adding proportional value. The content would be far more effective as a concise routing document pointing to categorized reference files, with the SKILL.md itself focusing on the decision framework for selecting and applying models rather than defining them all inline.
Suggestions
Restructure as a concise overview (under 80 lines) with the quick reference table and decision framework, moving model details into separate category files (e.g., `models/pricing-psychology.md`, `models/persuasion.md`) referenced from the main skill.
Remove definitions of well-known concepts (sunk cost fallacy, Pareto principle, etc.) and focus only on the marketing-specific application that Claude wouldn't already know.
Add concrete output templates showing what a mental model analysis should look like when delivered to a user—e.g., a structured recommendation format with model name, application, specific implementation steps, and ethical considerations.
Add a clear workflow with validation: e.g., 1) Identify the marketing challenge category, 2) Select 2-3 relevant models from reference, 3) Check against product context file, 4) Verify ethical application, 5) Provide specific implementation steps with success metrics.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This is extremely verbose at 400+ lines, essentially a textbook of 70+ mental models with explanations Claude already knows. Concepts like 'sunk cost fallacy,' 'anchoring effect,' and 'Pareto Principle' are well within Claude's training data and don't need definitions. The entire content could be reduced to a quick-reference table with marketing-specific applications only. | 1 / 3 |
Actionability | Each model includes a 'Marketing application' section with concrete guidance, which is useful. However, there are no executable code examples, no specific templates, no step-by-step implementation instructions, and no concrete output formats. The guidance remains at the level of general advice rather than specific, implementable actions. | 2 / 3 |
Workflow Clarity | The 'How to Use This Skill' section provides a 4-step process and the quick reference table helps with model selection. However, there's no validation or feedback mechanism, no clear workflow for applying models to a specific situation, and the task-specific questions at the end feel disconnected from the main content. | 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 reference files (e.g., pricing-psychology.md, persuasion-models.md) with SKILL.md serving as a concise overview and routing guide. The related skills section at the end is good but insufficient to compensate. | 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
05d40bb
- 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.