Menu
Flip the snap spec default version. Updates all files that reference the current version — constants, docs config, SKILL.md files, template, and llms.txt.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use this skill whenever the users wants to generate a Farcaster embedded app (aka snap), deploy an app to production, or edit an existing app. Activate when the user mentions snaps, embedded apps, interactive casts, or cast apps.
Use this skill whenever the users wants to generate a Farcaster embedded app (aka snap), deploy an app to production, or edit an existing app. Activate when the user mentions snaps, embedded apps, interactive casts, or cast apps.
Use this skill whenever the users wants to generate a Farcaster embedded app (aka snap), deploy an app to production, or edit an existing app. Activate when the user mentions snaps, embedded apps, interactive casts, or cast apps.
Audit and fix all documentation, components, and examples to match the snap protocol schema definitions. Run after any change to component schemas in pkgs/snap/src/ui/.
| name | set-spec-version |
| description | Flip the snap spec default version. Updates all files that reference the current version — constants, docs config, SKILL.md files, template, and llms.txt. |
This skill upgrades (or downgrades) the snap spec default version across the entire repo. Use it when the protocol is ready to promote a new version as the default.
The target version string, e.g. "2.0". Must be one of the values in
SUPPORTED_SPEC_VERSIONS in pkgs/snap/src/constants.ts.
In pkgs/snap/src/constants.ts, change SPEC_VERSION to point to the target version
constant (e.g. SPEC_VERSION = SPEC_VERSION_2).
In apps/docs/src/lib/version-config.ts, change DEFAULT_VERSION to the target
version string.
Copy apps/docs/public/{version}/SKILL.md to apps/docs/public/SKILL.md.
This ensures agents reading the root SKILL.md get the correct version's instructions.
In template/src/index.ts, change the version field in the snap response to match the
new default version string.
Check AGENTS.md and template/AGENTS.md for any version references and update them.
After changing the version, run the sync-protocol-docs skill to ensure all downstream
files (docs pages, llms.txt, examples, renderers) are consistent with the new default.
pnpm --filter @farcaster/snap build — must pass.pnpm --filter @farcaster/snap test — must pass.pkgs/snap/src/constants.ts — SPEC_VERSION updatedapps/docs/src/lib/version-config.ts — DEFAULT_VERSION updatedapps/docs/public/SKILL.md — copied from versioned SKILLtemplate/src/index.ts — version field updatedAGENTS.md / template/AGENTS.md — version refs updatedsync-protocol-docs skill executed