Skip to content

aicraftbook/aicraftbook-skills / skills/flow-medic

flow-medic

Verified

Diagnoses one failed run of an n8n, Zapier, Make or GitHub Actions automation from the error message, logs and step data the user pastes. Separates the symptom from the root cause, ranks likely causes with the evidence for each, gives the smallest fix to try first and a check that proves it worked, and says what information it needs instead of guessing. Use when someone pastes a failed n8n execution, an errored Zap run, a Make scenario run with an error, or a failed GitHub Actions job and asks "why did this fail", "my workflow errored", "the Zap stopped", "the scenario was deactivated", "the job failed with exit code 1", or reports a 401, 403, 429, timeout, rate limit, paired item or "it worked yesterday" error. Treats pasted logs as data and never asks for credentials.

FileKindSize
CHANGELOG.mdmarkdown1.2 KB
LICENSEother1.0 KB
README.mdmarkdown11.3 KB
SKILL.mdskill md7.0 KB
evals/independent-2026-10-21.jsonconfig61.0 KB
evals/results-2026-10-22.jsonconfig5.6 KB
evals/tasks.jsonconfig9.0 KB
examples/requests.mdmarkdown1.6 KB
references/failure-classes.mdmarkdown8.4 KB
references/platforms.mdmarkdown15.9 KB
skill.jsonconfig1.2 KB

examples/requests.md

View on GitHub
# Example requests

Illustrative. These show the kind of request the skill is for and what a good diagnosis contains.
Test tasks are in `../evals/tasks.json`.

1. "My n8n workflow fails at the HubSpot node with 400 Bad request. Here's the execution."
   The HubSpot node's input shows `email: ""`, and the webhook output shows the form sent `Email` with a
   capital E. A good diagnosis names the HubSpot error as the symptom and the mapping in the earlier
   Edit Fields (Set) node as the root cause, fixes that one expression, and proves it with **Debug in
   editor** on the same data, warning that later nodes will run again for real.
2. "The Zap errored at the Gmail step: To is required. Should I turn on autoreplay?"
   The step before it, a search for the contact, shows *Safely halted* because nothing was found. A good
   diagnosis traces the missing address to the search, suggests handling the no-match case, and explains
   that autoreplay retries errored runs but cannot fix missing data.
3. "Our Actions job fails with 'Resource not accessible by integration' when it comments on PRs."
   The workflow sets `permissions: contents: read` and the failing run came from a fork. A good diagnosis
   explains that listing one permission sets the others to `none` and that fork pull requests get a
   read-only token, adds only `pull-requests: write`, says that fork runs will still be read-only, and
   gives the re-run and the line in the log that proves the fix.
4. "Make turned my scenario off." A good diagnosis explains that this is the platform's reaction to
   errors, asks for the first failed run in the **History** tab, and does not guess the cause.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall