Skip to content

prepare-netlify-deployment

skillLast commit

Codex and Claude Code skill for auditing and preparing reliable Netlify deployments across static, SPA, SSR, and hybrid web apps.

Open productSource
Role
Agent workflow design and automation engineering
Scope
Agent workflow, validation automation, and packaging
Status
Published npm package

Problem

A build can succeed locally yet fail on Netlify because base paths, publish directories, runtime models, redirects, adapters, or environment requirements are misidentified.

Constraints

  1. C1

    Static, SPA, hybrid, and SSR routing require different contracts.

  2. C2

    Netlify adapter behavior is framework/version-sensitive.

  3. C3

    Dashboard/environment/deployment changes are remote actions that need explicit authority.

Architecture

Project/framework/lockfile detection; deterministic netlify.toml and output audit using documented patterns; local build/route verification and authorization-gated remote handoff.

01

Skill workflow

Project/framework/lockfile detection.

02

Automation

Deterministic netlify.toml and output audit using documented patterns.

03

Verification

Local build/route verification and authorization-gated remote handoff.

Decisions

D1

Derive an explicit build contract before changing configuration

Derive an explicit build contract before changing configuration.

D2

Prefer maintained framework adapters over hand-written function shims

Prefer maintained framework adapters over hand-written function shims.

D3

Preserve unrelated configuration and never hide build defects behind catch-all redirects

Preserve unrelated configuration and never hide build defects behind catch-all redirects.

Contribution

  • Implemented package manager/framework/runtime detection.
  • Built a Python Netlify configuration auditor.
  • Codified redirect, base, publish, functions, and adapter rules.
  • Added installer and package verification.

Outcomes

  • Agents can classify a project's runtime model.
  • Repair minimal local configuration.
  • Verify root/nested routes and output shape.
  • Separate a deployment-ready local state from unperformed dashboard/deploy actions.

Verified stack

  • Agent Skills
  • Python
  • JavaScript
  • Node.js
  • npm
  • Netlify
  • GitHub Actions
  • CI/CD

Working through something similar?

Share your challenge, scope, and timeline to start a focused conversation.