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

75%

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/agent-native-toolkit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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, well-structured instruction-only skill with concrete identifiers, commands, and decision rules that make its guidance genuinely actionable. Its weaknesses are the monolithic 320-line body that inlines Settings API reference detail with no bundle files for progressive disclosure, and the absence of explicit failure/feedback loops in its workflows.

Suggestions

Move the Settings implementation contract (page-id inventory, SettingsTabsPage props like generalGroups/appAreas/extraTabs, and the settings.$.tsx splat wiring) into a references/ file, keeping only routing rules and buildSettingsRoute usage in SKILL.md.

Add explicit feedback loops to the Implementation Checklist, e.g., what to do when the conformance-kit verification in step 9 fails or when agent-native eject --list shows no matching unit.

Trim the Agent Surface Contract to ownership-relevant rules and cut restated variations of 'do not duplicate shared surfaces' to reduce token load.

DimensionReasoningScore

Conciseness

The ~320-line body is dense and mostly high-signal with little padding or explanation of concepts Claude already knows, but sections like 'The app's group in Settings' inline reference-grade API detail (e.g., 'appAreas: [{ id, label, content, visible?, keywords?, searchEntries? }]', 'settings.$.tsx' splat wiring, SettingsTabsPage prop semantics) that could be tightened or split out. It is below 4 because of this volume of inline reference material, but above 2 because nearly every sentence carries a non-obvious rule.

3 / 5

Actionability

Concrete, executable guidance is present throughout: 'agent-native eject --list', 'buildSettingsRoute(page, sub?, { anchor? })', 'registerRequiredSecret({ kind: "api-key" })', 'registerSettingsPages([...])', the preflight classification table, and exact file paths like 'packages/core/src/navigation/settings-redirects.ts'. It falls short of 5 because there are no complete copy-paste examples and a few directives remain abstract ('Decide the shared contract').

4 / 5

Workflow Clarity

'Discover Before Building' gives a numbered 1-4 sequence and the 'Implementation Checklist' gives a numbered 1-9 sequence that includes verification checkpoints ('Verify the default adapter and at least one non-Tailwind adapter with the conformance kit'), plus a preflight search step before building setup surfaces. It misses 5 because there are no explicit feedback loops for error recovery (no 'if the conformance run fails, do X').

4 / 5

Progressive Disclosure

The single file has clear, well-organized section headers and signals companion skills ('customizing-agent-native', 'agent-page', 'frontend-design'), but no bundle reference files exist and roughly a hundred lines of Settings page-id tables and prop contracts are inlined monolithically where a one-level-deep reference file would fit. Structure is present, so above 2, but content that should be separate is inline, below 4.

3 / 5

Total

14

/

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 with an explicit 'what' and a concrete, explicit 'Use before building...' trigger clause covering the domain's natural vocabulary. The main gap is action specificity: 'Inventory and ownership rules' is abstract and doesn't preview the concrete decisions or surfaces the skill governs.

DimensionReasoningScore

Specificity

"Inventory and ownership rules for shared Agent-Native workspace UI" names the domain precisely but lists only 1-2 abstract actions; it does not enumerate concrete capabilities such as deciding app-local vs. toolkit ownership or the concrete surfaces covered. It is above score 2 because the domain is exact rather than generic, but below score 4 because several specific actions are not listed.

3 / 5

Completeness

The description explicitly answers both parts: what ("Inventory and ownership rules for shared Agent-Native workspace UI") and when ("Use before building app chrome, settings, navigation, sharing, collaboration, setup, history, comments, chat rails, agent UX, or repeated workspace behavior") with a long list of concrete trigger phrases. Both are explicit and concrete, matching the top anchor.

5 / 5

Trigger Term Quality

"app chrome, settings, navigation, sharing, collaboration, setup, history, comments, chat rails, agent UX, or repeated workspace behavior" provides good natural-keyword coverage users would actually say. It falls short of 5 because some common synonyms and variations (e.g., permissions, members, notifications, onboarding) are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (shared Agent-Native workspace UI ownership), so the skill is mostly distinct, but broad trigger terms like "settings", "sharing", "comments", and "history" create minor overlap risk with the closely related skills this skill itself references. Minimal-conflict score 5 would require more uniquely-scoped triggers.

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.