netlify-agent-runner

Execute Claude, Codex, or Gemini agents on Netlify branches.

32|7|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/netlify/context-and-tools --skill netlify-agent-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-agent-runner
Source: https://github.com/netlify/context-and-tools/tree/main/codex/skills/netlify-agent-runner
Command: npx skills add https://github.com/netlify/context-and-tools --skill netlify-agent-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows you to run AI agent tasks remotely on Netlify, automating development tasks and providing second opinions from different models.

Core Features & Use Cases

  • Remote AI Agent Execution: Run Claude, Codex, or Gemini AI agents on Netlify infrastructure to automate tasks.
  • Branch-based Execution: Run tasks against specific branches of your site code.
  • New Branch Deployment: Output results on a new branch with a Deploy Preview, avoiding overwriting existing code.
  • Asynchronous Execution: Tasks run in the background, allowing you to continue working.
  • Use Case: Automate the addition of a contact form to your site by running an AI agent task that generates the necessary code.

Quick Start

Run an AI agent task to add a contact form to your site with the command: netlify agents:create "Add a contact form" -a codex.

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 AI coding agents remotely on Netlify infrastructure?

You can run AI coding agents remotely on Netlify infrastructure by using the 'netlify agents:create' command to execute tasks asynchronously in the background. This allows you to automate development tasks without halting your local workflow.

Can I execute AI agent tasks on a specific Git branch in Netlify?

Yes, branch-based execution allows AI agent tasks to run against specific branches of your connected site repository. The agent generates output results on a new branch, creating a Deploy Preview without overwriting your existing code.

How do I automate adding a contact form to my website using an AI agent?

To automate adding a contact form, execute the command 'netlify agents:create "Add a contact form" -a codex' in your project scope. The AI agent will asynchronously generate the necessary code and output it to a new branch.

Does Netlify agent runner support multiple AI models for code generation?

Netlify agent runner supports multiple AI models for code generation, specifically allowing you to execute Claude, Codex, or Gemini agents. This enables you to automate development tasks and get second opinions from different models.

How do I check the status of an asynchronous AI agent task in Netlify?

You can check the status of an asynchronous AI agent task using the 'netlify agents:show' command. Since tasks run in the background on Netlify infrastructure, this command allows you to retrieve the results of your project-scoped execution.