data-client-rest-setup

Set up and migrate to @data-client/rest for REST APIs. Detects existing HTTP patterns (axios, fetch, ky, superagent, got) and migrates them. Creates custom RestEndpoint base class with common behaviors. Use when adopting @data-client/rest in a new or existing project.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is highly actionable with well-structured one-level-deep references and a clear detection/migration workflow. The main weaknesses are some redundancy between the per-override snippets and the full example, and a missing validation checkpoint for the generated base class.

Suggestions

Consolidate the individual 'Common Lifecycle Overrides' snippets with the 'Full Example with Multiple Overrides' — either keep only the full example or move the per-override snippets into a reference file to reduce duplication.

Add an explicit validation checkpoint after base-class creation (e.g., 'Run `tsc --noEmit` and a single endpoint fetch to confirm the base class compiles and authenticates before wiring Entities').

Confirm the cross-references in 'Next Steps' point to real skills, or soften 'apply skill X' to 'see the data-client-rest skill' to avoid implying bundled content that may not be present.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and free of concept-explanation fluff, but the body is long — the base-class template, multiple separate lifecycle override snippets, and a 'Full Example with Multiple Overrides' largely restate the same methods, which could be tightened or pushed to a reference.	2 / 3
Actionability	Provides fully executable install commands, copy-paste TypeScript base-class templates, detection regexes, and concrete resource()/endpoint examples — matching the score-3 anchor for executable, specific guidance.	3 / 3
Workflow Clarity	The install → detect → migrate → base-class sequence is clearly numbered with a detection checklist and ambiguous/mixed-codebase handling, but the base-class creation is an unvalidated 'offer to create' step with no verification checkpoint (e.g., type-checking or smoke-testing the generated endpoints), capping the score per the destructive/batch-operation feedback-loop rule.	2 / 3
Progressive Disclosure	The body is an overview that points to one-level-deep, clearly signaled reference files for each migration (axios, fetch, ky, superagent, got) and API docs (RestEndpoint, resource, auth); all referenced files exist in the bundle, and content is appropriately split.	3 / 3
	Total	10 / 12 Passed

Description

100%

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 concrete, names natural trigger terms, explicitly states both purpose and 'Use when' trigger, and is clearly distinct from other skills. Voice is third person, so no penalty applies.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Set up and migrate', 'Detects existing HTTP patterns (axios, fetch, ky, superagent, got)', 'Creates custom RestEndpoint base class' — matching the score-3 anchor of several specific concrete actions.	3 / 3
Completeness	Clearly answers both what it does (setup, detection, migration, base class creation) and when to use it via the explicit 'Use when adopting @data-client/rest in a new or existing project' clause.	3 / 3
Trigger Term Quality	Names the natural library names users would say (axios, fetch, ky, superagent, got) plus 'REST APIs', giving good coverage of terms a user would naturally use when requesting this migration.	3 / 3
Distinctiveness Conflict Risk	The named package '@data-client/rest' and enumerated source libraries carve a clear niche unlikely to trigger for unrelated skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

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: .cursor/skills/data-client-rest-setup/SKILL.md
Commit: e823560

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.