CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

behavioral-design

Applies behavioral science (COM-B, B=MAP, EAST, defaults) to change behavior in teams and organizations (employees, managers, or engineers adopting a practice or tool) and in product flows; plans rollouts, workshops, and presentations; never recommends a dark pattern or sludge. Triggers on "how do I get my team to X", "why don't people do X", "roll this out", "nudge", "/behavioral-design".

Quality

85%

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

85%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 SKILL.md body is a model of lean, well-sequenced instructional writing: efficient mode detection, on-demand reference loading, an explicit ethics checkpoint, and recovery paths for non-interactive runs and missing skills. Its one serious defect is bundle integrity — the progressive-disclosure architecture routes almost all substantive content (rules, templates) to files that were never shipped, leaving Steps 3–5 under-specified in practice.

Suggestions

Ship the referenced bundle files: all five rules/*.md and both templates/*.md files cited in 'Required Reading by Mode' are absent — add them so the mode-based loading table and Steps 3–5 ('Follow the loaded rule files', 'run the three-question test', 'Fill the mode's template') actually resolve.

Inline the minimum needed to keep the ethics gate executable — the three test questions from rules/ethics.md belong in SKILL.md (or a shipped file) since Hard Rule 5 says it 'overrides default helpfulness'.

Fix the back-links in references/frameworks.md: its 'Used in' column points to ../rules/*.md files that are also missing — either ship those files or drop the links until they exist.

DimensionReasoningScore

Conciseness

The body is lean and operational throughout: frameworks (COM-B, B=MAP, EAST) are named but never taught, mode detection and required reading are terse tables, and the one example ('✗ "Get people to care about observability." / ✓ "Every engineer opening a PR that adds an API endpoint adds an OTel span to it"') earns its tokens. No section explains concepts Claude already knows, and nothing reads as padding.

5 / 5

Actionability

Guidance is concrete and directive ('Parse the first token of $ARGUMENTS', a numbered four-item context list, 'Every intervention carries its lever, the barrier it targets, the evidence grade'), but Steps 3–5 execute against files whose contents are absent from the bundle — 'run the three-question test in rules/ethics.md' and 'Fill the mode's template' cannot be carried out because rules/ethics.md and both templates are missing. This keeps it below fully-executable; it is well above the pseudocode/vague-hints level of 3.

4 / 5

Workflow Clarity

A clearly sequenced five-step workflow (pin behavior → gather context → run mode → ethics gate → emit) with an explicit validation checkpoint ('Any intervention that fails is dropped from the output and replaced by its honest alternative'), error-recovery paths ('proceed with unknowns and list every assumption'; a missing skill is reported 'skipped (not installed)' and work continues), and a six-item Hard Rules checklist governing the output. This is an advisory, non-destructive skill, so the batch/destructive validation cap does not apply.

5 / 5

Progressive Disclosure

The loading design itself is exemplary — 'Load on demand — never all up-front', a per-mode required-reading table, one-level-deep references with precise section pointers ('§ Evidence grading', '§ Diagnosis only'), and the one shipped bundle file (references/frameworks.md) is well-organized. But 7 of the 8 unique files referenced in the body (all five rules/*.md and both templates/*.md) do not exist in the bundle, and frameworks.md itself links back to missing ../rules/*.md files, so most referenced paths are broken in practice — a majority-scale navigation failure, not the 'minor organization gaps' of 4.

3 / 5

Total

17

/

20

Passed

Description

83%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: third-person, concrete, framework-named, with an explicit trigger clause quoting the natural phrases users actually say. Both 'what' and 'when' are answered clearly; the only improvements are covering the diagnose/review capabilities and adding synonyms like 'adoption' and 'change management' to the triggers.

DimensionReasoningScore

Specificity

Lists several concrete actions with named frameworks — 'Applies behavioral science (COM-B, B=MAP, EAST, defaults) to change behavior', 'plans rollouts, workshops, and presentations', 'never recommends a dark pattern or sludge' — but omits the barrier-diagnosis and rollout-review capabilities the body documents, so coverage has minor gaps. It is well above the 1–2-concrete-action level of 3 and short of comprehensive coverage.

4 / 5

Completeness

Explicitly answers both questions: what — 'Applies behavioral science … to change behavior in teams and organizations … and in product flows; plans rollouts, workshops, and presentations' — and when, with a dedicated trigger clause ('Triggers on …') listing concrete quoted phrases. The 'when' is explicit and phrase-level, not merely present, matching the top anchor rather than the 4 anchor's 'could be more explicit'.

5 / 5

Trigger Term Quality

Natural user phrasings are quoted directly — 'how do I get my team to X', 'why don't people do X', 'roll this out', 'nudge' — which a manager would genuinely say. A few natural terms are missing, though: 'adoption', 'change management', and 'buy-in' appear in the body's mode table and tags but not the description, keeping it below comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear behavioral-science niche with distinctive triggers ('nudge', 'why don't people do X') that few other skills would claim. Minor overlap risk remains: 'plans rollouts, workshops, and presentations' brushes against generic workshop/presentation skills and 'product flows' against UX skills, so it is mostly rather than fully distinct.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 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: 19 missing

Warning

Total

13

/

16

Passed

Repository

mthines/agent-skills

Path

skills/design/behavioral-design/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.