CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-builder

Load immediately after an Agent intent, before the first agent_builder_* call. Governs how you create, configure, test, and publish n8n Agents yourself with the agent_builder_* tools: targeting, prerequisites, initial build, config freshness, interactive setup, models, memory, tools, and reply style. Use directly for routine Agent follow-ups; rerun intent-recognition only when the requested artifact is no longer clear.

Quality

85%

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

88%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, highly operational skill body: concrete tool calls, exact parameters and config shapes, explicit error-recovery loops, and worked example flows. Its only real weaknesses are cross-section redundancy (which costs some token efficiency) and a main file that carries detail which the referenced sibling-skill structure could absorb.

DimensionReasoningScore

Conciseness

The ~675-line body is almost purely operational directives — no explanations of concepts Claude already knows, no tutorial padding — e.g., "Never write empty placeholders, and never wait for setup answers before you write instructions". It fits the 'efficient; minor instances of over-explanation that could be trimmed' anchor: there is noticeable redundancy across sections (the no-re-configure-channel rule after finish_setup appears in both Initial build and Example flows; starter-draft caveats and pending-setup handling are restated in Build workflow and Model selection), and Model selection runs long, but nothing is fluff.

4 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: exact tool invocations ("agent-context({ type: "config" })", "setup_credentials({ target: "agent", credentials: [{ credentialType: "<selected.credentialType>", reason: "Connect Notion MCP" }] })"), exact config shapes ("{ "enabled": true, "storage": "n8n", "observationalMemory": { "enabled": true } }"), named error codes with prescribed responses ("gateway_credits_unavailable", "code: "invalid_model""), and copy-ready example flows. This matches the 'fully executable... specific examples cover the common cases' anchor.

5 / 5

Workflow Clarity

The 11-step Build workflow gives a fully ordered sequence, and error-recovery feedback loops are explicit: "A failed write saves nothing: fix the payload and retry with the same baseConfigHash. A stage: "stale" result carries the current config and configHash: apply your change again to that config and retry once", plus the invalid_model retry loop and per-section "Verify:" checklists. This matches the 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists' anchor.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and detail is delegated one level deep to clearly signaled sibling skills with load triggers ("Load agent-builder-config before your first agent_builder_write_config... call", "Load agent-builder-memory for Episodic... memory"). Structure is good, but the main file is a ~675-line near-monolith that inlines substantial detail (full Model-selection edge-case handling, Memory defaults, channel policy) that could live in the referenced per-topic skills, matching anchor 4 ('most content is appropriately placed; references mostly clear; minor organization gaps') rather than the lean-overview 5 anchor.

4 / 5

Total

18

/

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, concrete description that clearly states what the skill governs and when to load it, with a distinct n8n-agent niche. Its main weaknesses are the second-person voice ("how you create... yourself"), trigger guidance phrased as internal routing rather than user-facing trigger phrases, and a few missing natural synonyms.

Suggestions

Rewrite in third person (e.g., "Creates, configures, tests, and publishes n8n Agents via the agent_builder_* tools, covering targeting, prerequisites, initial build, config freshness, setup, models, memory, tools, and reply style.") to remove the second-person penalty.

Add concrete user-facing trigger phrases, e.g., "Use when the user asks to build, edit, test, or publish an n8n Agent, add tools, channels, memory, or scheduled tasks to an Agent, or continue an existing Agent build."

Include a few natural synonyms users actually say — "AI agent", "assistant", "bot", "make the agent live" — to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Quotes: "create, configure, test, and publish n8n Agents" plus an explicit scope list ("targeting, prerequisites, initial build, config freshness, interactive setup, models, memory, tools, and reply style") — several specific actions with comprehensive topical coverage. It would reach the 5 anchor, but the description is written in second person ("Governs how you create... Agents yourself"), which the judging guidelines penalize by reducing specificity by 1.

4 / 5

Completeness

Both parts are present: the 'what' is concrete ("Governs how you create, configure, test, and publish n8n Agents yourself with the agent_builder_* tools") and the 'when' is explicit ("Load immediately after an Agent intent, before the first agent_builder_* call"; "Use directly for routine Agent follow-ups"). The 'when' is framed as internal routing guidance rather than concrete user trigger phrases (no 'Use when the user asks to build/publish an Agent'), so it matches anchor 4 ('when' could be more explicit or specific) rather than the 5 anchor.

4 / 5

Trigger Term Quality

Quotes: "n8n Agents", "create, configure, test, and publish", "routine Agent follow-ups" — good coverage of the natural phrases a user building an n8n Agent would say. A few common variations are missing (e.g., "AI agent", "assistant", "bot", "make it live", channel/tool names like Slack or Notion), so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

Quotes: "n8n Agents yourself with the agent_builder_* tools" — a clear niche pinned to a specific platform and tool family, with routing hints ("rerun intent-recognition only when the requested artifact is no longer clear") that further reduce mis-triggering. It is clearly distinguishable from generic agent- or workflow-building skills, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (701 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

n8n-io/n8n

Path

packages/@n8n/instance-ai/skills/agent-builder/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.