CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-builder

Load immediately after an Agent intent. Then call build-agent with the user's request after any required orchestrator-owned prerequisites are ready. Agent Builder owns Agent setup and implementation questions. Governs prerequisite creation, faithful handoff, targeting, testing, and publishing. Use directly for routine Agent follow-ups; rerun intent-recognition only when the requested artifact is no longer clear.

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 ./packages/@n8n/instance-ai/skills/agent-builder/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-structured, information-dense routing policy for an instruction-only skill: concrete parameter-level guidance, clearly sequenced prerequisite/handoff workflows with conditional gates, and disciplined scope control on what to forward to the builder. Weaknesses are limited — mild repetition of routing rules, no example call payload or build-agent error path, and reference-shaped subsections kept inline.

DimensionReasoningScore

Conciseness

The body is a dense, imperative policy document with essentially no padding or explanation of concepts Claude already knows — e.g., 'Never infer, invent, expand, recommend, or prescribe implementation details the user did not request'. It misses 5 because a few routing rules are stated multiple times across sections ('Do not call build-agent for these requests. Call build-agent only when the request creates, changes, tests, or publishes an Agent' repeats the Routing section's 'Use build-agent only for Agent artifacts'), which could be tightened.

4 / 5

Actionability

For an instruction-only skill the guidance is highly concrete: exact parameter names and values are given throughout ('pass createNew: true with a different agentRef and name', 'agent-context with type: "capabilities"', 'pass the built workflow in workflowContext'), and edge cases like template kickoffs, unsupported channels, and saved sub-agents are covered with a worked example ('a Slack agent that says hello to me'). It stops short of 5 because no example build-agent call payload is shown and there is no guidance for handling build-agent errors or unexpected builder replies beyond the legacy builderReply case.

4 / 5

Workflow Clarity

The multi-step flow is clearly sequenced: create prerequisites ('Before the first build-agent call, create prerequisites the builder cannot create'), make the first call ('as soon as any required orchestrator-owned prerequisites are ready'), then handle returned artifacts with an explicit re-call loop ('build it, pass it in workflowContext, and call build-agent again so the builder can attach it'), and the saved sub-agent case is a numbered 1-2-3 sequence. Conditional gates act as checkpoints ('Only ask about the channel after agent-context ... shows that the requested channel is unsupported'). It is not 5 because there are no explicit validation/verification checkpoints on outcomes, and it is not 3 because the sequences present are complete with conditional gates rather than missing.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~180-line body is organized into eight clearly titled sections that each address one concern (Routing, Faithful handoff, Prerequisites, Targeting across turns, etc.), with short scannable rules throughout. This is good structure with most content appropriately placed inline for a routing/policy skill. It is not 5 because some self-contained subsections — 'Agent UI labels' and 'Supported channels & unsupported requests' — read as reference material that could live in separate files, a minor organization gap.

4 / 5

Total

16

/

20

Passed

Description

67%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 solidly specific, third-person description with both a clear 'what' and explicit routing-based 'when' guidance, well anchored to concrete tool names. Its main weaknesses are thin natural-language trigger coverage (no synonyms like chatbot or assistant) and trigger phrasing aimed at the orchestrator rather than user-facing trigger phrases, which slightly raises overlap risk with adjacent builder skills.

Suggestions

Add concrete user-facing trigger phrases, e.g., 'Use when the user asks to create, edit, test, or publish an Agent' — this would raise both completeness and trigger term coverage.

Include natural synonyms users would say for Agents (chatbot, assistant, AI agent) so the description triggers on real user wording, not only internal tool names.

Name the adjacent skills it should not be confused with (e.g., 'For read-only Agent questions use agent-context; this skill is for building and changing Agents') to reduce conflict risk with workflow-builder and similar skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions in third person — 'Then call build-agent with the user's request after any required orchestrator-owned prerequisites are ready', 'Governs prerequisite creation, faithful handoff, targeting, testing, and publishing' — giving it a clear set of specific actions within its domain. It falls short of the 5 anchor because 'Governs prerequisite creation' and 'owns Agent setup and implementation questions' state scope rather than additional concrete actions, leaving minor coverage gaps.

4 / 5

Completeness

Both 'what' and 'when' are present: 'Agent Builder owns Agent setup and implementation questions. Governs prerequisite creation, faithful handoff, targeting, testing, and publishing' answers what, and 'Load immediately after an Agent intent' plus 'Use directly for routine Agent follow-ups; rerun intent-recognition only when the requested artifact is no longer clear' provides equivalent explicit trigger guidance, so the missing-'Use when' cap at 3 does not apply. It falls short of 5 because the 'when' is phrased in orchestrator routing terms rather than concrete user-facing trigger phrases (e.g., 'Use when the user asks to create or edit an Agent').

4 / 5

Trigger Term Quality

Relevant keywords are present ('Agent', 'build-agent', 'prerequisites', 'routine Agent follow-ups'), but the description is missing common natural variations and synonyms a user might say — e.g., 'chatbot', 'assistant', 'create an Agent', 'AI agent'. This matches 'Some relevant keywords but missing common variations or synonyms' rather than 4, which would require only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

The description carves a clear tool-anchored niche ('call build-agent with the user's request', 'Agent Builder owns Agent setup and implementation questions', 'rerun intent-recognition') that is mostly distinct from sibling skills. It is not a 5 because it never mentions adjacent skills like workflow-builder or data-tables in the description, leaving minor overlap risk with closely related builder skills.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
n8n-io/n8n
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.