CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-native-toolkit

Inventory and ownership rules for shared Agent-Native workspace UI. Use before building app chrome, settings, navigation, sharing, collaboration, setup, history, comments, chat rails, agent UX, or repeated workspace behavior.

60

Quality

76%

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 ./community-templates/account-expert/.agents/skills/agent-native-toolkit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 dense, domain-rich instruction skill that assumes Claude's competence and delivers unusually specific product contracts, commands, and verification steps. Its weaknesses are structural rather than informational: everything is inlined in one long file with no reference layer, and a few passages duplicate the frontmatter or each other. Boundary check: progressive_disclosure stays at 3 (not 4) because no content is offloaded to any bundle file, while conciseness and actionability hold at 4 (not 5) due to small redundancies and the absence of API usage examples.

Suggestions

Split catalog material into reference files — e.g. the settings page-id tree and the Reusable Kits inventory into `references/settings.md` and `references/kits.md` — leaving SKILL.md as the decision rules with one-level-deep pointers.

Remove the opening paragraph that repeats the frontmatter trigger list, and fold 'Discover Before Building' into Implementation Checklist step 1 to eliminate the duplicated discovery guidance.

Add one short usage example for the highest-traffic APIs (e.g. a `buildSettingsRoute` call and a minimal `defineDesignSystem` registration) so the concrete guidance reaches copy-paste readiness.

DimensionReasoningScore

Conciseness

The body is dense with product-specific contracts Claude cannot know (`AgentSidebar`, `sendToAgentChat`, the settings page-id catalog, `defineDesignSystem` seam rules) and explains no general concepts, so most tokens earn their place. Minor trimming exists: the opening paragraph restates the frontmatter trigger list verbatim, and 'Discover Before Building' overlaps Implementation Checklist steps 1, 6, and 7. This fits the 4 anchor ('minor instances of over-explanation that could be trimmed') rather than 3, since no section is padded or teaches known material.

4 / 5

Actionability

For an instruction-only skill the guidance is concrete: exact commands (`agent-native eject --list`, `docs-search`, `source-search`), API signatures (`buildSettingsRoute(page, sub?, { anchor? })`, `registerRequiredSecret({ kind: "api-key" })`, `resolveWorkspaceConnectionCredential(s)ForApp`), named files (`packages/core/src/navigation/settings-redirects.ts`, `app/design-system.ts`), and named components (`ChatHistoryRail`, `AgentTabsPage`). It stops short of the 5 anchor because there are no usage examples or snippets for the key APIs and some rules remain abstract ('Keep shell and component tokens semantic').

4 / 5

Workflow Clarity

'Discover Before Building' (4 ordered steps) and the 'Implementation Checklist' (9 ordered steps) are clearly sequenced, and verification checkpoints appear: step 9's conformance-kit check across two adapters plus 'verify an AI handoff produces no stale-index console error'. The skill's operations are decision/refactor guidance rather than destructive or batch operations, so no validation cap applies, but there is no error-recovery loop (what to do when the conformance kit or handoff check fails), which keeps it at 4 rather than 5.

4 / 5

Progressive Disclosure

The entire skill lives in one ~265-line SKILL.md with no references/, scripts/, or assets/ bundle at all. Headers are clear, but catalog material that reads like separate-file reference content is fully inlined: the settings page-id tree, the 14-entry Reusable Kits list, and the Agent Surface Contract. This matches the 3 anchor ('content that should be separate is inline') exemplified by 200 lines of API reference inside the main file; it does not reach 4 because there is no split at all, only cross-skill pointers. The under-50-lines exception does not apply at this length.

3 / 5

Total

15

/

20

Passed

Description

75%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 with an explicit and specific 'Use before building...' trigger clause and a clearly stated domain, weakened mainly by abstract capability language and a broad trigger list that overlaps several dedicated sibling skills. Scoring the boundary: specificity sits at 3 because 'Inventory and ownership rules' describes content categories, not concrete actions; distinctiveness sits at 3, not 4, because the trigger terms are shared with the very skills the body says to read alongside this one.

Suggestions

State concrete actions instead of categories, e.g. 'Decide whether workspace UI belongs in @agent-native/toolkit or the app; catalog reusable kits for settings, sharing, navigation, and agent UX' rather than 'Inventory and ownership rules'.

Scope the trigger list to the ownership/build-location decision (e.g. 'Use when deciding where shared workspace or agent UI should live') so it stops competing with dedicated skills like `sharing`, `audit-log`, and `real-time-collab` for their own triggers.

Add one or two user-natural synonyms for the jargon terms, e.g. 'chat sidebar' alongside 'chat rails' and 'app layout/header' alongside 'app chrome'.

DimensionReasoningScore

Specificity

The description names its domain precisely ('shared Agent-Native workspace UI') and states two functions ('Inventory and ownership rules'), but these are abstract categories rather than the multiple concrete, verbatim actions of a 4-5 anchor. It is a clear what-statement, just not an enumeration of concrete capabilities.

3 / 5

Completeness

Both halves are explicit: the what ('Inventory and ownership rules for shared Agent-Native workspace UI') and the when ('Use before building app chrome, settings, navigation, sharing, collaboration, setup, history, comments, chat rails, agent UX, or repeated workspace behavior'). The when-clause lists concrete trigger areas, matching the 5 anchor; it does not rely on implication like the 4 anchor's 'when could be more explicit'.

5 / 5

Trigger Term Quality

'app chrome, settings, navigation, sharing, collaboration, setup, history, comments, chat rails, agent UX' gives good natural-phrase coverage a developer would actually say before building workspace UI. It falls short of the 5 anchor because several entries lean product-jargon ('chat rails', 'app chrome') and no synonyms or extensions are offered for them.

4 / 5

Distinctiveness Conflict Risk

The first sentence carves a niche (ownership rules for Agent-Native workspace UI), but the trigger list includes 'sharing', 'settings', 'history', 'comments', and 'collaboration', which overlap with the dedicated sibling skills the body itself names (`sharing`, `audit-log`, `real-time-collab`). A user asking to build a sharing surface would plausibly trigger both this and the more specific skill, fitting the 'somewhat specific but could still overlap' anchor rather than the 'minor overlap risk' of 4.

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