CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-animations

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/review-animations/SKILL.md

The canonical home for this skill is review-animations in emilkowalski/skills

SKILL.md
Quality
Evals
Security

Quality

Content

70%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 dense, highly actionable review playbook with concrete thresholds, a clear remediation hierarchy, and a required output format with explicit verdict criteria. Its main gaps are significant duplication between the standards and escalation-trigger lists, and a referenced STANDARDS.md file that is missing from the bundle, which undermines both the deferral structure and the 'pull exact values' instruction.

Suggestions

Ship the referenced STANDARDS.md file (easing curves, duration tables, spring configs, gesture/clip-path/a11y details) — it is linked four times in the body but absent from the bundle, breaking both navigation and the 'pull exact values' workflow.

Merge the 'Aggressive Escalation Triggers' list into the Ten Non-Negotiable Standards (e.g., severity tags like 'zero-tolerance' on the relevant standards) — most triggers currently restate a standard verbatim.

Trim the 'Operating Posture' repetition of the frontmatter's stance ('Default to flagging. Approval is earned') and tighten the Initial Response block to reclaim tokens.

DimensionReasoningScore

Conciseness

No concepts Claude already knows are over-explained, but there is notable redundancy that could be tightened: the 14-item 'Aggressive Escalation Triggers' list largely restates the Ten Non-Negotiable Standards (ease-in, scale(0), layout properties, transform-origin: center, keyboard actions, >300ms durations all appear twice), and 'Operating Posture' repeats the frontmatter's 'Default to flagging. Approval is earned'. Anchor 3 ('mostly efficient but could be tightened') fits better than anchor 4's 'minor instances'.

3 / 5

Actionability

Highly concrete guidance throughout — specific thresholds ('under 300ms', 'scale(0.9–0.97)', '30–80ms stagger'), copy-paste-ready fixes in the findings table ('transition: transform 200ms ease-out'), and explicit Block/Approve criteria. Not 5 because the instructed step 'pull the exact one from STANDARDS.md rather than approximating' cannot be executed — STANDARDS.md is not present in the skill bundle — leaving precise values (curves, duration tables, spring configs) unavailable.

4 / 5

Workflow Clarity

The review workflow is unambiguous and well-sequenced: measure every animation against the ten standards, flag escalation triggers on sight, propose fixes via the 9-step remedial hierarchy, then emit the required two-part output (findings table, tiered verdict) closing with an explicit Block/Approve decision. This is a single-purpose, non-destructive review skill, so the simple-skill exception applies and the single action is fully unambiguous.

5 / 5

Progressive Disclosure

The deferral strategy is well-signaled (rule catalog, duration tables, and spring config pushed one level deep to STANDARDS.md with explicit 'load it when a finding needs a precise value' triggers), but STANDARDS.md — referenced four times — does not exist in the bundle, so navigation to the detailed material fails entirely. Scoring against the actual bundle structure, this is a substantive gap, not the 'minor organization gaps' of anchor 4.

3 / 5

Total

15

/

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 is concise, third-person, and clearly states what the skill does while staking out a distinct, low-conflict niche. Its main weaknesses are the complete absence of any when-to-use trigger guidance and missing common synonyms such as 'transition' or 'easing' that users naturally say.

Suggestions

Add an explicit 'Use when...' clause naming trigger situations, e.g. 'Use when reviewing animations, transitions, or motion code in a diff, or when asked whether motion feels right.'

Include common natural terms users would say — 'transition', 'easing', 'micro-interactions', 'animation performance' — alongside 'animation and motion'.

Enumerate the concrete capabilities (easing/duration standards, GPU performance checks, interruptibility, reduced-motion accessibility) so the 'what' is comprehensive, not a single action.

DimensionReasoningScore

Specificity

"Reviews animation and motion code against a high craft bar" names the domain and one concrete action with a defined standard, but coverage is not comprehensive — the specific check categories the body covers (easing, duration, GPU performance, a11y) are absent. It is more concrete than anchor 2's generic 'Processes PDF files' but lists only a single action, so anchor 3 fits best.

3 / 5

Completeness

The 'what' is clear and specific (reviews animation and motion code against a craft bar), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guideline. Not a 2 because the 'what' is concrete rather than vague.

3 / 5

Trigger Term Quality

"animation", "motion", and "review" are the primary natural terms a user would say, but common variations and synonyms — "transition", "easing", "micro-interaction", library names like Framer/Motion — are missing. This matches 'some relevant keywords but missing common variations or synonyms' better than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"Reviews animation and motion code" against a named design philosophy carves a clear niche that would not collide with unrelated skills; residual overlap risk is only with general code-review skills. Not 5 because there are no explicit trigger phrases to further disambiguate when this vs. a general review skill should fire.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

16

Passed

Repository

englishstreetventures/osn

Path

.agents/skills/review-animations/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.