You are an n8n workflow design specialist. You receive a scoped prompt from the orchestrator and operate independently with fresh context.
You are an n8n workflow development specialist. You receive a scoped prompt from the orchestrator and operate independently with fresh context.
You are an n8n workflow completion specialist. You receive a scoped prompt from the orchestrator and operate independently with fresh context.
You are an n8n workflow planning specialist. You receive a scoped prompt from the orchestrator and operate independently with fresh context.
You are an n8n workflow verification specialist. You receive a scoped prompt from the orchestrator and operate independently with fresh context.
Use when the user wants to analyze the trigger input data format of an n8n workflow from a past execution. Triggers on requests like "워크플로우 입력 양식 분석해줘", "Execution ID로 트리거 데이터 양식 파악해줘", "analyze-workflow-input [Execution ID]". Standalone skill - not part of the dev cycle.
This skill should be used when the user asks to "n8n 워크플로우 개발해줘", "n8n 워크플로우 만들어줘", "n8n 워크플로우 기능 추가해줘", "n8n 워크플로우 수정해줘", "n8n 워크플로우 버그 수정해줘", "n8n 워크플로우 고쳐줘", or any request related to creating, modifying, or fixing n8n workflows. This is the main entry point and full orchestrator for the n8n-studio development cycle.
This skill should be used by n8n-studio agents when they need to write the final 04-result.md, download workflow JSONs to the local workflow/ directory, commit all changes to git, and create a GitHub PR.
Use this skill when the user wants to summarize an n8n workflow into a JSON file, analyze workflow node structure, or document what each node does. Triggers on requests like "n8n 워크플로우 요약해줘", "워크플로우 분석해서 JSON으로 저장해줘", "워크플로우 노드 요약 파일 만들어줘", or "summarize workflow [ID]".
This skill should be used when the n8n-studio development cycle reaches the verification phase (7단계), or when the user asks to "n8n 워크플로우 검증해줘", "통합 테스트 실행해줘". Runs integration test scenarios in a RALF loop (up to 3 cycles) and reports failures to the user if all cycles fail.
Uses power tools
Uses Bash, Write, or Edit tools
Has parse errors
Some configuration could not be fully parsed
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Claude Code에서 n8n 워크플로우를 표준화된 8단계 사이클로 개발하기 위한 플러그인입니다.
영문 버전: README.en.md
n8n-studio는 n8n 워크플로우 개발 과정을 자동화하는 Claude Code 플러그인입니다. 요청 분석부터 설계, TDD 기반 개발, 통합 테스트, GitHub PR 생성까지 전 과정을 8단계 사이클로 체계적으로 진행합니다.
발단 → 계획 → 설계 → 개발 → (리팩토링) → 검증 → 마무리
gh) 설치 (PR 자동 생성 사용 시)Claude Code에서 아래 명령어를 실행합니다:
/plugin marketplace add icednut/n8n-studio
/plugin install n8n-studio@n8n-studio
/plugin list
목록에 n8n-studio가 표시되면 설치 완료입니다.
새 워크플로우 개발, 기능 추가, 버그 수정 모두 동일한 방법으로 시작합니다:
/n8n-studio [요청 내용]
또는 Claude에게 직접 말하세요:
슬랙 알림 워크플로우에 DM 기능을 추가해줘
Webhook으로 받은 데이터를 Google Sheets에 저장하는 워크플로우 만들어줘
주문 처리 워크플로우에서 오류가 발생하고 있어. 고쳐줘.
| 단계 | 담당 에이전트 | 내용 |
|---|---|---|
| 1. 요청 분류 | 오케스트레이터 | 신규 개발 / 기능 변경 / 버그 수정 분류 |
| 2. 정보 수집 | 오케스트레이터 | 워크플로우 ID, Execution ID 확인 |
| 3. 계획 (spec) | workflow-planner | 요구사항 구체화 → spec.md 작성, 브랜치 생성 |
| 4. 설계 (design) | workflow-designer | 노드 구성, 데이터 흐름 설계 → design.md, 테스트 파일 작성 |
| 5. 개발 | workflow-developer | TDD로 Code 노드 개발 → n8n 워크플로우 반영 |
| 6. 리팩토링 | workflow-developer | (선택) 불필요한 복잡도 제거 |
| 7. 검증 | workflow-verifier | 통합 테스트 실행, RALF 루프 (최대 3회) |
| 8. 마무리 | workflow-finisher | result.md 작성, 워크플로우 JSON 저장, git commit, PR 생성 |
your-n8n-project/
├── docs/
│ └── 20260410-feature-name/
│ ├── spec.md # 요구사항 명세
│ ├── design.md # 설계 문서
│ ├── test-plan.md # 테스트 계획
│ └── result.md # 작업 결과 요약
└── workflow/
├── test/
│ ├── unit/ # Code 노드 단위 테스트 (.test.js)
│ └── acceptance/ # 통합 테스트 시나리오 (JSON)
└── [domain]/
└── workflow-name.json # n8n 워크플로우 JSON 백업
| 스킬 | 설명 |
|---|---|
n8n-studio:start | 8단계 사이클 메인 오케스트레이터 |
n8n-studio:analyze-workflow | 워크플로우 현재 상태 분석 |
n8n-studio:write-spec | 요구사항 명세서 작성 |
n8n-studio:design | 설계 단계 진행 |
n8n-studio:write-design | 설계 문서 작성 |
n8n-studio:plan-tests | 테스트 시나리오 계획 |
n8n-studio:develop | 개발 단계 진행 |
n8n-studio:develop-code-node | TDD 방식 Code 노드 개발 |
n8n-studio:build-workflow | n8n 워크플로우 생성/수정 |
n8n-studio:refactor | 워크플로우 리팩토링 |
n8n-studio:verify | 검증 단계 진행 |
n8n-studio:run-verification | 통합 테스트 실행 |
n8n-studio:finish | 마무리 단계 진행 |
n8n-studio:summarize-result | 결과 정리 및 PR 생성 |
n8n-studio:summarize-workflow | 워크플로우 노드 구조 분석 및 JSON 요약 파일 생성 |
| 에이전트 | 모델 | 역할 |
|---|---|---|
workflow-planner | Haiku | 요구사항 분석 및 spec.md 작성 |
workflow-designer | Sonnet | 설계 문서 및 테스트 시나리오 작성 |
workflow-developer | Sonnet | TDD 개발 및 n8n 워크플로우 구현 |
workflow-verifier | Haiku | 통합 테스트 실행 및 결과 판단 |
workflow-finisher | Haiku | 결과 정리, git 커밋, PR 생성 |
/plugin marketplace add czlonkowski/n8n-skills
/plugin install n8n-mcp-skills@n8n-mcp-skills
MIT License
이슈 및 PR은 GitHub 저장소에서 환영합니다.
npx claudepluginhub icednut/n8n-studio --plugin n8n-studioUse this agent when you need to design, build, or validate n8n automation workflows. This agent specializes in creating efficient n8n workflows using proper validation techniques and MCP tools integration.\n\nExamples:\n- <example>\n Context: User wants to create a Slack notification workflow when a new GitHub issue is created.\n user: "I need to create an n8n workflow that sends a Slack message whenever a new GitHub issue is opened"\n assistant: "I'll use the n8n-workflow-builder agent to design and build this GitHub-to-Slack automation workflow with proper validation."\n <commentary>\n The user needs n8n workflow creation, so use the n8n-workflow-builder agent to handle the complete workflow design, validation, and deployment process.\n </commentary>\n</example>\n- <example>\n Context: User has an existing n8n workflow that needs debugging and optimization.\n user: "My n8n workflow keeps failing at the HTTP Request node, can you help me fix it?"\n assistant: "I'll use the n8n-workflow-builder agent to analyze and debug your workflow, focusing on the HTTP Request node configuration."\n <commentary>\n Since this involves n8n workflow troubleshooting and validation, use the n8n-workflow-builder agent to diagnose and fix the issue.\n </commentary>\n</example>\n- <example>\n Context: User wants to understand n8n best practices and available nodes for a specific use case.\n user: "What are the best n8n nodes for processing CSV data and sending email reports?"\n assistant: "I'll use the n8n-workflow-builder agent to explore the available nodes and recommend the best approach for CSV processing and email automation."\n <commentary>\n This requires n8n expertise and node discovery, so use the n8n-workflow-builder agent to provide comprehensive guidance.\n </commentary>\n</example>
Claude Code plugin for n8n-as-code. Adds the n8n-architect skill and uses the n8nac CLI as its local knowledge/runtime bridge.
Design complex n8n workflows with AI assistance - loops, branching, error handling
Generate n8n automation workflows from natural language descriptions
Production-grade n8n workflow building skills. Pairs with the official n8n instance-level MCP server to teach Claude how to architect, validate, and ship workflows that work in production.
Claude Code plugin for building, validating, and deploying n8n workflows. Wraps the n8nac CLI (reference 2.3.6) and delegates schema research to the companion plugin `n8n-as-code` by Etienne Lescot.