CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-create-composable

Use when adding server state management to a module - creates Vue Query composable with caching and error handling.

Quality

82%

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 an exemplary lean instruction skill: a crisp type-decision table, a specific creation checklist, and an explicit validation step, with detail properly delegated to the project's architecture doc. The only meaningful improvement would be a minimal copy-paste composable template to make the creation step fully executable.

DimensionReasoningScore

Conciseness

The ~30-line body is lean and assumes Claude's competence: no explanations of Vue Query or composables, every line instructs ("Parameters with `MaybeRef<T>` for reactivity", "Explicit `staleTime`"), and architecture detail is delegated to `docs/ARCHITECTURE.md` §4.4 rather than duplicated. This matches the anchor for every token earning its place.

5 / 5

Actionability

Guidance is mostly executable with concrete specifics: file path pattern `composables/use[Name].ts`, `MaybeRef<T>` params, reactive queryKey via `computed`, explicit `staleTime`, and the validation command `npx tsc --noEmit`. It stops short of anchor 5 because there is no copy-paste-ready composable code template covering the common Query case, leaving a minor gap.

4 / 5

Workflow Clarity

A clear five-step sequence (read spec, determine type, create composable, connect layers, validate) ends in an explicit validation checkpoint (`npx tsc --noEmit`), matching anchor 4. It is not anchor 5 because there is no explicit fix-and-retry feedback loop for validation failures; the batch/destructive cap of 3 does not apply since the operation creates a new file and validation is present.

4 / 5

Progressive Disclosure

This is a simple, single-purpose skill under 50 lines with no bundle files: a single "## Steps" section organizes the content, and the one external reference (`docs/ARCHITECTURE.md` §4.4) is clearly signaled and one level deep. Per the rubric's simple-skill guidance, this matches the top anchor.

5 / 5

Total

18

/

20

Passed

Description

73%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 is a solid, third-person, concise trigger-plus-capability statement for a well-defined Vue/Vue Query niche. Its main weaknesses are limited action coverage (one core action with attributes) and missing natural synonyms like "data fetching" or "useQuery" that users might say instead of "server state management".

Suggestions

Enumerate a few more concrete capabilities as actions, e.g. "creates Vue Query composables with reactive query keys, caching, and error handling, and wires services to adapters".

Add natural trigger synonyms to the when-clause so more user phrasings match, e.g. "Use when adding data fetching, server state, or a useQuery/useMutation composable to a module".

Consider naming the query/mutation distinction in the description since it is the skill's core decision point and a term users may use when requesting the skill.

DimensionReasoningScore

Specificity

"creates Vue Query composable" is one concrete action, with "caching and error handling" as attributes of that artifact rather than separately listed actions, matching the anchor for naming a domain with 1-2 concrete actions. It falls short of anchor 4 because it does not enumerate several distinct actions, and is above anchor 2 because the action named is concrete rather than generic.

3 / 5

Completeness

Both parts are explicit: what ("creates Vue Query composable with caching and error handling") and when ("Use when adding server state management to a module"), matching anchor 4. It does not reach anchor 5 because the when-clause offers a single trigger rather than multiple concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural terms users would say are present: "server state management", "Vue Query", "composable", "caching", "error handling" — good coverage matching anchor 4. It is not anchor 5 because common variations such as "data fetching", "useQuery/useMutation", or "API state" are missing.

4 / 5

Distinctiveness Conflict Risk

"Vue Query composable" combined with "server state management" carves out a clear niche with distinct triggers and minimal risk of firing for unrelated skills, matching anchor 5. Anchors 3-4 (overlap with similar skills) fit worse since the domain specificity is high.

5 / 5

Total

16

/

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