CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

adding-a-feature

The four-area checklist every new feature must complete. Use when adding any feature, integration, or capability to ensure the agent and UI stay in parity.

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/adding-a-feature/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 dense, high-signal checklist with concrete API names, an executable code snippet, sequenced areas, and a closing verification checklist. Its weaknesses are minor: some wordy repeated passages, inline detail that could be split into reference files, and verification questions without error-recovery guidance.

DimensionReasoningScore

Conciseness

Nearly all content is project-specific knowledge Claude cannot know (useChangeVersions, defineAction, ownableColumns, initialToolNames), so there is no generic-concept padding; every major section carries unique rules. Minor over-explanation remains — the real-time-sync pointer is repeated twice in section 1, and the provider-api/credential/wizard paragraphs are wordy — matching the 'efficient; minor instances that could be trimmed' anchor rather than 5's 'every token earns its place'.

4 / 5

Actionability

Guidance is fully concrete: named hooks and modules (useActionQuery, useChangeVersions from @agent-native/core/client/hooks), a copy-paste-ready TSX snippet, named actions and commands (pnpm action view-screen), exact helper signatures (defineAppRoles, registerShareableResource), and three worked examples covering common cases (mail, forms, analytics). Per the code-vs-instruction note, an instruction-only skill scores on concrete guidance, which is fully executable here; not below 5 because no pseudocode or vague direction appears.

5 / 5

Workflow Clarity

The sequence is explicit — a scope-check gate first, then the four areas 'in order' (UI → Action → Skills/Instructions → App-state sync), then a six-question Verification checklist, which satisfies the validation requirement for a batch/destructive-adjacent workflow. Not 5 because the verification questions lack feedback-loop guidance (what to fix and re-check when an answer is 'no') — the 'minor validation gaps' of anchor 4; not 3 because validation checkpoints are explicit and present, not implicit.

4 / 5

Progressive Disclosure

No bundle files exist, and the body is well-sectioned with clearly signaled one-level-deep pointers to sibling skills (real-time-sync, sharing, performance, agent-native-docs, actions) that keep this file an overview. However, substantial detail that could live in reference files is inlined (real-time query paths, provider-api patterns, chat prompt dispatch readiness gates), matching anchor 4's 'most content appropriately placed; minor organization gaps' rather than 5's clean split.

4 / 5

Total

17

/

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 is concise, uses third person, and pairs an explicit 'Use when...' clause with a distinctive parity framing. Its main weakness is that the 'what' stays at the checklist-meta level without naming any of the four areas or concrete capabilities, which limits specificity and completeness. Trigger terms are natural but could cover more variations.

Suggestions

Name the four areas in the description (e.g., UI component, action, agent instructions, app-state sync) so the 'what' is concrete rather than a meta-reference to a checklist.

Add one or two natural trigger variations users might say, such as 'new screen', 'new page', or 'new capability', to broaden natural keyword coverage.

Tighten the 'when' clause to distinguish this umbrella checklist from overlapping skills (e.g., specify it applies to features that add app data or agent-visible operations, mirroring the body's scope check).

DimensionReasoningScore

Specificity

The description names its domain ("the four-area checklist every new feature must complete", "ensure the agent and UI stay in parity") but does not enumerate the concrete actions or areas involved. It matches the anchor of naming the domain with 1-2 concrete actions without comprehensive coverage — not 4 because no several specific actions are listed, not 2 because 'four-area checklist' and 'agent and UI stay in parity' are concrete rather than generic.

3 / 5

Completeness

It has both an explicit 'what' ("The four-area checklist every new feature must complete") and an explicit 'when' ("Use when adding any feature, integration, or capability"). Not 5 because the 'what' does not enumerate what the four areas are, keeping trigger phrase coverage less concrete than the anchor's fully-enumerated example; not 3 because the 'when' clause is present and explicit rather than weakly implied.

4 / 5

Trigger Term Quality

It includes natural phrases a developer would say — "adding any feature, integration, or capability" — plus the distinctive "parity" framing. Good keyword coverage with a few natural terms missing (e.g., 'new screen', 'new page', 'build'); not 5 because common variations users might say are absent, not 3 because the present terms go beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

"ensure the agent and UI stay in parity" is a distinctive niche marker that separates it from generic build skills, and the trigger scope is appropriate for an umbrella checklist. Minor overlap risk remains with closely related skills (actions, build-an-app) whose triggers also fire on feature work — matching the 'mostly distinct; minor overlap' anchor rather than the fully-clear-niche of 5 or the moderate-overlap of 3.

4 / 5

Total

15

/

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

Path

.agents/skills/adding-a-feature/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.