n8n-studio:write-spec

Generate a workflow specification document from analyzed state and user requirements.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/icednut/n8n-studio --skill n8n-studio-write-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: n8n-studio:write-spec
Source: https://github.com/icednut/n8n-studio/tree/main/skills/write-spec
Command: npx skills add https://github.com/icednut/n8n-studio --skill n8n-studio-write-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps n8n-studio agents convert an analyzed workflow state and user intent into a standardized, reviewable specification document so downstream design and TDD development have a reliable source of truth.

Core Features & Use Cases

  • Creates a structured spec document: Writes docs/[project_name]/yyyyMMdd-[feature]/01-spec.md using a fixed template and required sections.
  • Enforces consistency and guardrails: Captures request type, target workflow identifiers (including Execution ID when present), current state bullets, concrete change requirements, explicit constraints, and test-verifiable completion criteria.
  • Sets up artifacts for the 8-step cycle: Ensures the spec is placed in the correct docs directory structure to support subsequent planning/design steps.

Quick Start

Use n8n-studio:write-spec to generate docs with a spec.md by telling an agent: “Write the spec for updating my Slack notification workflow based on the current workflow analysis and these user requirements.”

Frequently Asked Questions about n8n-studio:write-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a specification document for an n8n workflow?

You need to analyze the current workflow state and user requirements to generate a standardized specification document. This creates a spec.md file capturing request context, detailed change requirements, constraints, and test-verifiable completion criteria for n8n workflow planning.

What is a workflow specification document in TDD agent orchestration?

A workflow specification document in TDD agent orchestration is a structured source of truth that defines request context, current state, and test-verifiable completion criteria. It ensures downstream design and TDD development cycles have reliable, reviewable constraints before implementation begins.

How do I structure docs for n8n workflow planning and GitHub PR readiness?

To structure docs for n8n workflow planning and GitHub PR readiness, create a directory structure like docs/[project_name]/yyyyMMdd-feature-summary/ and populate it with a spec.md file. This enforces consistency by capturing target workflow identifiers, constraints, and verifiable completion criteria.

Do I need an Execution ID to write a workflow spec?

You do not need an Execution ID to write a workflow spec if it is absent from the analyzed state. The specification template safely omits the Execution ID field when it is missing, while still capturing target workflow identifiers and constraints to guide safe implementation.

What constraints should I include when generating a spec document for agent orchestration?

When generating a spec document for agent orchestration, you should include default constraints to guide safe implementation, explicit operational limitations, and test-verifiable completion criteria. These guardrails ensure the workflow automation scenarios remain reviewable and safe for downstream TDD development.

Can I alter the section names and format when creating a feature summary spec?

You cannot alter the section names, order, or format when creating a feature summary spec. The generation process requires using a fixed template to ensure consistency across workflow automation documents, maintaining standardized sections for current state bullets and change requirements.