CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

intent-recognition

Load before you build any new kept workflow or Agent. It decides which one to build, or what to ask first. Classifies automation requests using two decisions: anchor (which primitive owns the top-level control flow — workflow-anchored, agent-anchored, needs-clarification, or out-of-scope) and embeds_other (whether the other primitive appears embedded inside — an agent step inside a workflow, or a workflow invoked as an agent tool). Must be used whenever the current turn requires choosing or reconsidering the intent of an automation request, including compound requests, independent automations introduced mid-build, one-off questions or reports that need external systems you cannot query directly, and requests that need clarification before an anchor can be chosen. An explicit Agent request routes to agent-builder before ask_user. Do not load for routine edits or extensions when the conversation already targets a workflow or Agent.

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

77%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.

The content is highly actionable and sequenced as a rigorous, self-checking decision procedure with rich worked examples. Its weaknesses are token efficiency — significant rule repetition across Decision Steps, Signals, and Gotchas — and the absence of any progressive disclosure: everything is packed into one long file instead of splitting examples and signal catalogs into reference files.

Suggestions

Consolidate rules repeated across Decision Steps, Signals, and Gotchas — e.g. the binding explicit-Agent rule and the Chat Trigger/AI Agent node rule each appear 4+ times — into a single authoritative statement with short cross-references.

Move the ~100-line Examples catalog to a references/ file (e.g. examples.md) and keep 6-8 representative cases inline, so SKILL.md serves as a lean overview with one-level-deep references.

Extract the dense parenthetical policy inside the out-of-scope anchor definition (one-off operations, existing resources, agent-entrypoint bridging) into a short dedicated reference or 'one-off operations' subsection, trimming the main anchor list to its core signal.

DimensionReasoningScore

Conciseness

The body is dense and domain-specific with no generic-concept padding, but the same rules are restated many times across sections — the binding-explicit-Agent rule appears in Decision Steps 1 and 9, Scheduled judgment work, False friends, and Gotchas, and the Chat-Trigger rule appears in Signals, Examples, Gotchas, and Output Format — so a ~29KB single file could be tightened considerably.

3 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: a numbered decision procedure (steps 0-9), a Close-pairs table with a copy-paste ask_user question, ~25 worked examples with classifications, an exact output template, and specific tool calls ('call agent-context with type: "capabilities"', 'pass executionIntent: "one-off" to workflow_builder_build_workflow') covering the common cases.

5 / 5

Workflow Clarity

The decision procedure is a clearly sequenced checklist with explicit validation and feedback loops: the degenerate-shell check (step 8) instructs re-running during build ('Re-run this check while building... stop and re-anchor'), step 5 gives a clarify-then-continue loop, and step 0 sets a context-continuity precondition. No destructive or batch operations, so the validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist — the ~100-line Examples catalog, the Signals taxonomy, and the migration mapping are all inlined in a single ~480-line SKILL.md with no references to separate files. Internal section structure is well-organized, but content that would naturally live in reference files is inline, matching the 'could be better organized' anchor rather than the >50-line simple-skill exception.

3 / 5

Total

16

/

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 that explicitly states what it does, when to load it (including a concrete do-not-load boundary), and how it routes to neighboring skills. Its only deductions are second-person phrasing per the rubric's voice rule and missing natural synonyms like 'create'/'assistant'/'bot' among trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('Classifies automation requests using two decisions: anchor... and embeds_other', 'decides which one to build, or what to ask first', 'routes to agent-builder before ask_user') with comprehensive domain coverage, which matches the 5 anchor — but the rubric mandates a 1-point penalty for second-person voice ('Load before you build any new kept workflow or Agent', 'external systems you cannot query directly'), bringing it to 4.

4 / 5

Completeness

Explicitly answers both what ('Classifies automation requests using two decisions: anchor (workflow-anchored, agent-anchored, needs-clarification, or out-of-scope) and embeds_other') and when ('Must be used whenever the current turn requires choosing or reconsidering the intent of an automation request, including compound requests, independent automations introduced mid-build, one-off questions or reports...'), plus negative trigger guidance ('Do not load for routine edits or extensions when the conversation already targets a workflow or Agent').

5 / 5

Trigger Term Quality

Good natural-term coverage ('build any new kept workflow or Agent', 'automation requests', 'compound requests', 'one-off questions or reports', 'requests that need clarification'), but common user synonyms like 'create', 'set up', 'assistant', or 'bot' are missing and much of the vocabulary is internal jargon ('anchor', 'embeds_other', 'top-level control flow') users would not say.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (pre-build intent classification) with distinct triggers and explicit delimitation from neighboring builder skills ('An explicit Agent request routes to agent-builder before ask_user'), so overlap or wrong-skill triggering risk is minimal.

5 / 5

Total

18

/

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

Path

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