CtrlK
BlogDocsLog inGet started
Tessl Logo

punkt-css-dev

Developing component and utility styles in the Punkt design system (@oslokommune/punkt-css). Covers creating, modifying, and maintaining SCSS in /packages/css/src/scss/. Use when working on Punkt CSS source code.

74

2.72x
Quality

69%

Does it follow best practices?

Impact

98%

2.72x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/punkt-css-dev/SKILL.md
SKILL.md
Quality
Evals
Security

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 maximally concise and well-structured as an index, but it is only an index: no actionable guidance, examples, or workflow steps appear in SKILL.md itself, and every referenced file is absent from the bundle, making the entire skill's substance unverifiable from what is written. Scores are held down by 'evaluate what is written, not what could be inferred'.

Suggestions

Add a brief actionable core to SKILL.md — e.g., a minimal component SCSS example, the naming convention summary, and the build command — so the skill is useful before any reference is opened.

Inline or summarize the 'Checklist: Adding Component Styles' workflow as numbered steps with a validation checkpoint (e.g., build/screenshot check), rather than leaving it only as a linked file.

Include the 17 referenced files in the bundle (references/ directory) or trim the index to files that actually ship, so progressive disclosure is real rather than dead links.

DimensionReasoningScore

Conciseness

The body is a lean two-sentence overview plus a numbered index of 17 reference files — no padding, no explanation of concepts Claude already knows, no duplicated content. Every token earns its place. It is clearly the level-5 anchor, not level 4, because there is not even minor over-explanation to trim.

5 / 5

Actionability

The body provides concrete scope pointers ('/packages/css/src/scss/', '@oslokommune/punkt-css') but zero executable guidance — no code, commands, naming examples, or steps, delegating everything to 17 referenced files. This matches 'minimal concrete guidance; high-level hints but missing the specific steps to execute' rather than level 1, because the domain references are specific rather than vague; it cannot reach level 3-4 because no instruction or example of any kind appears in the body itself.

2 / 5

Workflow Clarity

No multi-step process is written anywhere in the body; even the implied workflow ('Checklist: Adding Component Styles') exists only as an index entry. This sits between level 1 ('steps missing; no sequence') and level 2 ('rough sequence present'), scoring 2 because the coherent index signals where the sequence lives, but no steps or validation checkpoints are actually stated. No destructive/batch operation is described, so the workflow cap does not apply.

2 / 5

Progressive Disclosure

The link structure itself is clean — 17 one-level-deep, clearly named, numbered references — but two problems hold it at the middle anchor: the SKILL.md body contains no overview/getting-started content beyond restating the description, and none of the 17 referenced files exist in the bundle (no references/ directory), so the links are dead here and navigation cannot be verified. Not level 2 since nothing is inlined or buried, but not level 4-5 since the split cannot be confirmed and the body adds no orienting content.

3 / 5

Total

12

/

20

Passed

Description

73%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, lean description: explicit what-and-when structure, third-person gerund voice, and highly distinctive niche triggers tied to a named package and path. The main weaknesses are generic verb choices for capabilities and a single, narrow trigger clause without synonyms.

DimensionReasoningScore

Specificity

The description names the domain precisely ('Developing component and utility styles in the Punkt design system (@oslokommune/punkt-css)' with a concrete SCSS path), but the actions 'creating, modifying, and maintaining' are near-synonymous generic verbs rather than distinct concrete capabilities, matching the anchor 'names domain and 1-2 concrete actions, but not comprehensive'. It is above level 2 because the domain and artifact are specific, not generic, but below level 4 because the verb list collapses into a single action (writing styles) with no differentiated capabilities.

3 / 5

Completeness

It explicitly answers both parts: what ('Covers creating, modifying, and maintaining SCSS in /packages/css/src/scss/') and when ('Use when working on Punkt CSS source code'), matching the anchor 'has both what and when; when could be more explicit or specific'. It is not level 5 because the trigger is a single clause without additional concrete trigger phrases or synonyms.

4 / 5

Trigger Term Quality

Natural terms users of this system would actually say are present: 'Punkt design system', '@oslokommune/punkt-css', 'SCSS', and 'Punkt CSS source code', giving good keyword coverage. It falls short of level 5 because common variations like 'styles', 'stylesheet', 'design tokens', or 'Oslo Kommune' are absent.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche anchored by the unique package name '@oslokommune/punkt-css' and repo-relative path, with triggers ('Punkt CSS source code') that would not fire for unrelated skills — minimal conflict risk.

5 / 5

Total

16

/

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: 16 missing

Warning

Total

15

/

16

Passed

Repository
oslokommune/punkt-skills
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.