What It Is For
A Netlify deploy tells you it published. That is true, and it is not the question. The question is which files went out, which rules went with them, and whether your change is what the site now serves.
This skill helps an AI agent find out what a site is really serving, and avoid the moves that cause trouble in the first place.
Who Should Use It
Anyone who deploys to Netlify. Load it when:
- you are about to run netlify deploy by hand
- one repo builds more than one site
- a site returns 404 on every page, or redirects to itself
- a scheduled function looks dead in the logs, or runs late
- a form on a live site has never captured a submission
- you need to roll back a bad deploy
How Clickflame Built It
Clickflame wrote this skill from production incidents across a network of static sites and functions on Netlify. The skill says none of them threw an error. Each was found by asking the platform what it was serving.
A few examples from its text. One deploy command published a whole working tree and took a site down for 44 minutes. A redirect rule from a sibling brand made every page on another site point to itself. An audit of 21 sites found that every one with a Netlify form had form detection off and zero submissions, ever. A job set to run every five minutes was measured 29 minutes late.
What It Checks
- The dir flag, which overrides netlify.toml and ships from disk, not from git
- Redirect rules left behind when the files move
- Rolling back first, then rebuilding, since only the rollback is instant
- Blob reads that return the value from before your own write
- Conditional writes that fail by returning, not by throwing
- Sampled function logs, where no log line does not mean no run
- Schedules that run far later than the cron says
- Form detection that is off by default
- Secret variables that show up as asterisks in a local script
It ends with a short list of checks to run after any deploy, like reading the file list and the headers the site really sends.
How to Install It
Run this in your terminal. It adds this skill for your AI coding agent:
npx skills add halltony85-source/clickflame-agent-skills@netlify-deploy-traps -g -yOr add all four Clickflame skills at once:
npx skills add halltony85-source/clickflame-agent-skills -g -yThen start a new session. The agent loads the skill when a task matches it. New to skills? Start with what an agent skill is.
See It on GitHub
The full skill is free to read before you install it. Read Netlify Deploy Traps on GitHub. It is part of Clickflame's agent skills repo, under the MIT license.