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.