CtrlK
BlogDocsLog inGet started
Tessl Logo

n8n-code-javascript

Write JavaScript code in n8n Code nodes. Use when writing JavaScript in n8n, using $input/$json/$node syntax, making HTTP requests with $helpers, working with dates using DateTime, troubleshooting Code node errors, or choosing between Code node modes.

64

Quality

79%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/n8n-code-javascript/SKILL.md

The canonical home for this skill is n8n-code-javascript in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 skill excels at actionability with excellent, executable code examples covering all major n8n Code node use cases, correct/incorrect pattern comparisons, and a useful deployment checklist. However, it is significantly over-long due to repeated content (webhook body nesting appears 3 times, return format shown in multiple sections), basic JavaScript advice Claude doesn't need, and substantial overlap between inlined content and referenced companion files. Trimming redundancy and trusting the companion files would significantly improve token efficiency.

Suggestions

Remove generic JavaScript best practices sections (descriptive variable names, array methods vs loops, filter early) that Claude already knows — focus only on n8n-specific guidance.

Eliminate repeated content: webhook body nesting is covered in 3 separate sections and return format in 2+ sections. Consolidate each topic to one authoritative location.

Trust the companion files: since ERROR_PATTERNS.md and COMMON_PATTERNS.md are referenced, reduce the inline coverage to 1-2 examples each with a clear pointer, rather than duplicating substantial content.

Remove the 'Integration with Other Skills' section which is meta-organizational content that doesn't help Claude write better Code node JavaScript.

DimensionReasoningScore

Conciseness

The skill is significantly verbose at ~400+ lines. It over-explains concepts Claude already knows (e.g., 'Prefer Array Methods Over Loops', 'Use Descriptive Variable Names', 'Filter Early, Process Late' are basic JS best practices). The 'When to Use Code Node' and 'Integration with Other Skills' sections add little actionable value. Many patterns are repeated (webhook body nesting appears 3 times, return format is shown extensively in multiple sections).

2 / 5

Actionability

Every section provides concrete, executable JavaScript code examples. The code is copy-paste ready with correct n8n syntax ($input.all(), $helpers.httpRequest(), DateTime). Both correct and incorrect patterns are shown with clear ✅/❌ markers, covering all common use cases.

5 / 5

Workflow Clarity

The skill provides a clear decision framework for mode selection, a deployment checklist, and well-sequenced patterns. However, it's primarily a single-task skill (writing Code node JS) rather than a multi-step destructive workflow, so validation checkpoints are less critical. The checklist at the end serves as a verification step. Minor gap: no explicit 'test your code' step in a workflow sequence.

4 / 5

Progressive Disclosure

The skill references four supporting files (DATA_ACCESS.md, COMMON_PATTERNS.md, ERROR_PATTERNS.md, BUILTIN_FUNCTIONS.md) with clear 'See:' markers, which is good structure. However, no bundle files are provided, so these references are unverifiable. More importantly, the main file inlines substantial content that overlaps with what the referenced files should contain (e.g., error patterns are detailed here AND referenced to ERROR_PATTERNS.md, common patterns shown here AND in COMMON_PATTERNS.md), suggesting poor content splitting.

3 / 5

Total

14

/

20

Passed

Description

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

This is a strong skill description that clearly identifies its niche (n8n Code nodes), lists specific capabilities, and includes an explicit 'Use when' clause with multiple natural trigger terms. The description is concise, uses third person voice, and provides enough specificity to distinguish it from general JavaScript or other automation platform skills.

DimensionReasoningScore

Specificity

Lists several specific actions: writing JavaScript in n8n Code nodes, using $input/$json/$node syntax, making HTTP requests with $helpers, working with dates using DateTime, troubleshooting errors, and choosing between modes. Minor gaps in comprehensiveness but covers multiple concrete capabilities.

4 / 5

Completeness

Clearly answers both 'what' (write JavaScript code in n8n Code nodes) and 'when' (explicit 'Use when' clause with multiple concrete trigger scenarios including syntax usage, HTTP requests, date handling, troubleshooting, and mode selection).

5 / 5

Trigger Term Quality

Excellent coverage of natural trigger terms users would actually say: 'JavaScript', 'n8n', 'Code node', '$input', '$json', '$node', 'HTTP requests', '$helpers', 'DateTime', 'Code node errors', 'Code node modes'. These are highly specific technical terms that users working in n8n would naturally use.

5 / 5

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: n8n-specific JavaScript coding with platform-specific syntax ($input, $json, $helpers, DateTime). Very unlikely to conflict with generic JavaScript or other automation platform skills.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.