CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-create-service

Use when adding API integration to a module - creates types, contracts, adapter, and service layer.

Quality

88%

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

86%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, highly actionable skill body that specifies exact file names, conventions, rules, and a validation command with zero padding. The main gaps are the absence of an explicit validate-and-fix feedback loop and reliance on an external architecture doc for content patterns.

DimensionReasoningScore

Conciseness

The body is lean and fully instructional — every line directs action ('NO try/catch', 'pure functions', 'mirrors API exactly (snake_case)') with no explanations of concepts Claude already knows. Even the parenthetical '(available in both server and client in SvelteKit)' conveys project-specific knowledge, matching the anchor where every token earns its place.

5 / 5

Actionability

Concrete file paths ('types/[resource].types.ts', 'adapters/[resource]-adapter.ts'), a copy-paste validation command ('npx svelte-check --tsconfig ./tsconfig.json'), and specific questions to ask the user make this mostly executable. It falls short of fully executable because the actual content patterns for each artifact are delegated to docs/ARCHITECTURE.md rather than shown or templated.

4 / 5

Workflow Clarity

A clear 5-step sequence with an explicit creation order (a through d) and a validation checkpoint ('Validate: npx svelte-check --tsconfig ./tsconfig.json'). It does not reach 5 because there is no explicit error-recovery loop (e.g., 'if svelte-check fails, fix and re-run') after the validation step.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files, organized under a clear '## Steps' section, and its single external reference is clearly signaled and one level deep ('docs/ARCHITECTURE.md sections 4.1 (Services), 4.2 (Adapters), 4.3 (Types)'). Per the simple-skill guidance, well-organized short content with no need for external references merits the top score.

5 / 5

Total

18

/

20

Passed

Description

88%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 that explicitly states both what it creates and when to use it, with concrete deliverables and a natural trigger phrase. Keyword coverage lacks synonyms for the API-integration concept, and the broad trigger phrase carries minor conflict risk with general API skills.

DimensionReasoningScore

Specificity

The phrase 'creates types, contracts, adapter, and service layer' lists four concrete deliverables that comprehensively cover the skill's data-layer scope, matching the anchor for multiple specific concrete actions with comprehensive coverage. It is not a 4 because there are no meaningful gaps in the coverage of what the skill produces.

5 / 5

Completeness

It explicitly answers both questions: 'Use when adding API integration to a module' provides a concrete trigger phrase, and 'creates types, contracts, adapter, and service layer' states exactly what it does. This matches the anchor requiring both what and when with concrete trigger phrases, so it exceeds the 4 anchor whose 'when' is less specific.

5 / 5

Trigger Term Quality

'adding API integration to a module' is a phrase a user would naturally say, and 'service layer', 'adapter', and 'types' add relevant keywords, but common variations like 'endpoint', 'connect to an API', or 'fetch data' are missing. This falls between the 'some relevant keywords' (3) and 'good keyword coverage' (4) anchors, noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

The four-artifact output list (types, contracts, adapter, service layer) carves a distinct scaffolding niche, but the trigger 'adding API integration to a module' could overlap with generic API-consumption skills. This matches 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

packs/svelte/skills/dev-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.