Skip to content

feat: add netlify-to-createos migration skill#20

Open
adityachaudhary99 wants to merge 1 commit into
NodeOps-app:mainfrom
adityachaudhary99:main
Open

feat: add netlify-to-createos migration skill#20
adityachaudhary99 wants to merge 1 commit into
NodeOps-app:mainfrom
adityachaudhary99:main

Conversation

@adityachaudhary99
Copy link
Copy Markdown

@adityachaudhary99 adityachaudhary99 commented May 24, 2026

Summary

Replaces the netlify-to-createos stub with a fully implemented migration skill. Follows the same MCP-tool-first pattern as \�ercel-to-createos.

Changes

  • SKILL.md: Full migration workflow (8 steps) using CreateOS MCP tools (CreateProject, CreateProjectEnvironment, TriggerLatestDeployment, etc.) as primary references
  • config/config.json: Runtime, framework, and platform mapping tables
  • references/netlify-toml-reference.md: Netlify toml field reference
  • references/migration-patterns.md: Common migration code patterns
  • scripts/parse-netlify-config.sh: Helper to parse netlify.toml
  • scripts/migrate-env.sh: Helper to migrate environment variables
  • README.md: Added netlify-to-createos to available skills table
  • MIGRATIONS.md: Moved netlify-to-createos from 'Coming soon' to 'Available today'

Testing

End-to-end migration test passed against netlify-templates/next-netlify-starter — parsed netlify.toml + package.json, created matching CreateOS project with all settings, verified project and environment.

Notes

  • MCP tool names match the CreateOS MCP server schema (same as vercel-to-createos)
  • REST API and opencode-createos plugin listed as fallback alternatives

## Prerequisites

Before running any migration steps, confirm the user has:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@naman485 you want to change url

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do i need to do something about this yet?

Comment thread skills/netlify-to-createos/SKILL.md Outdated

Before running any migration steps, confirm the user has:

1. A CreateOS account — if not, direct them to `https://createos.nodeops.network` to sign in via Email, GitHub, Google, or Wallet.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@adityachaudhary99 only email and google login, no wallet, github login

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sure

Comment thread skills/netlify-to-createos/SKILL.md Outdated
Before running any migration steps, confirm the user has:

1. A CreateOS account — if not, direct them to `https://createos.nodeops.network` to sign in via Email, GitHub, Google, or Wallet.
2. CreateOS MCP connected OR a `CREATEOS_API_KEY` environment variable set.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you mean CreateOS MCP login using oauth or ....

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I meant the user has the CreateOS MCP server configured in their opencode.json / claude. (the MCP client setup), not OAuth. The alternative is using a CREATEOS_API_KEY env var for REST API fallback. The wording could be clearer? maybe "CreateOS MCP server configured in opencode.json or Claude Desktop" instead.


1. A CreateOS account — if not, direct them to `https://createos.nodeops.network` to sign in via Email, GitHub, Google, or Wallet.
2. CreateOS MCP connected OR a `CREATEOS_API_KEY` environment variable set.
3. Access to their current Netlify project's environment variables (they may need to export these from the Netlify dashboard).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we can utilize Netlify-CLI (https://docs.netlify.com/api-and-cli-guides/cli-guides/get-started-with-cli/) to smooth the migration

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sure I could try that

Comment thread skills/netlify-to-createos/SKILL.md Outdated

- `netlify.toml` — build, redirect, header, and function configuration
- `package.json` — detect framework, build scripts, and Node.js version
- `next.config.js` / `next.config.mjs` / `next.config.ts` — Next.js specific configuration
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should be more generic since you're mentioning "detected project" below

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will replace the hardcoded next.config.* / .nvmrc lines with a generic "Framework-specific config files" line. Good?

Comment thread skills/netlify-to-createos/SKILL.md Outdated
| Netlify Identity | Use Auth0, Clerk, Supabase Auth, or NextAuth |
| Split Testing | App-level A/B testing (e.g., GrowthBook, LaunchDarkly) |
| Large Media | Use any S3-compatible object storage |
| Build hooks / webhooks | Use CreateOS API `POST /v1/projects/{id}/trigger-latest` |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CreateOS handling -> ...or works out of the box with github

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will append "or works out of the box with GitHub (git push → auto-deploy)" to that row.

Full migration skill replacing the stub. Parses netlify.toml, maps build
settings and environment variables, flags incompatibilities (Edge Functions,
Forms, Identity), and guides deployment via the CreateOS MCP server.

Includes:
- MCP-tool-first SKILL.md matching vercel-to-createos pattern
- config/config.json with runtime/framework/platform mappings
- references/ with netlify-toml reference and migration patterns
- scripts/ with parse-netlify-config.sh and migrate-env.sh helpers
- Updated README.md and MIGRATIONS.md tables
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants