CtrlK
BlogDocsLog inGet started
Tessl Logo

iptvnator-theme-style

Use when changing IPTVnator SCSS tokens, shared layout mixins, portal headers, sidebars, detail views, Electron drag regions, or cross-portal visual consistency.

62

Quality

78%

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 ./.codex/skills/iptvnator-theme-style/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A tight, highly actionable style-policy skill: exact files, tokens, class names, validators, and concrete numeric budgets, with no wasted tokens. Its only weaknesses are the absence of an explicit step sequence with failure handling, and an all-inline structure slightly past overview length.

DimensionReasoningScore

Conciseness

The body is dense, rule-based prose with zero padding: it never explains what SCSS, Electron, or compositing are, and every line carries project-specific facts ('Set component tokens through `mat.*-overrides()`; retired `--mdc-*` names do nothing'). This matches the anchor 'Lean and efficient; assumes Claude's competence; every token earns its place.'

5 / 5

Actionability

Guidance is fully concrete: exact paths ('apps/web/src/m3-theme.scss', 'libs/ui/styles/_portal-header.scss'), exact token/class names ('--app-selection-on-color', '.app-destructive-button', 'SOURCE_TYPE_ICONS'), exact commands ('pnpm run styles:material-tokens:validate', 'pnpm run perf:compositing'), and exact numbers (weights 400/500/600/700, 8 px sidebar gap, ~24 MB tile memory). For an instruction-only policy skill this is copy-paste-ready guidance covering the common cases.

5 / 5

Workflow Clarity

Validation checkpoints are explicitly present ('run `pnpm run perf:compositing` before and after, quote the numbers in the PR', 'Inspect light and dark themes, selected/hover states'), so the destructive/batch cap does not apply. However, the body is a rule catalog rather than a sequenced workflow — there is no explicit ordering (consult sources → apply rules → validate) and no failure-handling feedback loop, which keeps it at 'clear sequence with most checkpoints present; minor validation gaps' rather than 5.

4 / 5

Progressive Disclosure

Sections are well organized (Canonical Sources, Token Boundary, Shared Layout Rules, Typography, Rendering Cost, Validation) and detail is delegated one level deep to clearly signaled repo files with content hints ('UI policy and migration debt: docs/architecture/iptvnator-ui-guidelines.md'). But the body is ~73 lines — above the under-50-line simple-skill allowance — with everything inlined and no skill bundle files to split into, so 'good structure; minor organization gaps' fits better than the 5 anchor.

4 / 5

Total

18

/

20

Passed

Description

56%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 distinctive, well-triggered description whose only significant flaw is that it is 'when'-only: it precisely scopes when to invoke the skill but never states what the skill does, which also leaves its capability list implied rather than stated.

Suggestions

Add a leading 'what' clause, e.g. 'Applies IPTVnator's shared theme-token, layout-mixin, and portal-styling conventions when changing SCSS tokens, portal headers, sidebars, detail views, Electron drag regions, or cross-portal visual consistency.'

State the skill's function explicitly (apply/enforce style rules and run the style validators) so the 'what' is present, which would also lift specificity above 'domain plus one action'.

Include common synonyms users might naturally say, such as 'styling', 'styles', 'theme', or 'dark mode', alongside the existing trigger terms.

DimensionReasoningScore

Specificity

The description names the domain and its concrete surfaces ('IPTVnator SCSS tokens, shared layout mixins, portal headers, sidebars, detail views, Electron drag regions'), but the only action is the user's task 'changing' — it never states what the skill itself does. This matches 'Names domain and 1-2 concrete actions, but not comprehensive'; it is above anchor 2 because the object list is specific, and below anchor 4 because no capability verbs are listed.

3 / 5

Completeness

The 'when' is explicit and strong ('Use when changing...'), but the 'what' is entirely absent — the description never says what the skill does (apply conventions? validate? document?). Anchor 2 explicitly covers 'only when is present without what', mirroring its example 'Use when working with documents'. It is not 3 because that anchor requires a clear 'what', and not 1 because the 'when' clause is specific and present.

2 / 5

Trigger Term Quality

Good natural-term coverage a developer in this repo would actually say: 'SCSS tokens', 'mixins', 'portal headers', 'sidebars', 'detail views', 'Electron drag regions', 'visual consistency'. A few common synonyms are missing ('styling', 'styles', 'theme', 'colors', 'dark mode'), so it fits 'Good keyword coverage; a few natural terms missing' rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

'IPTVnator' plus its named surfaces (portal headers, Xtream/Stalker-adjacent detail views, Electron drag regions) carve out a clear niche with distinct triggers and virtually no overlap risk with any other skill.

5 / 5

Total

14

/

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
4gray/iptvnator
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.