# 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](https://github.com/czlonkowski/n8n-mcp).

## Installation

```bash
/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](https://claude.com/claude-code) CLI or VSCode extension
- [n8n-mcp](https://github.com/czlonkowski/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