n8n Quick Reference

n8n-conventions

Quick reference for n8n patterns. Full docs /AGENTS.md

Carrerajorge/Hola·0installs1stars

SKILL.md

Full skill instructions

n8n Quick Reference

📚 Full Documentation:

General: /AGENTS.md - Architecture, commands, workflows
Frontend: /packages/frontend/AGENTS.md - CSS variables, timing

Use this skill when you need quick reminders on critical patterns.

Critical Rules (Must Follow)

TypeScript:

Never any → use unknown
Prefer satisfies over as (except tests)
Shared types in @n8n/api-types

Error Handling:

import { UnexpectedError } from 'n8n-workflow';
throw new UnexpectedError('message', { extra: { context } });
// DON'T use deprecated ApplicationError

Frontend:

Vue 3 Composition API (<script setup lang="ts">)
CSS variables (never hardcode px) - see /packages/frontend/AGENTS.md
All text via i18n ($t('key'))
data-testid for E2E (single value, no spaces)

Backend:

Controller → Service → Repository
Dependency injection via @n8n/di
Config via @n8n/config
Zod schemas for validation

Testing:

Vitest (unit), Playwright (E2E)
Mock external dependencies
Work from package directory: pushd packages/cli && pnpm test

Database:

SQLite/PostgreSQL only (app DB)
Exception: DB nodes (MySQL Node, etc.) can use DB-specific features

Commands:

pnpm build > build.log 2>&1  # Always redirect
pnpm typecheck               # Before commit
pnpm lint                    # Before commit

Key Packages

Package	Purpose
`packages/cli`	Backend API
`packages/frontend/editor-ui`	Vue 3 frontend
`packages/@n8n/api-types`	Shared types
`packages/@n8n/db`	TypeORM entities
`packages/workflow`	Core interfaces

Common Patterns

Pinia Store:

import { STORES } from '@n8n/stores';
export const useMyStore = defineStore(STORES.MY_STORE, () => {
  const state = shallowRef([]);
  return { state };
});

Vue Component:

<script setup lang="ts">
type Props = { title: string };
const props = defineProps<Props>();
</script>

Service:

import { Service } from '@n8n/di';
import { Config } from '@n8n/config';

@Service()
export class MyService {
  constructor(private readonly config: Config) {}
}

📖 Need more details? Read /AGENTS.md and /packages/frontend/AGENTS.md

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/Carrerajorge/Hola --skill n8n-conventions

View on GitHub

external/agent_ecosystem/n8n/.claude/skills/n8n-conventions/SKILL.md

skill-creator
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
0 installs
ordercli
Foodora-only CLI for checking past orders and active order status (Deliveroo WIP).
0 installs
weather
Get current weather and forecasts via wttr.in or Open-Meteo. Use when: user asks about weather, temperature, or forecasts for any location. NOT for: historical weather data, severe weather alerts, or detailed meteorological analysis. No API key needed.
0 installs
session-logs
Search and analyze your own session logs (older/parent conversations) using jq.
0 installs

More skills from Carrerajorge

Carrerajorge/Hola

blogwatcher

Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.

1 0

View

Carrerajorge/Hola

imsg

iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.

1 0

View

Carrerajorge/Hola

Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.

1 0

View

Carrerajorge/Hola

vercel-composition-patterns

Composition patterns for building flexible, maintainable React components. Avoid boolean prop proliferation by using compound components, lifting state, and composing internals. These patterns make codebases easier for both humans and AI agents to work with as they scale.

1 0

View

Carrerajorge/Hola

blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

1 0

View

Carrerajorge/Hola

nano-banana-pro

Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).

1 0

View

Carrerajorge/Hola

linear-issue

Fetch and analyze Linear issue with all related context. Use when starting work on a Linear ticket, analyzing issues, or gathering context about a Linear issue.

1 0

View

Carrerajorge/Hola

gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

1 0

View

Carrerajorge/Hola

content-design

Product content designer for UI copy. Use when writing, reviewing, or auditing user-facing text: button labels, error messages, tooltips, empty states, modal copy, placeholder text, confirmation dialogs, onboarding flows, or i18n strings. Also use when the user says /copy, /content, or /ux-copy.

1 0

View

Carrerajorge/Hola

slack

Use when you need to control Slack from OpenClaw via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.

1 0

View

Carrerajorge/Hola