Oliver
227 lines
14 KiB
HTML
227 lines
14 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<meta name="robots" content="index, follow" />
|
|
<link rel="canonical" href="https://derez.ai/blog/posts/speed-run-n8n-skill.html" />
|
|
<title>Speed Run: Connect Hermes Agent to n8n in 10 Minutes — derez.ai Blog</title>
|
|
<meta name="description" content="Integrate the official n8n skill set into your Hermes Agent and start building automation workflows in under 10 minutes. Free trial included." />
|
|
<meta property="og:type" content="article" />
|
|
<meta property="og:url" content="https://derez.ai/blog/posts/speed-run-n8n-skill.html" />
|
|
<meta property="og:title" content="Speed Run: Connect Hermes Agent to n8n in 10 Minutes" />
|
|
<meta property="og:description" content="Integrate the official n8n skill set into your Hermes Agent and start building automation workflows in under 10 minutes. Free trial included." />
|
|
<meta name="twitter:card" content="summary_large_image" />
|
|
<meta name="twitter:title" content="Speed Run: Connect Hermes Agent to n8n in 10 Minutes" />
|
|
<link rel="preconnect" href="https://fonts.googleapis.com" />
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
|
|
<link href="https://fonts.googleapis.com/css2?family=Inter:opsz,wght@14..32,400;14..32,500;14..32,600;14..32,700&display=swap" rel="stylesheet" />
|
|
<style>
|
|
* { margin: 0; padding: 0; box-sizing: border-box; }
|
|
body {
|
|
background: #08080c;
|
|
color: #e8e8f0;
|
|
font-family: 'Inter', sans-serif;
|
|
line-height: 1.7;
|
|
padding: 40px 20px;
|
|
}
|
|
.container { max-width: 720px; margin: 0 auto; }
|
|
a { color: #00f5ff; text-decoration: none; }
|
|
a:hover { text-decoration: underline; }
|
|
.back { margin-bottom: 32px; display: inline-block; font-size: 0.9rem; color: #888; }
|
|
.back:hover { color: #00f5ff; }
|
|
h1 { font-size: 1.9rem; font-weight: 700; line-height: 1.3; margin-bottom: 12px; }
|
|
.meta { font-size: 0.85rem; color: #888; margin-bottom: 40px; display: flex; gap: 12px; align-items: center; }
|
|
.area-tag {
|
|
display: inline-block;
|
|
background: #f472b6;
|
|
color: #000;
|
|
font-size: 0.75rem;
|
|
font-weight: 700;
|
|
padding: 2px 10px;
|
|
border-radius: 20px;
|
|
text-transform: uppercase;
|
|
letter-spacing: 0.5px;
|
|
}
|
|
.chip-tag {
|
|
display: inline-block;
|
|
background: rgba(0,245,255,0.1);
|
|
color: #00f5ff;
|
|
border: 1px solid rgba(0,245,255,0.3);
|
|
font-size: 0.75rem;
|
|
font-weight: 600;
|
|
padding: 2px 10px;
|
|
border-radius: 20px;
|
|
text-transform: uppercase;
|
|
letter-spacing: 0.5px;
|
|
}
|
|
h2 { font-size: 1.3rem; font-weight: 600; margin: 36px 0 12px; color: #f0f0ff; }
|
|
p { margin-bottom: 16px; color: #c8c8d8; }
|
|
ul, ol { margin: 0 0 16px 24px; color: #c8c8d8; }
|
|
li { margin-bottom: 6px; }
|
|
code { background: #0e0e14; padding: 2px 6px; border-radius: 4px; font-size: 0.9em; color: #00f5ff; }
|
|
strong { color: #f0f0ff; }
|
|
.prereq-group { margin-bottom: 16px; }
|
|
.prereq-group > .group-label { font-weight: 600; color: #f472b6; margin-bottom: 4px; }
|
|
.prompt-box {
|
|
background: #0e0e14;
|
|
border: 1px solid #1a1a24;
|
|
border-radius: 12px;
|
|
padding: 20px 24px;
|
|
margin: 16px 0 24px;
|
|
font-style: italic;
|
|
color: #c8c8d8;
|
|
}
|
|
.prompt-box code { background: #001a18; }
|
|
.pro-tip {
|
|
background: rgba(0,245,255,0.06);
|
|
border-left: 3px solid #00f5ff;
|
|
border-radius: 8px;
|
|
padding: 16px 20px;
|
|
margin: 20px 0;
|
|
font-size: 0.92rem;
|
|
color: #d0d0e0;
|
|
}
|
|
.pro-tip strong { color: #00f5ff; }
|
|
@media (max-width: 600px) {
|
|
body { padding: 24px 16px; }
|
|
h1 { font-size: 1.5rem; }
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div class="container">
|
|
<a class="back" href="https://derez.ai/#blog">← Back to Blog</a>
|
|
<h1>Speed Run: Connect Hermes Agent to n8n in 10 Minutes</h1>
|
|
<div class="meta">
|
|
<span>June 18, 2026</span>
|
|
<span class="area-tag">speed-run</span>
|
|
<span class="chip-tag">hermes</span>
|
|
</div>
|
|
|
|
<h2>Introduction</h2>
|
|
<p>
|
|
n8n is the most widely used open-source workflow automation platform, and its official skill repository on GitHub (<a href="https://github.com/n8n-io/skills?utm_source=derez" target="_blank" rel="noopener">n8n-io/skills</a>) contains 13 expert skills covering the full workflow lifecycle — expressions, sub-workflows, error handling, AI agents, Data Tables, loops, and more. This speed run shows you how to load those skills into your Hermes Agent, connect it to your n8n instance, and have your agent build, validate, and manage automation workflows.
|
|
</p>
|
|
<p>
|
|
No coding, no plugins to build — just clone the repo, point your agent at the skills, and paste your n8n instance credentials via the dashboard. To follow along, grab a <strong>free trial</strong> at <a href="https://derez.ai/#pricing?utm_source=derez">derez.ai</a> and make sure you have an n8n instance running (any plan, Cloud or self-hosted).
|
|
</p>
|
|
|
|
<h2>Prerequisites</h2>
|
|
<p>Before you start, make sure you have your n8n instance credentials ready:</p>
|
|
|
|
<div class="prereq-group">
|
|
<div class="group-label">Integration — n8n Workflow Automation</div>
|
|
<ul>
|
|
<li><strong>n8n URL</strong> — <code>https://n8n.your-instance.com/</code></li>
|
|
<li><strong>n8n API Key</strong> — <code>n8n_api_2a3b4c5d6e7f8g9h0i1j</code></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<h2>Prompt</h2>
|
|
<p>You configure two prompts on the agent's dashboard at <strong>app.derez.ai</strong>. The first connects your agent to the n8n API and loads the official skill set. The second asks for real work.</p>
|
|
|
|
<div class="prompt-box">
|
|
<strong>Prompt 1 — n8n Integration</strong><br /><br />
|
|
Generated by the Derez Dashboard. The integration settings pass your n8n URL and API key to the agent so it can authenticate against the n8n REST API and MCP server.
|
|
</div>
|
|
|
|
<div class="prompt-box" style="margin-top:-8px">
|
|
<strong>Prompt 2 — Hello World — Summarize focus.de</strong><br /><br />
|
|
Create a hello world n8n workflow with two nodes: an RSS Feed Read node that reads <code>https://www.focus.de/</code> and an AI Agent node that summarizes the first article. Use the official n8n skills from n8n-io/skills — load n8n-workflow-lifecycle, n8n-agents, and n8n-node-configuration before you start building. Validate the workflow with validate_workflow, then check the connections object with get_workflow_details. Show me the final node configuration.
|
|
</div>
|
|
|
|
<p>The first prompt authenticates using the credentials you entered in the dashboard integration settings. The second prompt then has your agent build a simple hello world n8n workflow — read the latest headlines from focus.de and summarize them with an AI Agent node. Two nodes, one workflow, real output.</p>
|
|
|
|
<h2>Wrap Up</h2>
|
|
<p>
|
|
In under 10 minutes you connected your Hermes Agent to n8n and loaded the 13 official n8n skills — giving your agent expert-level knowledge of workflow lifecycle, sub-workflow reuse, expression syntax, error handling, credential security, and AI agent patterns. Your agent now builds n8n workflows that follow the same standards the n8n team ships internally.
|
|
</p>
|
|
<p>
|
|
The same approach works for any of the 13 skills: have your agent load <code>n8n-subworkflows</code> when you need reusable patterns, <code>n8n-agents</code> when building LangChain agents in n8n, or <code>n8n-debugging</code> when a workflow breaks. The skill repository is the authoritative reference — your agent reads the actual rules every time.
|
|
</p>
|
|
|
|
<div class="pro-tip">
|
|
<strong>Pro tip:</strong> The n8n-io/skills repo is designed for any coding agent — not just n8n's own Claude Code plugin. Clone it to your Hermes Agent's filesystem and use <code>hermes skill import</code> from the skills directory to register them as local skills. Your agent then loads them automatically when you mention n8n, without needing to reference the GitHub URL each time.
|
|
</div>
|
|
|
|
<p>
|
|
Use coupon code <strong>BLOG950</strong> at checkout to get your first month free — zero risk, full access.
|
|
</p>
|
|
<p>
|
|
<a href="https://derez.ai/#pricing">Deploy your n8n-connected agent now.</a>
|
|
</p>
|
|
|
|
<h2 id="n8n-reference">Standalone n8n Prompt for Hermes Agent</h2>
|
|
<p>Copy this entire prompt into any Hermes agent (derez.ai or self-hosted) to give it direct n8n integration skills — REST API access, skill library awareness, and workflow execution management. Replace the API key with your own n8n instance key.</p>
|
|
|
|
<div class="prompt-box" style="font-style:normal">
|
|
<strong style="color:#00f5ff">## Integrations</strong><br /><br />
|
|
|
|
<strong>### N8N Skills</strong><br />
|
|
Create a skill that integrates with n8n's skill library and REST API.<br /><br />
|
|
|
|
<strong>## Configuration</strong><br />
|
|
<code>N8N_URL=https://n8n.derez.ai/</code><br />
|
|
<code>N8N_API_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJhOTY0NDQ1Ni1hZGUxLTRlZjUtYmE0NC03MjRiZjhhY2JmNGUiLCJpc3MiOiJuOG4iLCJhdWQiOiJwdWJsaWMtYXBpIiwianRpIjoiZTExMTY3YjUtMGU1Yy00MTNhLWI0YzAtNGU5MGYyODFiMzk2IiwiaWF0IjoxNzgxNzcyNzE3LCJleHAiOjE3ODIzNTY0MDB9.g-SG9u7g9sD0lhD6fr6PZKcBs38Eq3p14Yf8yiPXO-U</code><br /><br />
|
|
|
|
<strong>## Skill library</strong><br />
|
|
You have access to n8n's official skill library at <code>https://github.com/n8n-io/skills</code><br /><br />
|
|
At the start of every task, clone or pull the latest version of this repo to discover available skills.<br /><br />
|
|
<code>if [ ! -d /tmp/n8n-skills ]; then<br />
|
|
git clone --depth 1 https://github.com/n8n-io/skills /tmp/n8n-skills<br />
|
|
else<br />
|
|
cd /tmp/n8n-skills && git pull --ff-only<br />
|
|
fi</code><br /><br />
|
|
Read the README.md and INDEX.md files in that repo to understand what skills are available. Each skill has a dedicated directory with a README.md describing its purpose and usage. Choose the most relevant skill(s) for the user's request.<br /><br />
|
|
|
|
<strong>## API basics</strong><br />
|
|
All calls go to <code>{N8N_URL}/rest/...</code> with the header:<br />
|
|
<code>X-N8N-API-KEY: {N8N_API_KEY}</code><br /><br />
|
|
The n8n REST API documentation is available at <code>{N8N_URL}/api/v1/openapi.json</code> — fetch it if you need to discover available endpoints.<br /><br />
|
|
|
|
<strong>### Common operations</strong><br /><br />
|
|
<strong>List workflows:</strong><br />
|
|
<code>curl -s -H 'X-N8N-API-KEY: {key}' '{N8N_URL}/rest/workflows'</code><br /><br />
|
|
<strong>Get a workflow by ID:</strong><br />
|
|
<code>curl -s -H 'X-N8N-API-KEY: {key}' '{N8N_URL}/rest/workflows/<id>'</code><br /><br />
|
|
<strong>List executions:</strong><br />
|
|
<code>curl -s -H 'X-N8N-API-KEY: {key}' '{N8N_URL}/rest/executions'</code><br /><br />
|
|
<strong>List credentials:</strong><br />
|
|
<code>curl -s -H 'X-N8N-API-KEY: {key}' '{N8N_URL}/rest/credentials'</code><br /><br />
|
|
<strong>List tags:</strong><br />
|
|
<code>curl -s -H 'X-N8N-API-KEY: {key}' '{N8N_URL}/rest/tags'</code><br /><br />
|
|
|
|
<strong>## Workflow skill execution pattern</strong><br /><br />
|
|
When a skill from the library maps to a workflow to run:<br /><br />
|
|
1. Read the skill's README.md to understand the inputs, outputs, and workflow structure.<br />
|
|
2. Check if a matching workflow already exists in n8n (use the list endpoint).<br />
|
|
3. If it does, create an execution:<br /><br />
|
|
<code>curl -s -X POST '{N8N_URL}/rest/workflows/<id>/run' \<br />
|
|
-H 'X-N8N-API-KEY: {key}' \<br />
|
|
-H 'Content-Type: application/json' \<br />
|
|
-d '{"data": <input_data>}'</code><br /><br />
|
|
4. If it doesn't, create a new workflow using the skill's specification:<br /><br />
|
|
<code>curl -s -X POST '{N8N_URL}/rest/workflows' \<br />
|
|
-H 'X-N8N-API-KEY: {key}' \<br />
|
|
-H 'Content-Type: application/json' \<br />
|
|
-d '{"name": "<skill-name>", "nodes": [...], "connections": {...}}'</code><br /><br />
|
|
5. Poll execution status:<br /><br />
|
|
<code>curl -s -H 'X-N8N-API-KEY: {key}' '{N8N_URL}/rest/executions/<id>' | jq '.data'</code><br /><br />
|
|
|
|
<strong>## Solved cases log</strong><br />
|
|
After every successful n8n task, append to ~/n8n_solutions.md:<br /><br />
|
|
<code>## <short title> (<date>)<br />
|
|
Goal: <one sentence><br />
|
|
Skill used: <skill path in the library><br />
|
|
Key commands: <the curl | jq pipelines that worked><br />
|
|
Gotchas: <anything non-obvious></code><br /><br />
|
|
Read ~/n8n_solutions.md at task start — if a matching case exists, reuse it directly.
|
|
</div>
|
|
|
|
<p style="margin-top:48px;padding-top:24px;border-top:1px solid #1a1a24;font-size:0.85rem;color:#666;">
|
|
<a href="https://derez.ai" style="color:#00f5ff">derez.ai</a> — Deploy your AI agent in 10 Minutes.
|
|
</p>
|
|
</div>
|
|
</body>
|
|
</html> |