inventory

name	inventory
description	Read-only inventory of local n8n workflows — aggregates node-type usage, LLM models, credentials, and trigger types into `docs/INVENTORY.md`. Use when planning new workflows, auditing instance consistency, or onboarding to an existing n8n project.
argument-hint	[--json] [--dry-run]
user-invocable	true
allowed-tools	Bash(node:*), Bash(npx:*)

n8n Workflow Inventory

All work happens in scripts/aggregate.js (colocated). The skill body is short on purpose — read the script's --help for the full flag reference.

How to invoke

Always call the bundled script. Do not improvise grep/awk pipelines.

node "$CLAUDE_PLUGIN_ROOT/skills/inventory/scripts/aggregate.js" [flags]

Flag	Meaning
(none)	Aggregate everything in workflows/**/*.workflow.ts, write docs/INVENTORY.md
--json <path>	Also write a machine-readable JSON twin (e.g. --json docs/inventory.json)
--dry-run	Print the markdown report to stdout, do not write files
--markdown <path>	Override the markdown output path (default docs/INVENTORY.md)
--workspace <dir>	Workspace root (default: current directory)

The script walks workflows/**/*.workflow.ts, extracts:

• Node types (core n8n-nodes-base.*, community @scope/n8n-nodes-*, plain n8n-nodes-*)
• Triggers (anything matching *Trigger, webhook, schedule, chatTrigger, formTrigger, mcpTrigger, manualTrigger, errorTrigger)
• LLM models (literal value: 'gpt-…' / 'claude-…' / 'llama…' / 'gemini…' / 'mistral…' / 'o1…')
• Credentials (credentials: { <type>: …)
• Workflow names (from @workflow({ name: '…' }))

It best-effort calls npx n8nac list --json --include-archived to enrich the Summary header with remote counts; skips that section silently if n8nac is unbound or offline.

Output structure

# n8n Workflow Inventory

## Summary             — local file count + remote total/active/archived
## Trigger Distribution
## Node Usage — Core   — top 30 by count
## Node Usage — Community
## LLM Models          — provider + model + count
## Credentials         — type + count + 3 example workflow names

Companion scripts

• scripts/aggregate.js — the only one. Self-contained Node script, no --strict --json deps, runs anywhere Node ≥ 18 does.