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

86%

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 lean, well-structured workflow that gives concrete file targets, ordering, hard constraints, and a validation step with no wasted tokens. The main gaps are the absence of any inline code/template example for the generated files and no explicit fix-and-revalidate loop after `npx tsc --noEmit`.

DimensionReasoningScore

Conciseness

The body is lean with zero padding: every line is instruction (file paths, ordering, constraints, one validation command) and it assumes Claude's competence, e.g. "Service: NO try/catch, NO .map()/.filter()/new Date()" with no concept explanations. This matches the 5 anchor where every token earns its place.

5 / 5

Actionability

Concrete guidance includes exact file patterns ("types/[resource].types.ts", "adapters/[resource]-adapter.ts"), an executable validation command ("npx tsc --noEmit"), and specific user questions to ask. It stops short of fully copy-paste-ready content since it delegates file contents to docs/ARCHITECTURE.md sections 4.1-4.3 without inline examples, matching the 4 anchor's 'minor gaps' rather than the 5 anchor.

4 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced (read docs, gather requirements, create files in order, apply rules, validate with tsc) with a concrete validation checkpoint. It lacks an explicit error-recovery feedback loop (e.g. 'if tsc fails, fix and re-run'), which the 5 anchor requires, so it fits the 4 anchor of clear sequence with minor validation gaps.

4 / 5

Progressive Disclosure

This is a simple single-purpose skill under 50 lines with no bundle files, organized under a clear "## Steps" section, which the rubric's simple-skill guideline says can score 5 with just well-organized sections. Its single reference (docs/ARCHITECTURE.md sections 4.1-4.3) is clearly signaled and one level deep.

5 / 5

Total

18

/

20

Passed

Description

83%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 clearly states both what it does (creates types, contracts, adapter, and service layer) and when to use it (adding API integration to a module), in third person and without padding. Keyword coverage and action variety could be slightly broader, but conflict risk is low and the trigger is natural.

DimensionReasoningScore

Specificity

Phrases like "creates types, contracts, adapter, and service layer" list four concrete deliverables, matching the anchor for several specific actions with minor gaps. It falls short of a 5 because only one generic verb ("creates") is used and the full range of actions (asking for endpoint details, validating) is not covered.

4 / 5

Completeness

It explicitly answers both questions: "Use when adding API integration to a module" is a concrete when-trigger, and "creates types, contracts, adapter, and service layer" is a clear what. This matches the 5 anchor's structure of explicit what AND when with concrete trigger phrases, and exceeds the 4 anchor where the 'when' is less specific.

5 / 5

Trigger Term Quality

"adding API integration", "module", "adapter", and "service layer" are natural developer phrases a user would plausibly say, giving good keyword coverage. It misses common synonyms such as "endpoint", "REST", or "data layer", so it does not reach the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The niche (scaffolding types/contracts/adapter/service layer for a module) is mostly distinct with specific architectural terms. Minor overlap risk remains with related skills for consuming or building APIs, keeping it below the minimal-conflict 5 anchor.

4 / 5

Total

17

/

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/nextjs/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.