CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pretext

Build creative browser demos with DOM-free text layout.

55

Quality

69%

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 ./optional-skills/creative/pretext/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 highly actionable with executable code for every major API pattern, an explicit validated workflow, and an excellent pitfalls/performance section covering real failure modes. Its weakness is structural: it depends on template files that are missing from the bundle and inlines content that belongs in references. Fixing the broken template references would lift the skill substantially.

Suggestions

Ship `templates/hello-orb-flow.html` and `templates/donut-orbit.html` (or remove the 'Start from a template' workflow step), since the workflow currently depends on files absent from the bundle.

Move the community-demos listing and the extended pitfall prose into `references/` files, keeping SKILL.md as a lean overview with well-signaled one-level-deep links.

Trim the motivational framing in the Overview ('That sounds like plumbing. It is not...', 'the kind people post to X') to tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious content (API shapes, font-sync pitfalls, per-frame performance notes) and assumes competence, but contains trimmable motivational prose ('That sounds like plumbing. It is not...', 'the kind people post to X') and an inline community-demo listing that pads length. Fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place level of score 5.

4 / 5

Actionability

The content provides copy-paste-ready code for both use cases plus the streaming `layoutNextLineRange` loop (whose `widthAtY()` placeholder is explicitly the reader's own function), a pinned CDN import, a concrete verification command (`python -m http.server 8765`), and a pitfalls list with exact fixes. Common cases are covered by executable examples. Not below 5: no pseudocode-only gaps remain.

5 / 5

Workflow Clarity

The 7-step workflow is clearly sequenced with explicit validation checkpoints — 'Verify locally' with a runnable command, 'Check the console' for error feedback, and a final verification checklist with ten concrete pass criteria. This matches 'clear sequence with explicit validation steps; feedback loops...; checklists'. The operations are non-destructive, so no cap applies.

5 / 5

Progressive Disclosure

The one real bundle file (`references/patterns.md`) is well-signaled, but the body repeatedly points to `templates/hello-orb-flow.html` and `templates/donut-orbit.html` — neither exists in the bundle — and workflow step 2 instructs 'Start from a template' that cannot be found. Substantial inline content (community demo list, extended pitfall prose) also belongs in a reference file. This fits 'some structure but could be better organized' rather than score 4's 'most content appropriately placed; references mostly clear'.

3 / 5

Total

17

/

20

Passed

Description

42%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 states a clear, single-sentence 'what' but omits the 'when' entirely and never mentions the library's name or the natural phrases users would use to invoke it. It reads as a terse tagline rather than a trigger-rich capability statement. Adding the library name and a 'Use when' clause with the concrete demo types would move it into good-example territory.

Suggestions

Include the trigger term 'pretext' and the natural user phrasings (e.g. 'text flowing around a shape', 'ASCII art from real words', 'kinetic typography') so the skill fires when users describe these effects.

Add an explicit 'Use when...' clause listing the concrete demo scenarios (reflow around moving sprites, text-as-geometry games, shatter/particle typography, multiline shrink-wrap UI).

State the core capability concretely — 'measures line breaks, per-line widths, and per-grapheme positions via canvas, then render the result yourself' — instead of the generic 'build creative browser demos'.

DimensionReasoningScore

Specificity

The description names its domain ('creative browser demos') and one concrete capability ('DOM-free text layout'), matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It does not list several specific actions (score 4) nor is it purely generic (score 2).

3 / 5

Completeness

The 'what' is clear (build creative browser demos with DOM-free text layout) but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is above score 2 because 'what' is explicitly stated, not vague.

3 / 5

Trigger Term Quality

Only two keywords appear ('creative browser demos', 'DOM-free text layout') and the most natural user trigger — the library name 'pretext' — is absent, as are common phrases like 'ASCII art', 'kinetic typography', or 'text flowing around a shape'. This fits 'one or two generic keywords; missing the natural phrases users say' rather than the partial synonym coverage of score 3.

2 / 5

Distinctiveness Conflict Risk

'Build creative browser demos with DOM-free text layout' is somewhat specific, but overlaps with adjacent skills the body itself names (p5js canvas art, ascii-art, general typography demos), matching 'somewhat specific but could still overlap with similar skills'. Not score 4, since no unique trigger term (e.g. 'pretext') is present to disambiguate.

3 / 5

Total

11

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

NousResearch/hermes-agent

Path

optional-skills/creative/pretext/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.