Name: punkt-css
Rating: 74.4 (1 reviews)
Author: oslokommune

punkt-css

Using Punkt CSS (@oslokommune/punkt-css) in projects. Covers setup, layout, typography, colors, grid, spacing, and utility classes for building websites and applications with the Oslo kommune design system. Use when building pages or layouts with Punkt CSS classes.

1.65x

Quality

61%

Does it follow best practices?

Impact

96%

1.65x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/punkt-css/SKILL.md

Quality

Content

37%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This SKILL.md is essentially a bare table of contents with no actionable content of its own. While it is concise and well-organized in its references, it fails to provide any quick-start guidance, code examples, or workflow steps that would make it independently useful. A good SKILL.md overview should include at least a minimal getting-started snippet so Claude can act without needing to read sub-files for basic tasks.

Suggestions

Add a 'Quick Start' section with a concrete code example showing basic Punkt CSS setup (e.g., CDN link or npm install + a minimal HTML snippet with key classes).

Include at least one actionable workflow: e.g., steps to set up a new page using Punkt CSS classes, from installation to first layout.

Add a brief 'Common patterns' section with 2-3 copy-paste-ready HTML/CSS snippets for the most frequent use cases (e.g., page layout, typography, grid).

Dimension	Reasoning	Score
Conciseness	The content is extremely lean — just a key principle and a table of contents. No unnecessary explanations or padding. Every token serves a purpose.	3 / 3
Actionability	The SKILL.md itself contains zero executable guidance, no code examples, no concrete commands, and no quick-start snippet. It is purely a navigation page with no actionable content on its own.	1 / 3
Workflow Clarity	There is no workflow, sequence, or process described. The file is just a list of links with no indication of how to use them in sequence or what steps to follow to get started.	1 / 3
Progressive Disclosure	The structure is well-organized with clear one-level-deep references to 9 topic files, which is good. However, since no bundle files were provided, we cannot verify these references actually exist, and the SKILL.md lacks even a minimal quick-start section that would make it useful on its own before diving into sub-files.	2 / 3
	Total	7 / 12 Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid skill description that clearly identifies the specific framework (Punkt CSS / @oslokommune/punkt-css), lists concrete capability areas, and includes an explicit 'Use when' clause. The main weakness is that trigger terms could be slightly broader to capture more natural user phrasings, but the specificity of the framework name itself provides strong natural disambiguation.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete areas: setup, layout, typography, colors, grid, spacing, and utility classes. Also specifies the domain clearly as the Oslo kommune design system via Punkt CSS.	3 / 3
Completeness	Clearly answers both 'what' (covers setup, layout, typography, colors, grid, spacing, utility classes for building with Oslo kommune design system) and 'when' (explicit 'Use when building pages or layouts with Punkt CSS classes').	3 / 3
Trigger Term Quality	Includes good terms like 'Punkt CSS', '@oslokommune/punkt-css', 'Oslo kommune design system', 'layout', 'typography', 'grid', 'spacing', and 'utility classes'. However, it misses common user variations like 'punkt', 'oslo design', 'pkt-' class prefixes, or 'design tokens' that users might naturally mention.	2 / 3
Distinctiveness Conflict Risk	Highly distinctive due to the specific framework name 'Punkt CSS' and the '@oslokommune/punkt-css' package reference. Very unlikely to conflict with other CSS framework skills.	3 / 3
	Total	11 / 12 Passed

Validation

100%

Warnings & errors only

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

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: oslokommune/punkt-skills
Commit: ba01e6a

Reviewed: about 1 month ago

Table of Contents

Discovery Implementation Validation

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.