n8n PRD Generator

Claude Code skill that generates structured PRD documents for n8n automation workflows. Guides you through structured requirements gathering before building with n8n-mcp.

Installation

/install-skill https://github.com/AlexPEClub/n8n-prd-generator.git

What it does

Instead of jumping straight into building n8n workflows, this skill walks you through a structured process:

1. Understand - Describe your automation in any format (free text, bullet points, meeting notes)
2. Clarify - Targeted questions about trigger, data flow, services, error handling, and credentials
3. Generate - A complete PRD document saved as prd-[name].md in your project

The generated PRD covers:

• Trigger & schedule configuration
• Data flow (input → processing → output)
• Services & credential status
• Recommended node architecture with specific n8n node types
• Error handling per service
• Known n8n pitfalls (expressions, data structures, aggregation)
• Acceptance criteria

Why use a PRD?

Building n8n workflows with Claude Code + n8n-mcp works best when requirements are clear upfront. Without a PRD, common issues include:

• Missing aggregation steps (getting 20 emails instead of 1)
• Wrong data structure assumptions (e.g. $json.id vs $json.id.videoId)
• Deprecated patterns (continueOnFail instead of onError)
• Missing error handling for external API calls

This skill captures all of that before a single node is created.

Requirements

• Claude Code CLI or VSCode extension
• n8n-mcp server configured (for node validation during PRD creation)

Example

You: I need an automation that scores new leads from Brevo and saves them to Google Sheets

Skill: [Asks clarifying questions about trigger, data flow, scoring criteria, credentials...]

Output: prd-brevo-lead-scoring.md

License

MIT