CtrlK
BlogDocsLog inGet started
Tessl Logo

client-methods

Client method surface rules. Use when wiring browser/client code to actions, application state, framework routes, app APIs, uploads, auth, or settings.

67

Quality

84%

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 high-quality rules skill: concrete method inventory with import paths, a clear decision workflow, explicit exceptions, and a real, clearly signaled reference file for the audit detail. Minor room to tighten the rationale paragraph and fold the action-fetch timeout details into a reference.

DimensionReasoningScore

Conciseness

The body is dense and mostly lean: a compact need→method table, terse numbered steps, short do/don't lists, and minimal boilerplate. It is not 5 because the 'Why' paragraph re-enumerates consequences ("rediscover auth, base paths, request-source headers, JSON parsing, error handling, optimistic updates, sync invalidation, and route quirks") — explanation that could be trimmed by a sentence — and the action-fetch-behavior paragraph carries detail that could partly live in a reference.

4 / 5

Actionability

Fully concrete guidance throughout: named hooks with exact import paths (`useActionQuery` / `useActionMutation` from `@agent-native/core/client/hooks`), an explicit call signature `callAction(name, params, { method, signal, timeoutMs })`, file-placement rules (`packages/core/src/client/*`, `templates/<app>/app/hooks/*`), and paired good/bad code examples. A developer can act on this directly without invention.

5 / 5

Workflow Clarity

The three-step decision sequence is clear and ordered: look for an existing client API (table), else add the narrowest helper with placement rules and 'Add focused tests for URL construction, headers, response parsing, error shape, and any sync invalidation', then teach the helper. It is not 5 because the validation guidance is a checklist mention rather than an explicit validate→fix→retry feedback loop, and the exceptions list is presented as cases rather than a decision checkpoint.

4 / 5

Progressive Disclosure

Clear sectioned overview (Rule / Why / How / Exceptions / Don't / Related Skills / References) with a single, well-signaled one-level-deep reference — `references/legacy-client-fetch-audit-2026-06-03.md` — which exists in the bundle and is described in place ('known legacy cleanup targets found when this rule was added'). Content is appropriately split: the SKILL.md holds the rule, the audit detail lives in the reference, and related skills are named for navigation.

5 / 5

Total

18

/

20

Passed

Description

78%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 tight, well-formed description: explicit 'Use when' trigger guidance with a concrete list of client-side surfaces, clear domain, third-person voice, and no fluff. Its only real weakness is that it describes the rule surface rather than concrete actions, which slightly limits specificity.

Suggestions

Add one or two concrete verbs to the capability statement, e.g. 'Route browser/client calls through named methods and hooks instead of raw fetch. Use when wiring...'.

Include high-frequency developer phrasings such as 'fetch calls', 'API calls', or 'client hooks' in the trigger list to broaden natural-term coverage.

DimensionReasoningScore

Specificity

"Client method surface rules" names the domain and declares the skill type, and the trigger list enumerates concrete surfaces ("actions, application state, framework routes, app APIs, uploads, auth, or settings"), but the description itself states no concrete actions the skill performs — it is a capability statement, not an action list. It matches 'Names domain and 1-2 concrete actions, but not comprehensive' more than score 2 because the enumerated trigger surfaces are specific rather than generic, and it falls short of 4 because no operative actions (e.g., 'wrap raw fetch calls in named helpers', 'migrate route calls to action hooks') are listed.

3 / 5

Completeness

It explicitly answers both: what — "Client method surface rules"; when — "Use when wiring browser/client code to actions, application state, framework routes, app APIs, uploads, auth, or settings". The 'Use when' clause is explicit with concrete trigger phrases, matching the score-5 anchor exactly; it is not 4 because the trigger guidance is already specific and multi-faceted rather than merely adequate.

5 / 5

Trigger Term Quality

Natural terms a developer would say are present: "browser/client code", "actions", "application state", "framework routes", "uploads", "auth", "settings". This matches 'Good keyword coverage; a few natural terms missing' — common variations like "fetch calls", "API calls", "client hooks", or specific hook names are absent, keeping it below the synonym-and-extension coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The niche (client method surface rules for wiring browser code) is clear and distinct with domain-specific triggers. It is not 5 because broad trigger words like "auth", "settings", and "uploads" could plausibly fire for other skills covering those areas, creating minor overlap risk with closely related skills.

4 / 5

Total

16

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
BuilderIO/agent-native
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.