CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

author-zine

Use when writing or updating a zine — Skylark's spec format. Covers the required sections (tl;dr, Components, Structure, Decisions, Changelog) and the principles for what belongs in a zine versus a skill or elsewhere.

73

Quality

92%

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

92%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.

An exemplary short, single-file skill: lean and project-specific, with unambiguous structural rules for authoring and updating zines. The only minor gap is the absence of a worked example showing a real zine header or section.

DimensionReasoningScore

Conciseness

The body is lean and project-specific throughout ("enough to rebuild something that works the same way, not a pixel-perfect clone"; "Links point downward in the hierarchy"), with zero padding or explanations of concepts Claude already knows. Every token earns its place, matching anchor 5; anchor 4 would require minor over-explanation to trim, which is absent.

5 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: exact placement ("A zine is `zine.md` at the root"), the header template ("`_<name> zine — issue #N_`"), changelog entry format ("issue number + a one-line synopsis"), and explicit routing rules. It falls at anchor 4 rather than 5 only because no worked example of an actual zine section or header is shown — a minor gap against 'specific examples cover the common cases'.

4 / 5

Workflow Clarity

This is a simple, single-purpose skill under 50 lines, and the single action (author/update a zine) is unambiguous: the five sections are given in order with per-section content rules, the issue-number bump rule is explicit ("bump it when you add an entry"), and placement and link-direction rules are stated flatly. Per the simple-skill exception the single unambiguous action scores 5; no destructive or batch operations exist to require validation checkpoints.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references, and the content is organized into clear, well-titled sections (Where zines live / The five sections / Principles). Per the simple-skill guideline this scores 5; the one cross-skill pointer ("the **create-service** skill, not zine prose") is clearly signaled rather than a buried reference.

5 / 5

Total

19

/

20

Passed

Description

87%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 description with an explicit 'Use when' trigger, concrete enumeration of the five required sections, and a clear zine-vs-skill boundary. Trigger coverage is good though it omits a few natural synonyms like the zine.md file name.

DimensionReasoningScore

Specificity

"Use when writing or updating a zine — Skylark's spec format. Covers the required sections (tl;dr, Components, Structure, Decisions, Changelog) and the principles for what belongs in a zine versus a skill or elsewhere" names two concrete actions (writing, updating) and enumerates the five specific section names plus routing principles. It matches anchor 4 (several specific items, minor coverage gaps) rather than anchor 5 because it describes covered topics more than a comprehensive list of discrete, concrete actions.

4 / 5

Completeness

It explicitly answers both: what ("Covers the required sections (tl;dr, Components, Structure, Decisions, Changelog) and the principles for what belongs in a zine versus a skill or elsewhere") and when ("Use when writing or updating a zine"). The explicit 'Use when' clause with concrete triggers matches anchor 5; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases include "writing or updating a zine" and the synonym pairing "zine — Skylark's spec format", which a user of this codebase would actually say. Good keyword coverage with only a few natural terms missing (e.g., the file name "zine.md", "documentation"), fitting anchor 4 rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

"zine" is a distinctive coined term with clear niche triggers, and the description explicitly differentiates zines from skills ("what belongs in a zine versus a skill or elsewhere"), so it is unlikely to trigger the wrong skill. This matches anchor 5 (clear niche, minimal conflict risk) rather than anchor 4's minor overlap with closely related skills.

5 / 5

Total

18

/

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

drufball/skylark

Path

plugins/skylark-builder/skills/author-zine/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.