CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

data-client-schema

Model the app's data with @data-client schemas, which normalize responses into one shared cache so an update shows everywhere. Use it whenever an endpoint returning data is added or its response changes (resource, RestEndpoint, GraphQL, Endpoint), when the data's shape changes, when deriving views from loaded data, or when one item looks different in two places. Covers Entity, GQLEntity, Collection, Union and Query.

Quality

89%

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.

An excellent reference-style skill body: lean and dense with non-obvious library behavior, concrete API signatures and executable snippets, explicitly sequenced lifecycle pipelines, and a clean overview-to-references architecture where every link resolves and stays one level deep. The only deductions are minor: elided placeholders in the Union example and no end-to-end validation checkpoint structure (not really applicable to domain-modeling guidance).

DimensionReasoningScore

Conciseness

The body is dense with library-specific, non-obvious knowledge — pk routing via 'argsKey'/'nestKey', 'nonFilterArgumentKeys' matching semantics, exact normalize/denormalize method orders — with no padding and no explanation of concepts Claude already knows. Every bullet carries data-client-specific behavior, so each token earns its place rather than merely being 'mostly efficient'.

5 / 5

Actionability

Mostly concrete and executable — complete snippets for 'new Query(TodoResource.getList.schema, entries => ...)', Collection 'argsKey/nestKey' options, and 'new Collection([Todo], { nonFilterArgumentKeys: /orderBy|sortDir/ })', plus exact API signatures like 'shouldReorder(existingMeta, incomingMeta, existing, incoming)'. However, the Union example elides fields with '/* ... */' and references an undefined 'EventType', leaving minor gaps versus fully copy-paste-ready code.

4 / 5

Workflow Clarity

The sequences that exist are explicitly ordered ('process() → pk() → validate() → visit nested schemas → ... mergeWithStore()') and problem→solution mappings are concrete ('Older data arriving after newer... override shouldReorder(existingMeta, incomingMeta, existing, incoming)'). As a reference skill it has no end-to-end workflow needing validation checkpoints (none of its operations are destructive/batch), and section 6 defers entirely to partial-entities.md, so it sits at 'clear sequence, minor gaps' rather than the full error-recovery structure of a 5.

4 / 5

Progressive Disclosure

The body is a clear overview with well-labeled one-level-deep references — e.g. '[new Collection([Schema])](references/Collection.md) - mutable/growable lists' — and all 20 referenced files exist in references/. Reference files link only to siblings in the same directory (no 2+ level nesting), content is appropriately split between overview, practices, and reference files, and the Vue variant convention ('read `<name>.vue.md` instead of `<name>.md` when it exists') makes navigation across the 40-file bundle easy.

5 / 5

Total

18

/

20

Passed

Description

87%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: third-person imperative, explicit 'Use it whenever...' triggers covering four concrete scenarios, a clear statement of what the skill does and why (normalized shared cache), and tight scoping to the @data-client library. Its only weakness is that it centers on a single capability rather than enumerating several distinct actions and it lacks a few natural synonym phrasings.

DimensionReasoningScore

Specificity

Names the domain and concrete actions — 'Model the app's data with @data-client schemas, which normalize responses into one shared cache so an update shows everywhere' — and enumerates covered constructs ('Entity, GQLEntity, Collection, Union and Query'). It exceeds the 1-2 actions of a 3 but describes essentially one capability with its mechanism rather than the multiple distinct actions of a 5.

4 / 5

Completeness

Explicitly answers both what ('Model the app's data with @data-client schemas, which normalize responses into one shared cache so an update shows everywhere') and when ('Use it whenever an endpoint returning data is added or its response changes... when deriving views from loaded data, or when one item looks different in two places') with multiple concrete trigger phrases, matching the 5 anchor.

5 / 5

Trigger Term Quality

Includes genuinely natural trigger phrases users would say — 'an endpoint returning data is added', 'its response changes', 'when one item looks different in two places' — alongside library keywords ('resource, RestEndpoint, GraphQL, Endpoint'). Coverage is good but misses common synonyms such as 'add a resource' or 'type the response', falling short of the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

Tightly scoped to '@data-client schemas' with library-specific triggers (RestEndpoint, GQLEntity, normalization into a shared cache), giving it a clear niche with minimal conflict risk against generic data-fetching or state-management skills.

5 / 5

Total

18

/

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

reactive/data-client

Path

.agents/skills/data-client-schema/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.