Agent skill

Windsurf Deploy Integration

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Deploy applications using Devin Desktop (formerly Windsurf)'s built-in deployment features and Cascade automation.

MITAuto-check: notesDevOps & Cloud

Install Windsurf Deploy Integration

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-deploy-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace windsurf-deploy-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/windsurf-deploy-integration .claude/skills/windsurf-deploy-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
windsurf-deploy-integration
GitHub stars
2.8k
Token cost
~1.7k tokens
SKILL.md length
319 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Deploy applications using Devin Desktop (formerly Windsurf)'s built-in deployment features and Cascade automation.

  • Works in 6 steps: Use Windsurf's Native Deploy (Netlify) → Create a Deployment Workflow → Vercel Deployment via Cascade → …
  • Deploying apps from Windsurf
  • SKILL.md covers Overview, Prerequisites, Tool Use and Instructions, plus 5 more sections
  • Calls npm and vercel; needs NETLIFY_AUTH_TOKEN and NETLIFY_TOKEN

What it does

Windsurf Deploy Integration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Deploy applications using Devin Desktop (formerly Windsurf)'s built-in deployment features and Cascade automation. Use when deploying apps from Windsurf, configuring Netlify/Vercel integration, or building deployment workflows with Cascade. Trigger with phrases like "deploy windsurf", "windsurf deploy", "windsurf netlify", "windsurf vercel", "cascade deploy".

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-docs.md`). Compatibility notes: Designed for Claude Code

It sits in DevOps & Cloud, covering Deployment. It works with Netlify and Vercel. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Deploying apps from Windsurf
  • Configuring Netlify/Vercel integration
  • Building deployment workflows with Cascade
  • With phrases like deploy windsurf

Example prompts

  • “deploy windsurf”
  • “windsurf deploy”
  • “windsurf netlify”
  • “/windsurf-deploy-integration”

Requirements

  • Node.js
  • Docker
  • A credential in NETLIFY_AUTH_TOKEN
  • A credential in NETLIFY_TOKEN
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(git:*)

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Use Windsurf's Native Deploy (Netlify)
  2. Create a Deployment Workflow
  3. Vercel Deployment via Cascade
  4. Cloud Provider Deployment via Cascade
  5. Preview Deployments for PRs
  6. Use Previews to Verify Before Deploy

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash(npm:*)
    • Bash(npx:*)
    • Bash(git:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • vercel

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.devin.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NETLIFY_AUTH_TOKEN
    • NETLIFY_TOKEN
    • GH_TOKEN
    • GITHUB_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Windsurf Deploy Integration loads about 1.7k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 97 tokens; SKILL.md has 319 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:138
    4. Set environment variables from .env.production"

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 319 words, ~1,708 tokens.

Download SKILL.mdSave it as .claude/skills/windsurf-deploy-integration/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
windsurf-deploy-integration
description
Deploy applications using Devin Desktop (formerly Windsurf)'s built-in deployment features and Cascade automation. Use when deploying apps from Windsurf, configuring Netlify/Vercel integration, or building deployment workflows with Cascade. Trigger with phrases like "deploy windsurf", "windsurf deploy", "windsurf netlify", "windsurf vercel", "cascade deploy".
allowed-tools
Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(git:*)
compatibility
Designed for Claude Code
argument-hint
[scope or requirements]
version
1.12.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, windsurf, deployment, netlify, vercel

Windsurf Deploy Integration

Overview

Devin Desktop documents native App Deploys for Netlify. Use Cascade with reviewed provider CLIs or CI workflows for other targets, keeping build, approval, health-check, and rollback evidence explicit.

Prerequisites

  • Windsurf Pro plan or higher
  • Deployment platform account (Netlify, Vercel, or cloud provider)
  • Application ready to deploy
  • Git repository configured

Tool Use

  • Use Read to inspect only the repository files and configuration needed for the request.
  • Use Write only for a new artifact the user requested; never write credentials or unreviewed production configuration.
  • Use Edit for bounded, reviewable changes and preserve unrelated user work.
  • Use only the command-scoped Bash entries declared in frontmatter, with non-destructive checks before mutations.

Instructions

Step 1: Use Windsurf's Native Deploy (Netlify)

Windsurf has a first-party Netlify integration:

1. Open Cascade (Cmd/Ctrl+L)
2. Prompt: "Deploy this project to Netlify"
3. Cascade runs the build, connects to Netlify, and deploys
4. Preview URL appears in Cascade output
5. Click to verify in browser or use in-IDE Preview

For first-time setup:

Cascade prompt: "Set up Netlify deployment for this Next.js project.
Configure build command, output directory, and environment variables."
Step 2: Create a Deployment Workflow
markdown
<!-- .windsurf/workflows/deploy-staging.md -->
---
name: deploy-staging
description: Build, test, and deploy to staging
---

## Pre-Deploy Checks
// turbo-all
1. Run `git status` — abort if uncommitted changes
2. Run `npm run typecheck` — abort if type errors
3. Run `npm test` — abort if test failures
4. Run `npm run lint` — abort if lint errors

## Build and Deploy
5. Run `npm run build`
6. Run `npx netlify deploy --dir=dist --site=$NETLIFY_SITE_ID`
   Or: `npx vercel --yes`

## Post-Deploy Verification
7. Run `curl -sf $DEPLOY_URL/health | jq .`
8. Report: deploy URL, build time, health check result
Step 3: Vercel Deployment via Cascade
Cascade prompt: "Prepare a Vercel preview deployment for this project.
- Run the repository build and tests first
- Do not deploy to production
- Do not read or print secret values
- Return the preview URL and rollback instructions"

Cascade will run:

bash
set -euo pipefail
npm ci
npm test
npm run build

# Create a preview only; review provider output before any production promotion.
command -v vercel >/dev/null || { echo "Vercel CLI is not installed" >&2; exit 1; }
vercel --yes

Configure environment variables through the provider's approved secret surface. Treat production promotion, domain changes, and rollback as separate, explicitly approved operations.

Step 4: Cloud Provider Deployment via Cascade
markdown
<!-- AWS deployment workflow -->
Cascade prompt: "Deploy this Express API to AWS using:
1. Docker container on ECS Fargate
2. ECR for container registry
3. Application Load Balancer
4. RDS PostgreSQL for database
Generate the Dockerfile, task definition, and deployment script."
markdown
<!-- Google Cloud Run deployment -->
Cascade prompt: "Deploy this to Cloud Run:
1. Build Docker image
2. Push to Artifact Registry
3. Deploy to Cloud Run with 512MB memory, 1 CPU
4. Set environment variables from .env.production"
Step 5: Preview Deployments for PRs
yaml
# .github/workflows/preview-deploy.yml
name: Preview Deploy
on: pull_request

jobs:
  preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      - name: Deploy preview
        run: npx netlify deploy --dir=dist --alias=pr-${{ github.event.number }}
        env:
          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_TOKEN }}
          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
      - name: Comment PR with preview URL
        run: |
          gh pr comment ${{ github.event.number }} \
            --body "Preview: https://pr-${{ github.event.number }}--your-site.netlify.app"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Step 6: Use Previews to Verify Before Deploy
1. Run build locally: Cascade > "Build and preview the app"
2. Windsurf opens in-IDE Preview tab
3. Click through pages, verify functionality
4. Send broken elements to Cascade: "Fix the layout on mobile"
5. Once Preview looks correct: Cascade > "Deploy to staging"

Output

Return a deployment plan or reviewed change set with target environment, provider, authentication prerequisites, preflight results, immutable revision, health checks, evidence URL, and rollback command. Require explicit approval before any production mutation.

Error Handling

IssueCauseSolution
Deploy fails on buildMissing dependenciesCheck npm ci runs clean
Environment variables missingNot set in platformAdd via CLI or dashboard
Preview deploy 404Wrong output directoryCheck build config: dist/, .next/, build/
Netlify integration not availableOlder Windsurf versionUpdate Windsurf to latest
Cascade can't deployNo platform CLI installedInstall netlify-cli, vercel, or gcloud

Examples

Quick Deploy Commands
Cascade: "Deploy to Netlify production"
Cascade: "Deploy to Vercel with preview URL"
Cascade: "Build Docker image and push to ECR"
Cascade: "Deploy to Cloud Run with 1GB memory"
Rollback via Cascade
Cascade: "Roll back the Netlify deployment to the previous version"
Cascade: "Revert Vercel to the last successful production deploy"

Resources

Continue with windsurf-multi-env-setup to keep approved deployment commands, environment boundaries, and repository guidance consistent across the team.

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/.curated/windsurf-deploy-integration of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/official-docs.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Windsurf Deploy Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Windsurf Deploy Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Windsurf Deploy Integration this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.7kAutomated safety check: NotesMIT
Deploy Setupgarrytan/gstack136k—~11kAutomated safety check: NotesMIT
Memstack Deployment CI CD Pipelinecwinvestments/memstack423—~3.9kAutomated safety check: NotesProprietary
Memstack Deployment Netlify Deploycwinvestments/memstack423—~2.6kAutomated safety check: PassProprietary
Memstack Deployment Railway Deploycwinvestments/memstack423—~2.1kAutomated safety check: PassProprietary
Setup Deployno-session/pstack136—~5.5kAutomated safety check: NotesMIT

Similar skills

  • Deploy Setup

    garrytan/gstack

    Detects where an app deploys, its production URL and health checks, then saves the deploy configuration in CLAUDE.md for /land-and-deploy.

    136k GitHub stars~11k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • A skill your agent uses when the user says 'CI/CD', 'GitHub Actions', 'pipeline', 'continuous integration', 'continuous deployment', 'ci-cd-pipeline', 'automate deploys', or needs to set up…

    423 GitHub stars~3.9k tokensUpdated 13 days ago
    DevOps & CloudAuto-check: notes
  • A skill your agent uses when the user says 'deploy to Netlify', 'Netlify setup', 'netlify-deploy', or needs to deploy a static site or serverless functions to Netlify with build configuration and…

    423 GitHub stars~2.6k tokensUpdated 13 days ago
    DevOps & CloudAuto-check passed
  • A skill your agent uses when the user says 'deploy to Railway', 'Railway setup', 'railway-deploy', or needs to deploy a Node.js, Python, or Docker application to Railway with environment variables…

    423 GitHub stars~2.1k tokensUpdated 13 days ago
    DevOps & CloudAuto-check passed
  • Setup Deploy

    no-session/pstack

    Configure deployment settings for /land-and-deploy. An agent skill from no-session/pstack.

    136 GitHub stars~5.5k tokensUpdated 6 mo ago
    DevOps & CloudAuto-check: notes
  • Golive

    mikehasa/golive-skill

    Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).

    1.3k GitHub stars~13k tokensUpdated 6 days ago
    Backend & APIsAuto-check: notes

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Windsurf Deploy Integration

What does Windsurf Deploy Integration do?

Deploy applications using Devin Desktop (formerly Windsurf)'s built-in deployment features and Cascade automation. Windsurf Deploy Integration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Deploy applications using Devin Desktop (formerly Windsurf)'s built-in deployment features and Cascade automation.

When should I use Windsurf Deploy Integration?

Windsurf Deploy Integration fits situations like: deploying apps from Windsurf; configuring Netlify/Vercel integration; building deployment workflows with Cascade; with phrases like deploy windsurf.

How do I install Windsurf Deploy Integration in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-deploy-integration -a claude-code`. Or copy the skill folder (skills/.curated/windsurf-deploy-integration in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/windsurf-deploy-integration in your project. Claude Code loads it when a task matches its description.

How do I install Windsurf Deploy Integration in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-deploy-integration -a codex`. Or copy the skill folder (skills/.curated/windsurf-deploy-integration in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/windsurf-deploy-integration in your project. Codex loads it when a task matches its description.

Can I use Windsurf Deploy Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-deploy-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/windsurf-deploy-integration, .gemini/skills/windsurf-deploy-integration, .github/skills/windsurf-deploy-integration and .opencode/skills/windsurf-deploy-integration in your project.

What does Windsurf Deploy Integration need to run?

Going by SKILL.md and its folder, Windsurf Deploy Integration needs the command-line tools its instructions call (npm and vercel) and credentials named NETLIFY_AUTH_TOKEN, NETLIFY_TOKEN, GH_TOKEN and GITHUB_TOKEN. Our summary lists: Node.js; Docker; A credential in NETLIFY_AUTH_TOKEN; A credential in NETLIFY_TOKEN. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(git:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Windsurf Deploy Integration access the network?

SKILL.md names 1 domain. As links in the text: docs.devin.ai. This is read from the text; nothing was executed.

Is Windsurf Deploy Integration safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Windsurf Deploy Integration use?

Windsurf Deploy Integration is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Windsurf Deploy Integration use?

About 1.7k tokens (SKILL.md is roughly 6.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 96 tokens, read only when the agent opens those files.

What are the alternatives to Windsurf Deploy Integration?

Skills that share tags, products or a category with Windsurf Deploy Integration: Deploy Setup (garrytan/gstack, 136k stars), Memstack Deployment CI CD Pipeline (cwinvestments/memstack, 423 stars), Memstack Deployment Netlify Deploy (cwinvestments/memstack, 423 stars) and Memstack Deployment Railway Deploy (cwinvestments/memstack, 423 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Windsurf Deploy Integration?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.