CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-service

Use when adding a new Skylark service — the native unit of data + logic + doors (web/CLI). Covers the folder shape, which deck it belongs in, wiring it to a view, testing it, and when to give it a zine.

64

Quality

81%

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

82%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 tight, well-sequenced guide with concrete commands and real code that adds only project-specific knowledge (decks, doors, purity rules, event-based coupling). The main gaps are the incomplete test example and absent cli.ts/server.ts code, plus no explicit error-recovery guidance for failed migrations or tests.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — 'npm run db:generate', 'A service reads and writes only its own tables' — with zero padding and no explanation of concepts Claude already knows. All the terminology it does explain (decks, doors, zines) is project-specific and earns its tokens.

5 / 5

Actionability

Mostly executable: real commands ('npm run db:generate', 'npm run db:migrate'), a complete service.ts example, and a folder-layout spec. Not 5 because the test snippet is a comment sketch ('// push your schema, seed, call your service functions, assert.') and cli.ts/server.ts wiring is described but never shown, leaving minor gaps.

4 / 5

Workflow Clarity

A clear 8-step sequence with a genuine validation checkpoint (step 7: drive service.ts against PGlite and assert), covering the database-operation feedback-loop concern. Not 5 because there are no error-recovery loops (e.g., what to do when a migration fails or a test breaks), and not below 4 since the checkpoints that matter are present.

4 / 5

Progressive Disclosure

Well-organized sections with clear, one-level-deep, well-signaled pointers ('src/hull/health/', 'src/zine.md', 'drizzle.config.ts', the author-zine skill). Not 5: at ~87 lines it exceeds the under-50-line simple-skill exception, and some content (e.g., the full testing pattern or door-wiring details) could live in a reference file, so placement is good rather than optimal.

4 / 5

Total

17

/

20

Passed

Description

71%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, third-person description with an explicit 'Use when' trigger and a concrete five-part coverage list. Its main weaknesses are single-trigger phrasing (no synonym variations like 'create/scaffold a service') and a jargon-heavy opening clause ('native unit of data + logic + doors') that assumes context.

Suggestions

Broaden the trigger with natural variations: 'Use when adding, creating, or scaffolding a new Skylark service' — users say 'create' and 'scaffold' as often as 'add'.

Replace or gloss the jargon in the opening clause, e.g. 'a new Skylark service (a unit of data + logic + web/CLI doors)' so the 'what' reads concretely without inside knowledge.

Consider adding one more explicit trigger context such as 'or when asked where a new feature should live (hull/rigging/home)' to sharpen the when-to-use boundary.

DimensionReasoningScore

Specificity

The description lists several concrete coverage areas — 'Covers the folder shape, which deck it belongs in, wiring it to a view, testing it, and when to give it a zine' — five distinct, specific aspects. Not 3 (it lists far more than 1-2 actions) and not 5 (the 'what' leans on project jargon like 'the native unit of data + logic + doors' rather than fully concrete actions).

4 / 5

Completeness

Both are present: an explicit trigger ('Use when adding a new Skylark service') and a clear 'what' (folder shape, deck choice, view wiring, testing, zine). Not 5 because the anchor-5 examples include multiple concrete trigger phrases ('or when the user mentions PDFs, forms...'), whereas here the 'when' rests on a single trigger with no variations.

4 / 5

Trigger Term Quality

'adding a new Skylark service' is a natural phrase a user in this repo would say, but coverage stops there — common variations like 'create', 'scaffold', or 'build a service' are absent. Matches anchor 3 ('some relevant keywords but missing common variations or synonyms') more than anchor 4, which expects good broader coverage.

3 / 5

Distinctiveness Conflict Risk

'Skylark service' is a clear niche term with a distinct trigger; virtually no other skill would fire on 'adding a new Skylark service'. The only adjacent skill mentioned ('author-zine') lives in the body, not the description, so overlap risk in the trigger surface is minimal.

5 / 5

Total

16

/

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/create-service/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.