Tessl • The package manager for agent skills

SkillPublic

marketing-psychology

Apply psychological principles and behavioral science to copy and design. Useful for tightening hooks, framing, and pricing presentation.

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/marketing-psychology/SKILL.md

Quality

Content

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

The body is a lean, well-organized catalogue stub, but its core promise — running the upstream workflow — rests on an undefined 'install the bundle' step with no executable command or verification. It reads as an advertisement rather than an actionable skill instruction.

Suggestions

Replace the 'open <url>' command with the actual executable install steps (e.g. 'git clone https://github.com/coreyhaines31/marketingskills && cp -r marketingskills/skills/marketing-psychology ~/.claude/skills/'), with exact paths stated instead of delegated to the upstream README.

Add a verification checkpoint after install, e.g. a command or check that the skill now appears in the agent's skill list before invoking it, to close the workflow's missing validation loop.

Drop the verbatim repetition of the frontmatter description in 'What it does' in favor of a one-line summary that adds information (e.g. what the upstream bundle contains).

Dimension	Reasoning	Score
Conciseness	The body is short, assumes Claude's competence, and explains nothing Claude already knows. Not 5 because the 'What it does' section repeats the frontmatter description verbatim and 'Curated from Corey Haines' / OpenDesign catalogue narration is mild padding that could be trimmed; not 3 because there is no substantive over-explanation.	4 / 5
Actionability	The only command is 'open https://github.com/...' (opens a browser, not an install step), and the actual instruction — 'install the upstream bundle into your active agent's skills directory' — is delegated with 'Inspect the upstream README for exact paths'. Not 3 because there is no executable step toward the skill's stated purpose at all (no install command, path, or invocation example); not 1 because a concrete URL and a named invocation path ('invoke this skill by name (`marketing-psychology`)') are given.	2 / 5
Workflow Clarity	A rough sequence exists (open upstream repo → inspect README → install bundle → invoke by name or trigger phrase), but the critical install step is undefined and no validation that the skill is actually available follows. Not 3 because the pivotal step of the workflow ('install the upstream bundle') has no defined command or checkpoint; not 1 because the sequence that is present is coherent and correctly ordered.	2 / 5
Progressive Disclosure	The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist), and per the rubric's simple-skill guidance it scores on well-organized sections — 'What it does', 'Source', 'How to use' are clear, and the single external pointer (the upstream URL) is one level deep and clearly signaled. Not 4 because nothing is inlined that belongs in a separate file and navigation is unambiguous.	5 / 5
	Total	13 / 20 Passed

Description

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

The description clearly states what the skill does and gestures at use cases, but lacks an explicit 'Use when...' trigger clause and has thin keyword coverage. It is serviceable but below the quality of the good examples, which pair concrete capability lists with explicit invocation conditions.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when writing or reviewing marketing copy, landing pages, pricing pages, or email sequences, or when the user mentions persuasion, conversion optimization, or behavioral framing.'

Expand trigger terms with natural synonyms users would actually say — 'conversion copy', 'landing page', 'persuasion techniques', 'pricing psychology', 'A/B test copy' — to improve both completeness and trigger term quality.

Replace the generic 'Apply psychological principles' verb with concrete actions, e.g. 'Applies Cialdini's persuasion principles, loss aversion framing, and anchoring to rewrite hooks, CTAs, and pricing tiers.'

Dimension	Reasoning	Score
Specificity	Names the domain ('psychological principles and behavioral science to copy and design') and 1-2 concrete applications ('tightening hooks, framing, and pricing presentation'), but 'apply' is generic and coverage is not comprehensive. Not 4 because it does not list several specific concrete actions comparable to 'extracts text, fills forms, converts pages'; not 2 because the domain and applications are more substantive than 'Processes PDF files'.	3 / 5
Completeness	Has a clear 'what' ('Apply psychological principles and behavioral science to copy and design') but the 'when' is only weakly implied by 'Useful for tightening hooks...' — there is no explicit 'Use when...' clause, which caps completeness at 3 per the judging guidelines. Not 4 because the guidance explicitly requires an explicit trigger clause; not 2 because the 'what' is clear rather than vague.	3 / 5
Trigger Term Quality	'hooks', 'framing', and 'pricing presentation' are natural terms a marketer might say, but common variations and synonyms ('landing page copy', 'conversion', 'behavioral copy', 'persuasion') are missing from the description itself. Not 4 because keyword coverage lacks the synonym breadth of 'PDF files, forms, document extraction'; not 2 because the terms present are relevant and natural rather than generic.	3 / 5
Distinctiveness Conflict Risk	'psychological principles and behavioral science to copy and design' carves a fairly distinct niche with minor overlap risk against general copywriting or brand-style skills. Not 5 because the applications ('hooks, framing, pricing') are somewhat broad phrasing without distinct file-type or artifact triggers; not 3 because the behavioral-science framing is more specific than 'Works with document files'.	4 / 5
	Total	13 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: nexu-io/open-design
Path: skills/marketing-psychology/SKILL.md
Revision: 78d5637

Reviewed: 17 days ago

Discovery Implementation Validation

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.

marketing-psychology

Table of Contents

Is this your skill?