CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-create-composable

Use when adding server state management or shared logic - creates an auto-imported composable with useFetch/useAsyncData.

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

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.

The body is a lean, well-sequenced instruction set for a project-specific workflow: classify the composable type, create the file in the right location with the right options, wire the layers, and validate with nuxi typecheck. It fully assumes Claude's competence and points to one external doc one level deep. The only gaps are minor: no example composable template and no error-recovery loop after typecheck fails.

DimensionReasoningScore

Conciseness

The body is entirely directive with zero filler — e.g. "Connect the layers: service -> adapter -> useAsyncData" and "Validate: `nuxi typecheck`" — and never explains concepts Claude already knows (what composables, refs, or useAsyncData are). Every token earns its place, matching the lean anchor exactly.

5 / 5

Actionability

Gives concrete, executable guidance: exact file paths ("composables/use[Name].ts" or "modules/[feature]/composables/use[Name].ts"), specific options ("Reactive key for useAsyncData", "`watch` option for auto-refetch", "Adapter in `transform` option"), and a runnable validation command ("nuxi typecheck"). Not level 5 because there is no example composable signature/template and key details are delegated to the external docs/ARCHITECTURE.md section 4.4; not level 3 because the guidance is specific and executable rather than pseudocode or high-level hints.

4 / 5

Workflow Clarity

Five clearly numbered steps in a sound order — read the architecture doc, classify the composable type, create the file, connect layers, validate — with an explicit checkpoint ("Validate: `nuxi typecheck`"). Not level 5 because there is no feedback loop for error recovery (what to do when typecheck fails); not level 3 because the validation step is explicit and correctly sequenced, not implicit.

4 / 5

Progressive Disclosure

The skill is under 50 lines, cleanly organized under a "## Steps" section, and delegates detail via a single clearly-signaled one-level-deep reference ("docs/ARCHITECTURE.md section 4.4"); no bundle files exist to split further. This matches the simple-skill exception: well-organized sections with no nested references.

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 explicitly answers both what ("creates an auto-imported composable with useFetch/useAsyncData") and when ("Use when adding server state management or shared logic"), using Nuxt-specific terminology that keeps conflict risk low. Its main weakness is narrow coverage: one core action and two trigger phrases rather than a fuller set of actions and natural trigger variations.

Suggestions

Broaden the what-clause to enumerate the concrete capabilities, e.g. "creates an auto-imported composable for data fetching (useAsyncData), mutations (refreshNuxtData), or shared state (useState/Pinia)", to raise specificity.

Add common trigger phrasings to the when-clause — such as "create a composable", "shared state", or "data fetching" — so a wider range of natural user requests reliably matches.

DimensionReasoningScore

Specificity

The description states one concrete action — "creates an auto-imported composable with useFetch/useAsyncData" — which names the domain and specific APIs but does not list several distinct actions. It is above level 2 (the action and technologies are concrete, not generic) but below level 4 (no multi-action coverage like query/mutation/shared-state handling).

3 / 5

Completeness

Both questions are answered explicitly: what ("creates an auto-imported composable with useFetch/useAsyncData") and when ("Use when adding server state management or shared logic"). Not level 5 because the when-clause misses obvious trigger phrasings such as "create a composable" or "data fetching"; not level 3 because the when is explicit with concrete triggers, not merely implied.

4 / 5

Trigger Term Quality

Includes natural, domain-appropriate trigger phrases — "server state management", "shared logic" — plus specific API names ("useFetch/useAsyncData") that users would mention. Not level 5 because common variations like "data fetching", "shared state", "reactive", or "Pinia" are absent; not level 3 because coverage goes well beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

"auto-imported composable" and "useFetch/useAsyncData" pin the skill to a clear Nuxt niche with distinct triggers. Not level 5 because "server state management" and "shared logic" could also plausibly trigger closely related skills (e.g., a Pinia store-creation skill); not level 3 because the what-clause is highly specific to composable creation.

4 / 5

Total

15

/

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/nuxt/skills/dev-create-composable/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.