CtrlK
BlogDocsLog inGet started
Tessl Logo

workflow-builder

Load before calling build-workflow. Default path for all single-workflow work: new one-off workflows, existing-workflow edits, verification repairs, and workflow-local data tables. Write or edit a workspace source file, run workflow-sdk validate via workspace_execute_command, then call build-workflow with filePath. When the workflow creates or writes Data Tables, load data-table-manager first, then this skill. Do not load planning or create-tasks first. Load planning only when multiple coordinated workflows or shared cross-task data tables require a dependency-aware task graph. Don't use this skill for explicit one-off tasks that can be done by a single node execution: load one-off-operations and run the node with nodes(action="execute"). Also load for a workflow's evaluations, model choices, credential setup, and post-build verification: this skill lists the references for those steps.

64

Quality

81%

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

63%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 a highly actionable, deeply validated build procedure with excellent executable examples, but it is roughly twice the length it needs to be due to cross-section duplication, and it inlines substantial reference-grade material while shipping unsubstituted template placeholders at a mandatory decision point. Strong on execution guidance, weak on token efficiency and file organization.

Suggestions

Consolidate the Gateway credits rules (Escalation, Credential Rules, and Gateway credits Preference), the placeholder rules (Placeholders, SDK Code Rules, Workflow Rules 1), and the inserted-node payload semantics (Repair Strategy vs Workflow Rules 7) into single canonical sections, with other mentions reduced to a one-line pointer — this alone would cut a substantial fraction of the duplication.

Move the Expression Reference, SDK Patterns Reference, Gateway credits Enumeration, and data-table diagnostic heuristics into dedicated files under references/ (like the existing error-workflows.md and compositional-workflows.md pattern) so SKILL.md reads as the build process plus pointers.

Resolve or remove the raw template tokens {{GROUPING_GUIDANCE_PLACEHOLDER}} and {{TOP_LEVEL_ITEM_CEILING_PLACEHOLDER}} in the Node Groups and Completion sections — a mandatory build decision (step 6) currently points at criteria that are not present in the file.

DimensionReasoningScore

Conciseness

At 1047 lines / ~8,100 words the body is dense and non-generic (no explanations of concepts Claude already knows), but it duplicates itself: routing rules appear twice ("Do not load planning or create-tasks first" in Routing and again in the same section), Gateway credits rules spread across Escalation, Credential Rules, and a dedicated Gateway credits Preference section, placeholder rules appear in three places, and inserted-node payload semantics are stated in Repair Strategy ("an inserted write/create node replaces the payload flowing into the next node") and again verbatim as Workflow Rules 7. Mostly efficient content that clearly could be tightened — the 3 anchor — rather than padded (not 2) or with only minor trim (not 4).

3 / 5

Actionability

Guidance is nearly fully executable: the exact validate command ("node --import tsx node_modules/@n8n/workflow-sdk/dist/cli/index.js validate <filePath>"), complete TypeScript patterns with correct-vs-wrong wiring examples, exact tool-call signatures, and precise placeholder/locator shapes. It stops short of 5 because "{{GROUPING_GUIDANCE_PLACEHOLDER}}" and "{{TOP_LEVEL_ITEM_CEILING_PLACEHOLDER}}" are unsubstituted template tokens — the grouping criteria and ceiling value the Mandatory Process and Completion sections depend on are literally absent.

4 / 5

Workflow Clarity

The 12-step Mandatory Process has explicit validation (step 7 validate, step 8 build), feedback loops (step 10: edit the same file, re-validate, rebuild), a repair budget ("one repair attempt per unique failure signature"), and a Verification Contract with explicit stop conditions — the destructive/batch validation cap does not apply since validation is present. It misses 5 because the mandatory grouping decision checkpoint (step 6 "See [Node Groups](#node-groups) for the criteria") resolves to a placeholder token with no criteria, and the process is scattered across five interleaved sections (Mandatory Process, Repair Strategy, Escalation, Verification Contract, Completion) that restate one another.

4 / 5

Progressive Disclosure

References are clearly signaled by name and all resolve to real bundle files ("load the `error-workflows` reference", "load the `compositional-workflows` reference", "follow `model-selection`", "load the `credential-recipe-research` skill" — each exists in references/), and the 41KB post-build flow is properly externalized. But the body itself is a 1000-line monolith carrying Expression Reference, SDK Patterns Reference, Gateway credits enumeration, and data-table query heuristics that belong in reference files, and reference chains run two levels deep (SKILL.md → post-build-flow.md → trigger-input-data-shapes.md / config-evals.md). Some structure, but content that should be separate is inline — the 3 anchor.

3 / 5

Total

14

/

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 routing description: it states concrete what/when for every covered work type, gives explicit exclusions against neighboring skills, and names the exact three-step build path. Its only weakness is trigger phrasing written more for an orchestrator than for natural user keywords.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Write or edit a workspace source file, run workflow-sdk validate via workspace_execute_command, then call build-workflow with filePath" — and covers every work type in its scope (new one-off workflows, existing-workflow edits, verification repairs, workflow-local data tables, evaluations, model choices, credential setup, post-build verification). Coverage is comprehensive rather than minor-gap, so it fits the 5 anchor over the 4 anchor.

5 / 5

Completeness

Both questions are answered explicitly: what ("Write or edit a workspace source file, run workflow-sdk validate ... then call build-workflow with filePath") and when ("Default path for all single-workflow work: new one-off workflows, existing-workflow edits, verification repairs..." plus "Also load for a workflow's evaluations, model choices, credential setup, and post-build verification"), with explicit exclusions on top.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "new one-off workflows", "existing-workflow edits", "verification repairs", "data tables", "model choices", "credential setup", "post-build verification". It falls short of 5 because the phrasing is orchestrator routing language with internal tool names ("workspace_execute_command", "nodes(action=\"execute\")") and lacks synonyms for casual user phrasings.

4 / 5

Distinctiveness Conflict Risk

The description actively de-conflicts against sibling skills: "Do not load planning or create-tasks first", "Load planning only when multiple coordinated workflows ... require a dependency-aware task graph", "Don't use this skill for explicit one-off tasks ... load one-off-operations", and "load data-table-manager first, then this skill". A clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

19

/

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