Skip to content

docs: Add Cursor setup instructions for n8n skills plugin#29793

Open
DawidMyslak wants to merge 1 commit intomasterfrom
rly-37-introduce-docs-for-using-n8n-skills-inside-cursor
Open

docs: Add Cursor setup instructions for n8n skills plugin#29793
DawidMyslak wants to merge 1 commit intomasterfrom
rly-37-introduce-docs-for-using-n8n-skills-inside-cursor

Conversation

@DawidMyslak
Copy link
Copy Markdown
Contributor

@DawidMyslak DawidMyslak commented May 5, 2026

Summary

Adds setup instructions for using n8n skills in Cursor to the plugin README and updates AGENTS.md with a callout for Cursor users pointing to the setup guide.

Cursor doesn't auto-discover plugins from .claude/plugins/ — users need to register the plugin manually in ~/.claude/plugins/installed_plugins.json. This documents the fix so both agents and developers can find it.

Related Linear tickets, Github issues, and Community forum posts

https://linear.app/n8n/issue/RLY-37

Review / Merge checklist

  • I have seen this code, I have run this code, and I take responsibility for this code.
  • PR title and summary are descriptive. (conventions)
  • Docs updated or follow-up ticket created.
  • Tests included.

Co-authored-by: Cursor <cursoragent@cursor.com>
@DawidMyslak DawidMyslak requested a review from sandra0503 May 5, 2026 13:25
@DawidMyslak DawidMyslak marked this pull request as ready for review May 5, 2026 13:26
@DawidMyslak DawidMyslak requested a review from cstuncsik May 5, 2026 13:27
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 2 files

Architecture diagram
sequenceDiagram
    participant Cursor as Cursor IDE
    participant Plugin as n8n Plugin (~/.claude/plugins/n8n)
    participant Registry as Plugin Registry (~/.claude/plugins/installed_plugins.json)
    participant Project as n8n Project (.claude/plugins/n8n/)
    
    Note over Cursor,Project: Cursor Plugin Discovery Flow
    
    Cursor->>Registry: Read installed_plugins.json
    Registry-->>Cursor: Plugin entries (name, path, version)
    
    alt Plugin NOT registered (n8n@n8n missing)
        Cursor->>Cursor: Skills not available
        Note over Cursor: User must manually register plugin
    else Plugin registered
        Cursor->>Project: Load skills/commands/agents from installPath
        Project-->>Cursor: Skill definitions (no n8n: prefix)
        Cursor->>Cursor: Make skills available in IDE
    end
    
    Note over Cursor,Project: User Workflow
    
    User->>Cursor: Invoke n8n skill (e.g., /n8n:create-pr)
    Cursor->>Project: Load skill implementation from plugin directory
    Project-->>Cursor: Skill instructions
    Cursor-->>User: Execute skill
    
    Note over Cursor,Project: Git Update Flow
    
    User->>Project: git pull (get new skills)
    Cursor->>Project: Auto-detect updated files (from registered path)
    Project-->>Cursor: Updated skills available without restart
Loading

@codecov
Copy link
Copy Markdown

codecov Bot commented May 5, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@DawidMyslak DawidMyslak changed the title docs: add Cursor setup instructions for n8n skills plugin docs: Add Cursor setup instructions for n8n skills plugin May 5, 2026
@n8n-assistant n8n-assistant Bot added the n8n team Authored by the n8n team label May 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

n8n team Authored by the n8n team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant