AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

turnstile-spin

Set up, repair, or migrate to Cloudflare Turnstile bot verification in an existing frontend and backend, including server-side Siteverify.

Original source
cloudflare
License
Apache-2.0
Pinned revision
e44f580f9c4fa3bf268e284ae7706c7954ba31fd

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read cloudflare--turnstile-spin at revision e44f580f9c4fa3bf268e284ae7706c7954ba31fd, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 10

README.md

turnstile-spin (skill)

End-to-end setup skill for Cloudflare Turnstile. Loads when an agent is asked to add Turnstile, set up CAPTCHA, or protect a form from bots.

SKILL.md is the canonical machine-readable behavior. The hosted prompt at developers.cloudflare.com/turnstile/spin/prompt.md packages the same behavior for agents that do not have this bundle installed. Product requirements come from the Turnstile documentation.

Layout

| File | Purpose | | --------------------------------- | ---------------------------------------------------------------------- | | SKILL.md | Main wizard instructions for the agent | | scripts/auth-probe.sh | Probes the customer's Cloudflare API token for Turnstile scope | | scripts/widget-create.sh | Creates the Turnstile widget via the Cloudflare API | | scripts/validate.sh | Dummy-siteverify + hostname check at the end of the wizard | | scripts/persist-skill.sh | Installs the canonical skill bundle into the user's repo | | references/vanilla-html.md | Code snippet for static / vanilla HTML projects | | references/nextjs-app.md | Code snippet for Next.js App Router projects | | references/nextjs-pages.md | Code snippet for Next.js Pages Router projects | | references/astro.md | Code snippet for Astro projects | | references/sveltekit.md | Code snippet for SvelteKit projects | | references/hugo.md | Code snippet for Hugo projects | | references/skill-feedback.md | Steps for reporting problems with this skill to its maintainers | | tests/validation.md | Validation cases matching the assertions in the PRD |

How agents load it

Agents that load skill bundles from github.com/cloudflare/skills will pick this up automatically. For agents that load skills out of a local directory, clone the bundle once and symlink it:

git clone https://github.com/cloudflare/skills ~/.config/cloudflare-skills
ln -s ~/.config/cloudflare-skills/skills/turnstile-spin ~/.claude/skills/turnstile-spin

If cloning is not an option, the hosted single-file prompt is a read-only fallback:

mkdir -p .claude/skills/turnstile-spin && \
  curl -sSL https://developers.cloudflare.com/turnstile/spin/prompt.md \
  -o .claude/skills/turnstile-spin/SKILL.md

The single-file install does not include scripts/ or references/; the hosted prompt fetches those on demand with fetch_spin_script. scripts/persist-skill.sh requires the cloned bundle above and cannot be used from a single-file install. For other agents, see the table in SKILL.md.

Keep the hosted prompt in sync

Any behavioral change to SKILL.md must also be applied to public/turnstile/spin/prompt.md in the cloudflare-docs repository. The hosted file adds bootstrap instructions, but its wizard, security boundaries, recovery flow, and validation requirements must match this skill.

Related