CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-native-docs

How to find version-matched Agent-Native framework docs and source bundled in node_modules. Use before implementing or answering questions about @agent-native/core APIs, generated apps, workspaces, templates, or advanced features.

68

Quality

86%

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

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.

A highly actionable, well-sectioned instruction skill: every workflow comes with exact commands, explicit fallbacks, and a clear docs-vs-source-vs-templates reuse policy. Its main costs are duplicated passages about the headless/app-agent tools and one peripheral section (visual docs blocks) that inflates length without serving the core lookup task.

Suggestions

Merge the two duplicated passages about headless `pnpm agent` / built-in app agent tool availability into one statement in the How section, and drop the second 'From a generated app directory' framing to remove the repeated reader listings.

Move the 'Authoring visual docs blocks' section into a separate reference file (or the framework's own docs slug), since it is a rendering-style guide unrelated to the docs/source lookup workflow.

Make the decision flow explicit as a short ordered list (framework-search → focused reader → corpus install fallback → direct rg fallback), so the sequence currently spread across prose sections is scannable.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — it jumps straight to commands and file paths with no library-primer padding, and every section carries skill-specific knowledge (version-matched sourcing, corpus install, override ladder). Not a 5 due to real redundancy: tool availability is stated twice ("The same tool is available in the headless `pnpm agent` loop and every built-in app agent" vs. "The headless `pnpm agent` loop and built-in app agent also expose... tools") and "From a generated app directory" appears twice with overlapping reader listings.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `pnpm action framework-search --pattern "defineAction"`, `docs-search --slug <slug>`, the corpus install command with the version pin, `rg -n ... node_modules/...`, and a `cp` of a named template file to a named destination. The commands cover the common cases (docs lookup, source grep, template reuse, fallback when the action runner is missing), matching the top anchor.

5 / 5

Workflow Clarity

There is a clear decision sequence — unified `framework-search` first, then focused readers, with explicit fallback branches ("If source-search reports that template source is unavailable, install the matching corpus package...", "If the action runner is unavailable, search the package directly") and an instruction to refine rather than accept truncated results. Not a 5 because the sequencing is implicit across sections rather than laid out as an ordered flow, and the section ordering interleaves fallback and primary paths; not a 3 because checkpoints and error-recovery branches are explicitly present.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the body is a self-contained, well-sectioned ~150-line document with clear headers (Rule, Why, How, Useful Slugs, Don't) — good structure with appropriate placement of most content. Not a 5 because some content is inline that could plausibly live in reference files (the "Authoring visual docs blocks" section and the "Useful Slugs" table are peripheral to the lookup workflow), and the repeated reader/tool listings blur the navigation slightly.

4 / 5

Total

17

/

20

Passed

Description

87%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: it states a concrete what, an explicit 'Use before...' when-clause with framework-specific triggers, and occupies a distinct niche. Voice is appropriately impersonal ('How to find...'), with no fluff or over-claims. The only soft spot is that action coverage is slightly thinner than the body's actual capability set.

DimensionReasoningScore

Specificity

Concrete actions are named — "find version-matched Agent-Native framework docs and source bundled in node_modules" — and the target surface is enumerated ("@agent-native/core APIs, generated apps, workspaces, templates, or advanced features"), matching the 'several specific actions; minor gaps' anchor. Not a 5 because the only verbs are 'find'/'answer questions'; it doesn't enumerate the concrete capabilities (search docs, search source, copy template patterns) that the skill actually delivers.

4 / 5

Completeness

Both questions are answered explicitly: what ("How to find version-matched Agent-Native framework docs and source bundled in node_modules") and when ("Use before implementing or answering questions about...") with concrete trigger phrases. Not a 4 because the 'when' clause is already explicit and trigger-specific, not merely present-with-room-for-improvement.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — "implementing or answering questions about @agent-native/core APIs", "generated apps", "workspaces", "templates", "advanced features" — which a user of this framework would plausibly say. Missing a few natural variations (e.g., "look up framework docs", "Agent-Native", "how does X work"), so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

It names a distinct niche — version-matched @agent-native/core docs bundled in node_modules — with trigger terms specific to that framework, giving it a clear niche with minimal conflict risk against generic documentation or web-search skills. It would not plausibly fire for unrelated skills.

5 / 5

Total

18

/

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.