Automation Helper - Claude Code Plugin

AI assistant for Power Automate and n8n workflows - Help design, build, debug, and refactor automation workflows with Claude Code.

⚠️ Alpha Version - Skills in active development. Power Automate and n8n focus. Make/Zapier not yet supported.

What This Plugin Does

This plugin adds 6 AI skills to Claude Code that help you work with automation workflows:

Design workflows through conversation (brainstorm)
Generate workflow JSON from requirements (build-flow)
Debug errors with documentation research (debugger)
Fix common errors quickly (quick-fix)
Refactor workflows for performance (refactor)
Validate before deployment (validator)

What's Actually Complete

✅ Power Automate (Partial)

Forms connector (100%)
Excel connector (100%)
Outlook connector (100%)
Teams connector (100%)
Built-in actions (100%)
SharePoint (20% - needs work)
OneDrive (20% - needs work)

✅ n8n (Core + Database)

Core nodes (HTTP, Webhook, Code, Schedule, Set, IF - 6/15 nodes)
AI nodes (OpenAI - 1/10 nodes)
App integrations (Google Sheets, Drive, Gmail - 3/300 nodes)
Database nodes (PostgreSQL, Redis, Pinecone - 3/10 nodes)

❌ Not Yet Supported

Make/Integromat
Zapier
Advanced n8n nodes
Custom slash commands
Workflow hooks

Installation

# Add marketplace
/plugin marketplace add MacroMan5/AutomationHelper_plugins

# Install plugin
/plugin install automation-helper

Quick Example

You: "I'm getting a 429 error in my Excel flow"

→ automation-quick-fix or automation-debugger activates
  - Searches documentation
  - Finds rate limit (100 calls/60s)
  - Suggests adding delays
  - Outputs fixed JSON
  - or provides quick fix suggestions

How It Works

Documentation-Driven: Skills search real documentation in Docs/ folder (100+ files) to avoid hallucinations.

Multi-Phase Approach: Each skill follows a structured process: analyze → research → design → generate → validate.

No Placeholders: Generated JSON is complete and ready to paste into your platform.

What's In Development

🚧 Active Development

All 6 skills (working but improving)
Power Automate SharePoint & OneDrive docs (20% → 100%)
More n8n node coverage
Better error detection

📋 Planned Features

Make/Integromat support
Zapier support
Custom slash commands
Workflow validation hooks
More connector documentation

Current Limitations

Be Aware:

Make and Zapier are NOT supported yet
Skills are in alpha - expect rough edges
Some Power Automate connectors incomplete
n8n coverage is basic (core nodes only)
No custom commands or hooks yet
Documentation gaps exist

⚠️ IMPORTANT - How to Use Effectively:

❌ Don't do this:

Send a 3000-line workflow JSON and expect perfect results
Ask to "fix everything" in a complex flow
Expect it to understand your entire workflow at once

✅ Do this instead:

Section your workflow - Work on one part at a time
Focus on specific issues - Debug one error at a time
Provide context - Explain what the section should do
Keep it manageable - Max ~200-300 lines of JSON per request

Example:

❌ Bad: "Fix this entire workflow [paste 3000 lines]"

✅ Good: "I have an error in the SharePoint loop section.
         Here's the relevant part [paste 150 lines].
         It's supposed to filter items by date but getting 429 errors."

Why? AI has context limits. Smaller, focused requests = better results.

Contributing

We Need Help! 🙏

This is an open-source project in active development. Contributions welcome:

Most Needed

📚 Documentation: Add Make, Zapier, more Power Automate connectors
🐛 Bug Reports: Test skills and report issues
💡 Ideas: Suggest improvements via Issues
🔧 Code: Fix bugs, improve skills

How to Contribute

Fork this repo
Try the plugin and find issues
Open an Issue with what you found
Submit PRs to fix bugs or add docs

See CONTRIBUTING.md for details.

📖 Read This First!

BEST_PRACTICES.md - How to use this plugin effectively

TL;DR: Don't send 3000-line workflows. Section them into manageable chunks (200-300 lines). One problem at a time. Provide context.

Documentation Structure

Docs/
├── PowerAutomateDocs/
│   ├── Forms/         ✅ Complete (100%)
│   ├── Excel/         ✅ Complete (100%)
│   ├── Outlook/       ✅ Complete (100%

...

macroman5/automationhelper_plugins

README