CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

principle-experience-first

Apply when product, UX, or feature-scope tradeoffs come up. Choose user delight over implementation convenience; ship fewer polished features over more rough ones.

70

Quality

88%

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

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

An exemplarily lean principle skill: it adds only judgment guidance Claude would not reliably apply on its own, states one clear decision rule, and elaborates it with concrete heuristics. Its only weakness is the absence of a worked example showing the principle applied to a concrete tradeoff.

DimensionReasoningScore

Conciseness

The body is ~150 words with zero padding: 'The product is the experience. Every technical decision either helps or hurts it.' No concepts Claude already knows are explained, and every line is a directive or a needed clarification — matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

The five bullets are concrete decision rules with specific parentheticals ('design decisions are cheaper in throwaway HTML than production code', 'transitions, alignment, spacing, feedback, error states'), and the core rule is explicit: 'When implementation convenience conflicts with user delight, choose delight.' It falls short of anchor 5 because no worked example shows the principle applied to a real tradeoff, leaving minor gaps in covering common cases.

4 / 5

Workflow Clarity

This is a single-purpose principle skill under 50 lines with one unambiguous action (choose delight over convenience, applying the five heuristics), so the simple-skill exception applies and workflow clarity scores 5. It involves no destructive or batch operations that would require validation checkpoints.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (none exist in the bundle), and it is well organized: a title, a one-line thesis, five scannable bullets, a definition of 'the user', and a boundary note distinguishing sequence vs. target. Per the rubric guideline this earns a 5 on organization alone.

5 / 5

Total

19

/

20

Passed

Description

78%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 that explicitly answers both what the skill does and when to apply it, in third-person-appropriate imperative voice with no fluff. Its main limitation is that the capability statement compresses to a single decision rule, which costs specificity and leaves a few natural trigger synonyms uncovered.

Suggestions

Enumerate the concrete actions the skill performs as separate clauses (e.g., evaluating feature-scope tradeoffs, applying experience-first heuristics like 'say no to 1,000 things', and framing impact from the end user's seat) to raise specificity beyond one decision rule.

Add common natural trigger variations such as 'feature creep', 'MVP scope', 'cutting features', or 'product decisions' so the trigger coverage includes the synonyms users actually say.

DimensionReasoningScore

Specificity

It names the domain ('product, UX, or feature-scope tradeoffs') and two directive actions ('Choose user delight over implementation convenience', 'ship fewer polished features over more rough ones'), matching the anchor for domain plus 1-2 concrete actions. It is not a 4 because the two clauses are variations of a single decision rule rather than several distinct actions.

3 / 5

Completeness

Both halves are explicit: what ('Choose user delight over implementation convenience; ship fewer polished features over more rough ones') and when ('Apply when product, UX, or feature-scope tradeoffs come up') with concrete trigger contexts. The 'when' clause is explicit and specific, so this is not the anchor-4 case of an adequate-but-vaguer trigger.

5 / 5

Trigger Term Quality

'product, UX, or feature-scope tradeoffs', 'user delight', and 'polished' are terms a user would naturally say when this skill applies — good coverage with only a few natural terms missing. It is not a 5 because common synonyms and variations like 'scope creep', 'MVP', or 'cutting features' are absent.

4 / 5

Distinctiveness Conflict Risk

The niche — experience-first product and feature-scope decisions — is clearly staked out and distinct from tooling or format skills, with only minor overlap risk against closely related product-strategy or design skills. It is not a 5 because the trigger domain ('product, UX... tradeoffs') is broad enough that a sibling product-thinking skill could plausibly compete.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

adamsardo/pstack-claude

Path

plugins/pstack/skills/principle-experience-first/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.