netlify-agent-runner

Run Claude, Codex, or Gemini agent tasks remotely on Netlify infrastructure.

1|Updated May 13, 2026
One-click install
npx skills add https://github.com/SyedArmanAli2003/AgroNaV --skill netlify-agent-runner-syedarmanali2003
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-agent-runner
Source: https://github.com/SyedArmanAli2003/AgroNaV/tree/main/.agents/skills/netlify-agent-runner
Command: npx skills add https://github.com/SyedArmanAli2003/AgroNaV --skill netlify-agent-runner-syedarmanali2003

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Delegating development work to a remote AI agent is error-prone: tasks run against the pushed repository rather than local changes, execute asynchronously without completion callbacks, and require manual polling to discover results. This Skill provides the operational knowledge to create, monitor, and manage Netlify agent tasks correctly. ## Core Features & Use Cases - Remote Task Creation: Launch Claude, Codex, or Gemini agents against a linked Netlify site with prompts, branch targeting, and model selection via netlify agents:create. - Task Lifecycle Management: List, inspect, and stop agent tasks with netlify agents:list, agents:show, and agents:stop, polling until terminal states (done, error, cancelled). - Cross-Model Delegation: Get a second opinion on your implementation from a different model, discover edge cases, or run independent work in parallel while you continue locally. - Use Case: You just refactored an authentication flow and want validation. Push your branch, then delegate a security audit prompt to a different agent on Netlify, polling the task ID until it completes. ## Quick Start Ask the agent to run a code review task on your Netlify site using the Claude agent and poll the returned task ID until it reports done.

Frequently Asked Questions about netlify-agent-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an AI agent on my Netlify site?

Use `netlify agents:create "<prompt>" -a <agent>` from a directory linked to a Netlify project, choosing claude, codex, or gemini as the agent. The command returns a task ID immediately while the work runs remotely on Netlify infrastructure.

How do I check the status of a Netlify agent task?

Run `netlify agents:show <task-id>` to poll the task status, or `netlify agents:list` to see all tasks. Tasks move from new to running, then to done, error, or cancelled; there are no webhooks, so you must poll until a terminal state.

Does the Netlify agent see my uncommitted local changes?

No. Agent tasks run remotely against the site's connected repository and only see code that has been committed and pushed. Commit and push your changes first, or target a pushed branch with the `-b` flag.

Which agents can I use with Netlify agent tasks?

Three agents are supported: claude, codex, and gemini, selected with the `-a` or `--agent` flag. You can also specify a model with `-m` and target a specific project with `--project` if the directory is not linked.

Why did my Netlify agent task work on stale code?

The remote agent works from the pushed branch, defaulting to the production branch (main or master). If you targeted a feature branch with `-b` that was never pushed, the agent worked from code that does not match your local state.