aithos-rr/aithos-selection/n8n-quickstart
Claude Code and agent skill by aithos-rr/aithos-selection
- community
Checking that the SKILL.md file is still in the repository.
Costruisce workflow n8n partendo da una descrizione in linguaggio business (non tecnico). Da attivare quando l'utente dice "automatizza questo su n8n", "crea un workflow che...", "voglio connettere X e Y", "automazione no-code". Wrapper amichevole per non-developer che usa sotto il cofano le 7 skill n8n di czlonkowski/n8n-skills (upstream MIT). Traduce concetti tecnici (Code node, expression, webhook, credentials) in linguaggio business. Include 3 ricette pronte (lead gen, email nurture, social monitoring).
Install
npx vskill@latest install aithos-rr/aithos-selection/n8n-quickstartSKILL.md
The same SKILL.md was published earlier as aithos-rr/aithos-selection/n8n-quickstart.
n8n Quickstart
Wrapper per utenti non-developer che vogliono costruire workflow n8n con Claude Code. Non reinventa le 7 skill n8n di czlonkowski/n8n-skills, ma le eleva:
- Traduce linguaggio business in workflow n8n
- Fornisce 3 ricette pronte (lead gen, email nurture, social monitor)
- Guida setup MCP passo-passo
- Produce un CLAUDE.md del progetto n8n pre-compilato
When to use
Attivare quando:
- L'utente descrive un'automazione: "ogni mattina manda email riassuntiva", "quando arriva un lead, fai X"
- Vuole connettere 2+ tool business (Gmail, Slack, CRM, Sheets, HubSpot)
- Parla di "automazione no-code"
- Ha n8n già attivo (self-hosted, cloud, o desktop) e vuole orchestrarlo con Claude
Non attivare se:
- n8n non è nello stack dell'utente (proporre alternativa: scheduled tasks di Claude Code)
- Task one-shot, non ripetibile
- Serve codice custom pesante (scaffolding di un progetto è meglio di un workflow)
Prerequisiti
Il partecipante deve avere:
- n8n attivo (cloud, self-hosted, o desktop)
- n8n-mcp server installato (guida ufficiale czlonkowski/n8n-mcp)
- Le 7 skill upstream czlonkowski installate:
``text /plugin marketplace add czlonkowski/n8n-skills /plugin install n8n-skills@n8n-skills ``
Se qualcosa manca, la skill stampa le istruzioni di setup e termina.
Instructions
Fase 1 — Scoprire l'intento
Chiedere all'utente via AskUserQuestion:
- Cosa automatizzare? (descrizione 1-2 frasi in linguaggio business)
- Da dove parte? (trigger: cron schedulato, webhook evento, manuale)
- Cosa produce? (output: email, record CRM, messaggio Slack, Sheet aggiornato)
- Quali tool connettere? (lista)
Se la descrizione è troppo ampia ("tutto quello che so"), chiedere di focalizzarsi su un singolo use case concreto.
Fase 2 — Match con una ricetta
Verificare se l'intento matcha una delle 3 ricette in references/recipes.md:
- Lead Gen Pipeline: nuovo lead → enrichment → scoring → CRM + trigger outreach
- Email Nurture Loop: criterio lead → sequenza email automatica con condizioni
- Social Monitor: keyword o competitor → analisi sentiment → report Slack/email
Se match → partire dalla ricetta. Altrimenti procedere alla Fase 3.
Fase 3 — Pattern architettura
Usare la skill upstream czlonkowski/n8n-workflow-patterns per identificare quale dei 5 pattern si applica:
- Webhook (risposta a eventi esterni)
- HTTP API (servizio che risponde a richieste)
- Database (sync o CRUD su DB)
- AI Agent (Claude o altro LLM decide il prossimo step)
- Scheduled (cron periodico)
Fase 4 — Build del workflow
Usare czlonkowski/n8n-mcp-tools-expert per:
- Cercare nodi rilevanti (
search_nodes) - Configurare i nodi (
get_node_info,validate_node) - Creare il workflow (
create_workflow) - Validare (
validate_workflowprofiloruntime)
Mentre si costruisce, tradurre in linguaggio business (dettaglio completo in references/business-jargon-mapping.md):
- Code node → "trasforma i dati in formato X"
- Expression → "formula (come in Excel)"
- Webhook → "endpoint che riceve notifiche"
- Credentials → "accesso al tuo account del servizio X"
Fase 5 — Setup CLAUDE.md del progetto
Generare o aggiornare <progetto>/CLAUDE.md con il template in references/claude-md-n8n-template.md.
Fase 6 — Test e deploy
- Test manuale: eseguire il workflow con un dato di test, verificare l'output
- Dry run: se tocca produzione (CRM, email) usare modalità sandbox prima
- Activate: attivare il trigger cron o webhook solo dopo test OK
- Monitor dei primi run: verificare le prime 5-10 esecuzioni reali
Fase 7 — Troubleshooting
In caso di errori, invocare czlonkowski/n8n-validation-expert per interpretare i messaggi e suggerire fix.
Examples
Esempio 1 — Report settimanale schedulato
Intent: "ogni lunedì alle 9 manda un report settimanale via email al team".
Pattern: Scheduled (nessuna ricetta, è semplice).
Workflow:
- Cron trigger (lunedì 09:00)
- HTTP request verso l'API del CRM (lead nuovi della settimana)
- Code node per formattazione Markdown
- Gmail send al team
CLAUDE.md del progetto: descrive il trigger, l'endpoint CRM, il formato atteso.
Esempio 2 — Lead enrichment pipeline
Intent: "quando arriva un lead da Typeform, arricchiscilo e mettilo nel CRM".
Ricetta: Lead Gen Pipeline (match).
Workflow (pre-costruito nella ricetta):
- Webhook trigger (Typeform submit)
- HTTP request verso provider di enrichment (email verify, company data)
- Code node per scoring
- Nodo CRM → create record
- Slack alert se lo scoring supera una soglia
Esempio 3 — Social monitoring
Intent: "monitora le menzioni del mio brand su LinkedIn, alert se sentiment negativo".
Ricetta: Social Monitor (match).
Workflow:
- Cron (ogni 4 ore)
- Apify LinkedIn scraper via HTTP
- AI Agent (LLM) per sentiment analysis e categorizzazione
- Google Sheet append
- Slack alert solo se menzione negativa
Gotchas
- n8n Python ha limiti: no librerie esterne (no requests, pandas, numpy). Per il 95% dei casi usare JavaScript nel Code node. Fonte:
czlonkowski/n8n-code-python. - Webhook data location: sempre
$json.body, mai$jsondiretto. Errore classico. - Code node return format: deve essere
[{json: {...}}], non{...}diretto. - Credentials: mai hardcoded di API key nel Code node. Usare sempre il credentials manager di n8n.
- Rate limit: ogni servizio ha i suoi limiti. Aggiungere un nodo
Waito retry logic per evitare errori 429. - nodeType format: distinguere
nodes-base.*dan8n-nodes-base.*. Errore comune quando si creano workflow programmaticamente. - Validation profile: usare
runtimedurante lo sviluppo,strictprima di attivare in produzione. - Template > scratch: n8n ha una libreria di template ufficiali molto ampia (n8n.io/workflows). Controllare sempre prima di costruire da zero.
- Scope discipline: questa skill costruisce workflow n8n. Per scripting one-shot senza orchestrazione (script bash, Python ad-hoc, comandi terminal), Claude Code scrive direttamente senza invocare questa skill. n8n introduce complessità di setup che si giustifica solo con workflow ricorrenti.
References
- references/recipes.md: 3 ricette complete (Lead Gen, Email Nurture, Social Monitor)
- references/business-jargon-mapping.md: 30 traduzioni tech → business per spiegare workflow
- references/claude-md-n8n-template.md: template CLAUDE.md per progetti n8n
Skill upstream (requisito): czlonkowski/n8n-skills — 7 skill complementari MIT, maintainer Romuald Członkowski.
_Wrapper su czlonkowski/n8n-skills. Basato su docs Anthropic skills. MIT License._
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/n8n-quickstart/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/aithos-rr/aithos-selection/n8n-quickstart)