CtrlK
BlogDocsLog inGet started
Tessl Logo

punkt-elements-dev

Developing Lit web components in the Punkt design system (@oslokommune/punkt-elements). Covers creating, modifying, and testing components in /packages/elements/src/components/. Use when working on Punkt Elements source code.

68

0.95x
Quality

66%

Does it follow best practices?

Impact

80%

0.95x

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-elements-dev/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

40%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 lean, clearly organized table of contents, but it is nothing else: no quick-start guidance, no example component or test command, and no workflow steps inline. Worse, every file it links to is absent from the bundle, so the skill's entire substance is unreachable as provided.

Suggestions

Add a minimal quick-start section with executable content — e.g., a skeleton Lit component, the command to run component tests, and one inline snippet — so SKILL.md is actionable even before opening reference files.

Ship the 15 referenced .md files in the bundle (e.g., under references/) or inline the most critical content; currently every link (architecture-overview.md, checklist-new-element.md, etc.) points to a file that does not exist, breaking progressive disclosure entirely.

Inline the 'Adding a New Element' checklist steps (or at least its key validation commands) in SKILL.md, since that is the skill's core workflow and currently lives only in a missing file.

Remove the opening sentence that repeats the frontmatter description almost verbatim — it spends tokens without adding information.

DimensionReasoningScore

Conciseness

The body is very lean (~20 lines, no concept explanations Claude already knows), so it respects the token budget. Not 5 because the opening sentence 'Skill for developing Lit web components in the Punkt design system... Covers creating, modifying, and testing components...' duplicates the frontmatter description nearly verbatim — a token that does not earn its place.

4 / 5

Actionability

The body contains no code, commands, or quick-start guidance — only a numbered list of 15 links ('1. [Architecture Overview](architecture-overview.md)' etc.) as high-level pointers, and none of those files exist in the bundle. Not 1 because the links are specific navigation targets rather than vague description; not 3 because there is no partial executable guidance at all in SKILL.md.

2 / 5

Workflow Clarity

The numbered section list implies a rough reading order ending in '15. [Checklist: Adding a New Element](checklist-new-element.md)', but no actual steps, sequence, or validation checkpoints are written in the body, and the checklist that would define the workflow is in a missing file. Not 1 because a rough logical progression is present; not 3 because no explicit step sequence with checkpoints exists in the body.

2 / 5

Progressive Disclosure

References are one level deep and clearly signaled, but the body delegates 100% of the content to 15 referenced files, none of which are present in the bundle (no references/, scripts/, or assets/ directories exist) — navigation is effectively broken. Not 1 because the overview itself is well-organized, not a monolith or nested chain; not 3 because the references are not merely unclearly signaled — they are unverifiable/missing.

2 / 5

Total

10

/

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.

The description is strong: it states concrete capabilities in third person, names a distinctive niche via package and path, and includes an explicit 'Use when...' trigger. Its only weakness is trigger breadth — the 'when' clause and keywords cover few natural user phrasings or synonyms.

DimensionReasoningScore

Specificity

Names the domain ('Lit web components in the Punkt design system (@oslokommune/punkt-elements)') plus three concrete actions ('creating, modifying, and testing components') and a concrete path ('/packages/elements/src/components/'). Anchor 4 fits: several specific actions with minor gaps; not 5 because coverage is not comprehensive (e.g., no mention of building, linting, or reviewing).

4 / 5

Completeness

Explicitly answers 'what' ('Developing Lit web components... Covers creating, modifying, and testing components') and 'when' ('Use when working on Punkt Elements source code'). Anchor 4 fits because the 'when' clause could be more specific (e.g., mention component names or user phrasings); not 3 since a 'Use when...' clause is present, not 5 since the trigger phrase is narrow.

4 / 5

Trigger Term Quality

Contains good, brand-specific keywords ('Lit web components', 'Punkt design system', '@oslokommune/punkt-elements', 'Punkt Elements source code') users of this codebase would naturally say. Not 5 because natural variations and synonyms are missing (e.g., 'add a new component', 'elements package', file extensions); not 3 because multiple relevant, distinctive terms are present.

4 / 5

Distinctiveness Conflict Risk

Clear niche defined by design system name, scoped package name, and source path; triggers ('Punkt Elements source code') are distinct and would not plausibly fire for another skill. Matches anchor 5 (clear niche with distinct triggers; minimal conflict risk).

5 / 5

Total

17

/

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: 15 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.