reversa-n8n

Convert exported N8N JSON workflows into System Design Description artifacts.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/maximoseo/github-repos-radar --skill reversa-n8n-maximoseo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-n8n
Source: https://github.com/maximoseo/github-repos-radar/tree/main/.agents/skills/reversa-n8n
Command: npx skills add https://github.com/maximoseo/github-repos-radar --skill reversa-n8n-maximoseo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Reads N8N JSON exports and creates a complete System Design Description (SDD) that describes the workflow, its components, and a porting plan to Python or other languages.

Core Features & Use Cases

  • Extracts nodes, connections, and triggers from N8N workflows to form an architecture description.
  • Generates three artifacts: workflow-overview.md, requirements.md, and design.md, with a structured, vendor-agnostic spec.
  • Prepares handoff artifacts including naming slugs, and an initial state plan to feed downstream pipeline stages.

Quick Start

Place the N8N JSON workflow in n8n_json_workflows/ and run the Skill to generate the SDD artifacts in _reversa_n8n/<slug>/.

Frequently Asked Questions about reversa-n8n

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

FAQPage Schema
How do I convert an exported n8n workflow to Python?▼

To convert an n8n workflow to Python, the system reads exported n8n JSON files and generates a System Design Description spec. This structured architecture description provides a complete porting plan for reimplementing the workflow logic in Python.

What is an SDD spec in the context of n8n workflow architecture?▼

An SDD spec is a vendor-agnostic System Design Description that extracts nodes, connections, and triggers from n8n JSON workflows. It forms a standalone architecture description that can be reimplemented in Python or another language.

How do I document n8n workflows for a language porting process?▼

You document n8n workflows for porting by processing the JSON export to generate structured artifacts including workflow-overview.md, requirements.md, and design.md. These files preserve the architecture details and prepare handoff state for downstream reimplementations.

Does the n8n to SDD conversion process handle credential ambiguities?▼

Yes, the n8n to SDD conversion assesses credential handling, ambiguities, and handoff state for downstream agents. It preserves the original input in a specific directory for traceability while enforcing clear provenance and safety constraints.

Can I use this approach to port n8n workflows to languages other than Python?▼

Yes, you can port n8n workflows to languages other than Python because the generated System Design Description is vendor-agnostic. The structured spec provides a general porting plan that can be followed to reimplement the workflow in various programming environments.