test-workflow

test-workflow is a skill for Claude Code, Codex from anatolykoptev/n8n-mcp-agent. It costs 17 tokens per session (2,836 once invoked), scanned A, original, MIT.

A testing skill for n8n workflows, which are visual automation processes that connect services and run tasks. It supports testing through a webhook or through a separate test-runner workflow.

In plain words
What is it for?
Setting up an n8n test runner, testing workflows by ID, and testing workflows triggered by webhooks or sub-workflow calls.
Why use it?
It gives workflows a repeatable way to be tested instead of relying on manual runs. It also supports workflows that start on schedules or manual triggers by adding a testable trigger.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Setting up an n8n test runner, testing workflows by ID, and testing workflows triggered by webhooks or sub-workflow calls.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/anatolykoptev/n8n-mcp-agent/test-workflow
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add anatolykoptev/n8n-mcp-agent --skill test-workflow
Clone the repo
git clone --depth 1 https://github.com/anatolykoptev/n8n-mcp-agent

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for test-workflow

README.md
[![agentmods](https://agentmods.dev/badge/skills/anatolykoptev/n8n-mcp-agent/test-workflow/github.svg)](https://agentmods.dev/skills/anatolykoptev/n8n-mcp-agent/test-workflow)
Your own site
<a href="https://agentmods.dev/skills/anatolykoptev/n8n-mcp-agent/test-workflow"><img src="https://agentmods.dev/badge/skills/anatolykoptev/n8n-mcp-agent/test-workflow/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for test-workflow

Your own site · 80×15
<a href="https://agentmods.dev/skills/anatolykoptev/n8n-mcp-agent/test-workflow"><img src="https://agentmods.dev/badge/skills/anatolykoptev/n8n-mcp-agent/test-workflow.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 17 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,836 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00017 $0.02836
Opus 5 $0.00009 $0.01418
Sonnet 5 $0.00003 $0.00567
Haiku 4.5 $0.00002 $0.00284

Measured 9d ago against content hash 7d0c08487144, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

test-workflow scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

The scan reads SKILL.md. This mod also ships 4 executable files (scripts/add-subworkflow-trigger.sh, scripts/create-sample-workflow.sh, scripts/setup-test-runner.sh, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

│ curl .../workflows/<ID> │
skills/test-workflow/SKILL.md · 352 lines

How it starts

The opening of the file, as written. The whole thing — 352 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Test Workflow Skill

Universal testing solution for n8n workflows. Supports two patterns:

  1. Direct Webhook - for workflows with Webhook trigger
  2. Test Runner - for workflows with Execute Sub-workflow Trigger

Quick Start

1. Configure Environment

Create or update .env in the n8n-mcp-agent root:

N8N_URL=https://your-n8n-instance.com
N8N_API_KEY=your-api-key
TEST_RUNNER_PATH=test-runner  # optional, default: test-runner

2. Setup Test Runner (one-time)

./scripts/setup-test-runner.sh

This creates a universal Test Runner workflow on your n8n instance.

3. Test Workflows

# Pattern 1: Direct webhook (for workflows with Webhook trigger)
./scripts/test-workflow.sh <workflow_id>

# Pattern 2: Test Runner (for workflows with Execute Sub-workflow Trigger)
./scripts/test-workflow.sh --runner <workflow_id>

Scripts

Script Purpose When to Use
setup-test-runner.sh Create Test Runner workflow First time setup on new n8n instance
test-workflow.sh Test any workflow Always - main testing script
add-subworkflow-trigger.sh Add testable trigger to workflow If workflow has Manual/Schedule Trigger
create-sample-workflow.sh Create sample testable workflow For testing the setup

AI Agent Decision Flow

User asks: "Test workflow <ID>"
           │
           ▼
┌─────────────────────────────┐
│ 1. Get workflow details     │
│    curl .../workflows/<ID>  │
└─────────────┬───────────────┘
              │
              ▼
┌─────────────────────────────┐
│ 2. Check trigger type       │
└─────────────┬───────────────┘
              │
    ┌─────────┴─────────┬────────────────┬──────────────────┐
    │                   │                │                  │
    ▼                   ▼                ▼                  ▼
┌────────┐      ┌──────────────┐  ┌─────────────┐   ┌──────────────┐
│Webhook │      │ExecuteWorkflow│  │ManualTrigger│   │ScheduleTrigger│
│Trigger │      │Trigger        │  │             │   │              │
└───┬────┘      └──────┬───────┘  └──────┬──────┘   └──────┬───────┘
    │                  │                 │                  │
    ▼                  ▼                 ▼                  ▼
┌────────┐      ┌──────────────┐  ┌─────────────────────────────┐
│Pattern1│      │ Pattern 2    │  │ RUN: add-subworkflow-       │
│Direct  │      │ Test Runner  │  │      trigger.sh <ID>        │
└───┬────┘      └──────┬───────┘  │ Then use Pattern 2          │
    │                  │          └──────────────┬──────────────┘
    ▼                  ▼                         │
┌────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────┐
│ 3. Run test                 │
│    test-workflow.sh ...     │
└─────────────────────────────┘

Read the full file on GitHub · 352 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 352 lines · 17 tokens per session scan A 7d0c08487144

Subscribe to this mod's changes

test-workflow is a skill published in the GitHub repository anatolykoptev/n8n-mcp-agent (0 stars, last pushed 6mo ago), licensed MIT. It adds 17 tokens to every session and 2,836 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

agent-builder

Load before calling build-agent for a new or existing n8n Agent. Governs prerequisite creation, faithful handoff of the user's request, agent targeting across turns, builder questions, testing, and publishing. Use directly for routine follow-ups when the conversation already targets an Agent; rerun intent-recognition…

n8n-io/n8n · 73 tokens

config-evals

Builds and maintains configuration-based evaluations on a workflow with the eval-config tool. Use when the user asks to set up, add, view, change, or remove an evaluation, score, grade, or judge a workflow's output, or measure answer quality against a test dataset. This is the only eval form Instance AI handles — it…

n8n-io/n8n · 80 tokens

n8n-workflows

Use when n8n workflow automation — nodes, triggers, expressions, credentials, webhooks, error handling. Use when working with n8n workflows.

oyi77/1ai-skills · 37 tokens

n8n-workflow-testing-fundamentals

Comprehensive n8n workflow testing including execution lifecycle, node connection patterns, data flow validation, and error handling strategies. Use when testing n8n workflow automation applications.

summarybotng/summarybot-ng · 45 tokens

api-testing

Testing patterns for MCP tool/resource handlers using createMockContext and Vitest. Covers mock context options, handler testing, McpError assertions, format testing, Vitest config setup, and test isolation conventions.

cyanheads/workflows-mcp-server · 46 tokens

field-test

Exercise tools, resources, and prompts against a live HTTP server via MCP JSON-RPC over curl. Starts the server, surfaces the catalog, runs real and adversarial inputs, and produces a tight report with concrete findings and numbered follow-up options. Use after adding or modifying definitions, or when the user asks to…

cyanheads/workflows-mcp-server · 76 tokens