CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

one-pager

Make a one-pager: one HTML page that shares an idea with teammates early, or recaps work for them, with big pictures and little words.

Quality

82%

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

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.

A lean, well-scoped instruction-only skill: it states the deliverable, the audience, and concrete style constraints with essentially zero padding, and its single action is unambiguous. The main room for improvement is actionability, where vague directives ("use your own taste, avoid lazy design") and the lack of any example structure leave the design under-anchored.

DimensionReasoningScore

Conciseness

Efficient, ~110 words of pure directive prose with no explanations of concepts Claude already knows, so it is well above the verbose anchors. Not a 5 because of minor trimmable duplication: "The reader is new to the subject" is restated as "Explain things as if the viewer is new here", and the opening sentence re-derives the frontmatter description.

4 / 5

Actionability

Concrete, specific constraints throughout: audience ("new to the subject and has a minute"), format ("one HTML page"), ratio ("big pictures and little words without withholding key details"), and prose rules ("clear, concise/terse, and avoid jargon"). Per the instruction-only scoring note, absent code is not penalized; it is not a 5 because "use your own taste, avoid lazy design" is non-specific and there is no example layout or skeleton to anchor the design.

4 / 5

Workflow Clarity

A simple, single-purpose skill where the action is unambiguous: "You are making a one-pager: one HTML page to share with teammates", with audience and success criteria stated. The simple-skill guideline allows a 5 for a single unambiguous action, and no destructive or batch operations exist to impose the validation cap.

5 / 5

Progressive Disclosure

The body is under 50 lines, the bundle contains no references/, scripts/, or assets/ directories, and the body references no external files — so nothing needs splitting out. Content is organized into logically ordered short paragraphs (context → visual approach → taste/selectivity → prose rules), satisfying the simple-skill exception for progressive disclosure.

5 / 5

Total

18

/

20

Passed

Description

70%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 clearly states what the skill produces and its two use cases, anchored by the distinctive natural term "one-pager" and a concrete style signature ("big pictures and little words"). Its weaknesses are the absence of an explicit "Use when..." trigger clause and coverage limited to one core action, which cap completeness and specificity just below the top anchors. Note that disable-model-invocation is set, so the description primarily aids user recognition in a skill list rather than auto-triggering.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks for a one-pager, a single-page summary, or a visual recap to share with teammates."

Enumerate the concrete actions the skill performs (e.g., "designs a single self-contained HTML page, selects and integrates real-world imagery, writes terse jargon-free captions") to broaden coverage beyond one verb plus context.

DimensionReasoningScore

Specificity

Names the artifact concretely ("one HTML page"), the design directive ("big pictures and little words"), and the actions "shares an idea with teammates early" / "recaps work" — but this is one core operation with two use contexts rather than several distinct actions, so it matches "names domain and 1-2 concrete actions, but not comprehensive". It sits above the anchor-2 'names domain only' level because the output and its characteristics are explicitly described.

3 / 5

Completeness

The 'what' is explicit ("Make a one-pager: one HTML page... with big pictures and little words") and the 'when' is explicitly written out through the two purposes ("shares an idea with teammates early, or recaps work for them") — not merely implied, so it is above anchor 3. But there is no "Use when..." phrasing or equivalent explicit trigger clause, so the 'when' could be more explicit, matching anchor 4.

4 / 5

Trigger Term Quality

"one-pager" is exactly the natural phrase a user would say when they need this skill, supported by "recaps work" and "shares an idea with teammates". A few natural terms are missing (e.g., "summary page", "single-page overview", ".html"), which fits "good keyword coverage; a few natural terms missing" rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"one-pager" carves a clear, distinctive niche with its own trigger vocabulary, so it is well above the generic 'works with document files' anchors. Minor overlap risk remains with generic HTML-page building or summarization skills, which keeps it at "mostly distinct; minor overlap risk" rather than the minimal-conflict anchor 5.

4 / 5

Total

15

/

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

plannotator/effective-html

Path

skills/one-pager/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.