CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

81%

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

78%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, highly actionable ownership policy: concrete commands, exact API signatures, and explicit checklists with verification steps. Its main weakness is organization — deep settings and design-system reference detail is inlined in the single-file overview instead of being split into referenced files, and related guidance is spread across multiple sections.

Suggestions

Move the reference-grade detail into bundle files (e.g. references/toolkit-settings.md for the settings page-id catalog and SettingsTabsPage prop semantics, and a design-system reference for the nine leaf and eight behavior component lists), keeping SKILL.md as an overview with one-level-deep, clearly signaled links.

Consolidate the settings guidance currently spread across "Agent Surface Contract", "Settings Direction", and "The app's group in Settings" into a single settings section so each rule appears once, and add explicit fix-and-retry feedback loops to the checklists (e.g. what to do when the conformance run fails).

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — nearly every line carries non-obvious internal contracts (route ids, prop semantics, component names) rather than concepts Claude already knows, so it sits above anchor 3. It stops short of anchor 5 because settings guidance recurs across three sections ("Agent Surface Contract", "Settings Direction", "The app's group in Settings") and some advisory prose ("Visual Direction And Workspace Variety") could be tightened.

4 / 5

Actionability

For an instruction-only skill the guidance is fully concrete and executable: copy-paste commands ("agent-native eject --list", "docs-search", "source-search"), exact API signatures ("buildSettingsRoute(page, sub?, { anchor? })", "registerRequiredSecret({ kind: \"api-key\" })", "useLab(LAB_DEFINITION)"), a credential-classification decision table, and named routes and props throughout. Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Two explicit sequenced checklists ("Discover Before Building" steps 1-4 and the nine-step "Implementation Checklist") are present with verification checkpoints ("Run a custom adapter against @agent-native/toolkit/conformance in the app's CI", "verify a real handoff"), matching anchor 4. It is not anchor 5 because validation is endpoint-style and feedback loops for error recovery (fix-and-retry) are absent, though the destructive/batch cap does not apply to this policy skill.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), yet reference-grade detail is inlined in the overview: the settings page-id catalog, SettingsTabsPage prop semantics, and the 17-item design-system component list — content the body itself says belongs in the "toolkit-settings" documentation. Structure and external references are clearly signaled ("Related Skills", named docs), so this fits anchor 3 (good structure, but content that should be separate is inline) rather than 2.

3 / 5

Total

16

/

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 strong description that clearly and explicitly states what the skill provides and when to use it, with a rich set of natural trigger terms in third-person voice. Its only weaknesses are that the 'what' states deliverables rather than concrete actions, and a few trigger terms overlap with related skills.

DimensionReasoningScore

Specificity

The 'what' is limited to "Inventory and ownership rules for shared Agent-Native workspace UI" — it names the domain and its two deliverables but lists no concrete actions, since the enumerated areas ("app chrome, settings, navigation...") are trigger contexts rather than capabilities. This matches anchor 3 (domain plus 1-2 concrete items), not 4 (no list of several specific actions) and not 2 (the domain is precisely named, not generic).

3 / 5

Completeness

It explicitly answers both questions: the 'what' ("Inventory and ownership rules for shared Agent-Native workspace UI") and a fully explicit 'when' ("Use before building app chrome, settings, navigation, sharing...") with ten concrete trigger phrases. This is a clear anchor-5 match rather than 4, since the 'when' clause is specific and multi-trigger, not merely present.

5 / 5

Trigger Term Quality

"app chrome, settings, navigation, sharing, collaboration, setup, history, comments, chat rails, agent UX, or repeated workspace behavior" gives good coverage of natural phrases a user in this workspace would say. It falls short of anchor 5 because each area appears only once — no synonyms or common variations are included.

4 / 5

Distinctiveness Conflict Risk

The niche — deciding whether shared Agent-Native workspace UI belongs in the toolkit or app-locally — is clear with distinct triggers like "chat rails" and "agent UX". Minor overlap risk remains because "sharing", "collaboration", and "setup" also name closely related skills, keeping it at anchor 4 rather than 5.

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

Path

.agents/skills/agent-native-toolkit/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.