CtrlK
BlogDocsLog inGet started
Tessl Logo

server-plugins

Framework server plugins and the `/_agent-native/` route namespace. Use when adding a custom server plugin, deciding whether to create an `/api/` route vs an action, or debugging auto-mounted framework routes.

67

Quality

82%

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

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, well-organized reference of framework routes and routing rules, but it stops at decision guidance without a concrete example of authoring a custom plugin or action, and its decision flow lacks explicit checkpoints.

Suggestions

Add a minimal executable example of creating a custom server plugin (file path under server/plugins/ plus a small definePlugin code template) so the "add a custom server plugin" trigger has copy-paste-ready guidance.

Tighten the route-vs-action decision into an explicit numbered workflow with a checkpoint (e.g., 1. inspect actions/, 2. does an action already encode the rule?, 3. only then add a /api/ route for uploads/streaming/webhooks/OAuth).

Consider moving the large auto-mounted routes table into a references/ file if the skill grows, keeping SKILL.md as a concise overview that links one level deep.

DimensionReasoningScore

Conciseness

Dense tabular reference with no padding and no explanation of concepts Claude already knows; every section earns its place.

3 / 3

Actionability

Gives concrete route paths, plugin names, and decision rules, but lacks a code template or file-structure example showing how to actually create a custom server plugin or action.

2 / 3

Workflow Clarity

A loose decision flow exists ("inspect existing action files... reuse... or add a new action"), but it is informal with no explicit checkpoints; no rigorous sequenced workflow is presented.

2 / 3

Progressive Disclosure

Well-organized into clear sections and tables with no bundle files to reference; cross-links to related skills are clearly signaled.

3 / 3

Total

10

/

12

Passed

Description

92%

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, specific description with an explicit Use-when trigger and concrete task scenarios; its only weakness is overlap with the `actions` skill on the route-vs-action decision.

DimensionReasoningScore

Specificity

Names concrete tasks — "adding a custom server plugin", "deciding whether to create an `/api/` route vs an action", "debugging auto-mounted framework routes" — rather than vague language.

3 / 3

Completeness

Explicitly states what ("Framework server plugins and the `/_agent-native/` route namespace") and when ("Use when adding a custom server plugin, deciding whether to create an `/api/` route vs an action, or debugging auto-mounted framework routes").

3 / 3

Trigger Term Quality

Uses natural domain terms a user of this framework would say ("server plugin", "/api/ route", "action", "framework routes") with good coverage of the relevant variations.

3 / 3

Distinctiveness Conflict Risk

The `/_agent-native/` namespace is distinctive, but the trigger "deciding whether to create an `/api/` route vs an action" overlaps with the related `actions` skill, creating some conflict risk.

2 / 3

Total

11

/

12

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.

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