CtrlK
BlogDocsLog inGet started
Tessl Logo

intent-recognition

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. Do not load for routine edits or extensions when the conversation already targets a workflow or Agent.

67

Quality

80%

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/intent-recognition/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 thorough, well-structured classification skill with a clear decision algorithm, rich worked examples, and explicit checkpoints/feedback loops. Its main weakness is conciseness: several rules are restated across Decisions, Signals, and Gotchas, inflating the token budget without adding new guidance.

Suggestions

Consolidate the repeated rules — the Chat Trigger gotcha, cron-as-anchor-neutral point, and degenerate-shell check — into a single authoritative statement in Decisions, then reference it from Signals/Gotchas rather than restating each in full.

Move the lengthy Examples section and the 'Migration from the old taxonomy' notes into a one-level-deep reference file (e.g. references/examples.md), keeping a short representative subset inline in SKILL.md.

Tighten the Signals section by removing intuitive restatements (e.g. 'Reasoning dominates the flow: investigate, decide, act, iterate') that Claude can already infer, retaining only the platform-specific discriminating criteria.

DimensionReasoningScore

Conciseness

The body is substantive platform-specific knowledge rather than generic fluff, but the same rules are restated across sections — the Chat Trigger gotcha, cron-as-anchor-neutral point, and degenerate-shell check each appear in Decisions, Signals, and Gotchas — adding tokens that assume less of Claude's intelligence than necessary. It is mostly efficient but could be tightened by consolidating these repetitions.

3 / 5

Actionability

Provides a concrete executable algorithm in the numbered Decision Steps (0-9), worked input→classification Examples, and a defined Output Format block, giving mostly executable guidance with only minor residual judgment gaps appropriate to a classification skill.

4 / 5

Workflow Clarity

The Decision Steps form a clearly sequenced procedure with explicit checkpoints (step 7 degenerate-shell re-check, step 8 needs-clarification, step 9 tiebreaker) and a genuine feedback loop ('Re-run this check while building... stop and re-anchor'), with the Gotchas acting as a checklist; minor redundancy slightly blurs the checkpoint structure. No destructive/batch cap applies.

4 / 5

Progressive Disclosure

Well-organized into clear sections (Purpose, Inputs, Decisions, Signals, Examples, Gotchas, Output Format) and self-contained with no nested references, but at ~375 lines the extensive Examples and migration notes are candidates for a one-level-deep reference file. No bundle files exist, so structure is judged on the single file's organization, which is good with minor splitting opportunities.

4 / 5

Total

15

/

20

Passed

Description

92%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 highly specific, complete description that states both the classification action and the precise load/avoid conditions, occupying a clearly distinct niche. The only minor gap is that the most colloquial user phrasings ('build a workflow/agent') are not surfaced as explicit trigger terms.

DimensionReasoningScore

Specificity

Names both concrete decisions in full — '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)' — giving comprehensive, specific coverage of the classification space rather than a single vague verb.

5 / 5

Completeness

Explicitly answers both 'what' ('Classifies automation requests using two decisions...') and 'when' ('Must be used whenever the current turn requires choosing or reconsidering the intent of an automation request'), plus a negative trigger ('Do not load for routine edits or extensions when the conversation already targets a workflow or Agent').

5 / 5

Trigger Term Quality

Includes natural trigger phrases like 'compound requests', 'one-off questions or reports that need external systems you cannot query directly', and 'requests that need clarification', but omits the most natural user phrasings ('build a workflow', 'build an agent') that would prompt loading. It sits above the midpoint with good coverage and a few common terms missing.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear, narrow niche — pre-build intent classification between workflow and agent primitives — with explicit routing to downstream builders, making conflict with sibling skills minimal and the trigger set distinct.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.