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

70

Quality

88%

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 body is an unusually thorough and genuinely actionable classifier: ordered steps, explicit re-check loops, concrete tool calls, and a rich example set leave little ambiguity about how to classify or route any request. Its two real weaknesses are redundancy across the Decision Steps, Signals, and Gotchas sections, and a fully monolithic single-file layout where the example catalog and migration notes would load better as one-level-deep references.

Suggestions

Move the ~110-line Examples catalog (and the old-taxonomy migration notes) into a references/ file (e.g. EXAMPLES.md) and keep 4–5 representative examples inline with a clearly signaled pointer, shrinking SKILL.md's always-loaded footprint.

De-duplicate rules stated in multiple sections: keep the degenerate-shell check, Chat Trigger rule, and unsupported-capability handling in exactly one place (Decision Steps or Gotchas, not both) and cross-reference the other.

Tighten the Signals section by merging overlapping items (e.g. the scheduled-judgment and proactive/recurring entries already reference each other) and trust the examples to carry the distinctions they currently restate.

DimensionReasoningScore

Conciseness

The ~480-line body contains no filler or explanations of concepts Claude already knows, but it is noticeably redundant: the degenerate-shell check appears in Decision Step 8 and again in Gotchas, unsupported channels are covered in both Signals and Gotchas, the Chat Trigger rule is stated in Signals and twice in Gotchas, and the 20+ Examples largely restate signals already defined. This fits the 3 anchor (mostly efficient, could be tightened) better than 2, since the excess is overlap rather than padding or over-explanation.

3 / 5

Actionability

Guidance is fully executable for an instruction-only skill: ordered decision steps ("0. If the user is mid-build … apply context continuity", steps 1–9), concrete tool calls ("call `agent-context` with `type: "capabilities"` before classifying", "The immediate next routing action is to load `agent-builder`", "pass `executionIntent: "one-off"` to `build-workflow`"), a copy-ready output-format block, and 20+ worked request→classification examples covering the common cases. This matches the 5 anchor; nothing remains abstract.

5 / 5

Workflow Clarity

The classification procedure is a clearly sequenced 0–9 step flow with explicit checkpoints and feedback loops: needs-clarification loops back to the user for the single missing detail, step 8 mandates re-running the degenerate-shell check mid-build ("stop and re-anchor instead of finishing the degenerate workflow"), and compound requests fan out per part. This matches the 5 anchor — clear sequence, explicit validation-style checkpoints, and error-recovery loops.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so all content — including ~110 lines of Examples, the taxonomy-migration notes, and the Gotchas catalog — is inlined in a single long SKILL.md. Section headers are clear and navigation is easy, but content that clearly belongs in one-level-deep reference files (especially the Examples catalog) is inline with no reference split at all, which fits the 3 anchor rather than the 4 anchor of mostly-appropriate placement.

3 / 5

Total

16

/

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.

The description is a strong, third-person, trigger-rich statement of a classification skill: it defines both decisions concretely, gives explicit positive and negative load conditions, and disambiguates routing precedence. Its only weakness is reliance on internal vocabulary (anchor, embeds_other) over natural user phrasings, which slightly limits trigger-term recall.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions: two named decisions with their full value sets (workflow-anchored, agent-anchored, needs-clarification, out-of-scope; embeds_other in both directions) plus routing behavior ("An explicit Agent request routes to agent-builder before ask-user"). Coverage is comprehensive for this skill's scope, so it fits the 5 anchor rather than the 4 anchor with gaps.

5 / 5

Completeness

It explicitly answers both questions: what ("Classifies automation requests using two decisions: anchor … 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 … one-off questions or reports … requests that need clarification"), with a negative trigger ("Do not load for routine edits or extensions"). This matches the 5 anchor of concrete trigger phrases for both what and when.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ("automation request", "compound requests", "independent automations introduced mid-build", "one-off questions or reports that need external systems you cannot query directly", "requests that need clarification"), but "anchor" and "embeds_other" are internal jargon and common user phrasings like "build me an agent" or "automate this" are only implied. Good coverage with a few natural terms missing — the 4 anchor, not the 5 anchor of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche (classifying automation intent between workflow, agent, clarification, and out-of-scope) is distinct, and explicit exclusions ("Do not load for routine edits or extensions when the conversation already targets a workflow or Agent") plus a precedence rule ("An explicit Agent request routes to agent-builder before ask-user") minimize overlap with sibling builder skills. Minimal conflict risk — the 5 anchor.

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.

Validation — 16 / 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.