Skills turnstile-spin

📦

turnstile-spin

Name: turnstile-spin
Author: cloudflare

Content revision r1 High Risk 🌐 Network access📁 Filesystem access🔑 Env variables⚡ Contains scripts⚙️ External commands

Add Cloudflare Turnstile Protection

Bot protection often fails when frontend widgets and server checks are configured separately. This skill coordinates creation, integration, secret handling, and validation.

Supports: Claude Codex Code(CC)

⚠️ 38 Poor

Stop for confirmation before installing.

Review the plan and obtain explicit user consent before changing files.

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request

Review the Skillstore skill "turnstile-spin" from https://skillstore.io/skills/cloudflare-turnstile-spin.md and its manifest at https://skillstore.io/api/skills/cloudflare-turnstile-spin/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Markdown detail GET /skills/cloudflare-turnstile-spin.md Signed manifest GET /api/skills/cloudflare-turnstile-spin/manifest Signed lockfile GET /api/skills/cloudflare-turnstile-spin/lockfile

Test it

Using "turnstile-spin". Protect the signup form in this Next.js application from automated submissions.

Expected outcome:

Detected a Next.js App Router signup page and its server route.
Created one managed widget for the approved domains.
Added server validation for success, signup action, and approved hostnames.
Validation passed for the widget configuration and failed safely for a replayed token.

Using "turnstile-spin". Our contact form has a Turnstile widget, but submissions still bypass it.

Expected outcome:

The browser widget was present, but the server handler did not call Siteverify.
Added Siteverify before the existing contact logic and preserved the original handler.
Validation remains pending because the backend could not run locally.

Security Audit

High Risk

v1 • 8/9/2026 Open versioned report

Most static alerts are safe Turnstile examples, bounded shell operations, or false matches on Markdown. Confirmed issues include plaintext home-directory token storage and mutable remote skill installation without integrity verification. The remote installation path can introduce unaudited instructions and executable scripts.

Files scanned

2,117

Lines analyzed

Review items

False positives ignored

Confirmed security concerns (1)

High

README.md:29-38 scripts/persist-skill.sh:62-79 scripts/persist-skill.sh:86-98

Unpinned Remote Skill Installation

Installation paths fetch mutable remote skill content without a commit pin or digest. The persistence script copies fetched shell scripts and makes them executable.

The clone and download commands omit immutable revisions and integrity verification. The fetched bundle is installed into an agent skill directory with executable scripts.

Capability review items (6)

These are real local capabilities that may be expected for this skill, so they require review but are not counted as confirmed malicious behavior.

High

README.md:29

Hardcoded URL

git clone https://github.com/cloudflare/skills ~/.config/cloudflare-skills

The installation command clones a mutable default branch and places it behind an agent skill symlink. Future unaudited repository content can become trusted instructions.

High

README.md:37

Hardcoded URL

curl -sSL https://developers.cloudflare.com/turnstile/spin/prompt.md \

The fallback downloads a mutable remote prompt directly into an agent skill path without a pinned revision or integrity check. Compromise or upstream changes would alter trusted instructions.

High

scripts/persist-skill.sh:67

Hardcoded URL

"https://github.com/cloudflare/skills.git" \

The persistence script clones the mutable cloudflare/skills repository without selecting an audited commit. It then installs that remote bundle as executable agent instructions.

High

scripts/persist-skill.sh:96

Python shutil operations

shutil.copytree(source, target, dirs_exist_ok=False)

copytree installs files from the unpinned remote clone and marks included shell scripts executable. Path checks limit the destination but do not establish source integrity.

High

SKILL.md:48

Hidden file in home directory

2. **Save to file** (token in a user-only file): `umask 077; read -rsp 'Cloudflare API token: ' toke

The workflow offers to store a Cloudflare API token as plaintext in ~/.cf-turnstile-token. Restrictive permissions reduce exposure but do not provide encrypted credential storage.

High

SKILL.md:48

Hidden file access

2. **Save to file** (token in a user-only file): `umask 077; read -rsp 'Cloudflare API token: ' toke

The hidden file contains a long-lived Cloudflare API token and is later loaded for authentication. This creates a persistent plaintext credential outside a managed secret store.

Risk Factors

🌐 Network access (50)

📁 Filesystem access (25)

🔑 Env variables (28)

⚡ Contains scripts (2)

references/vanilla-html.md:147 SKILL.md:325

⚙️ External commands (50)

Audited by: codex

Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report

Copy report link

https://skillstore.io/skills/cloudflare-turnstile-spin/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/cloudflare-turnstile-spin/security.svg)](https://skillstore.io/skills/cloudflare-turnstile-spin?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/cloudflare-turnstile-spin?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/cloudflare-turnstile-spin/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/cloudflare-turnstile-spin.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Academic citations (APA · BibTeX · CFF)

APA citation

cloudflare. (2026). turnstile-spin security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/cloudflare-turnstile-spin/audits/1

BibTeX citation

@techreport{cloudflare-cloudflare-turnstile-spin-2026,
  author = {cloudflare},
  title = {turnstile-spin security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/cloudflare-turnstile-spin/audits/1},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "turnstile-spin security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
  - name: "cloudflare"
date-released: "2026-08-09"
url: "https://skillstore.io/skills/cloudflare-turnstile-spin/audits/1"
identifiers:
  - type: other
    value: "skillstore:cloudflare-turnstile-spin:audit:1"
    description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: Medium

Architecture

Maintainability

Content

Community

Spec Compliance

What You Can Build

Protect a signup flow

Add a widget to signup and reject automated requests in the existing server handler.

Migrate an existing CAPTCHA

Replace reCAPTCHA or hCaptcha with Turnstile while preserving actions and backend behavior.

Repair a partial integration

Find missing hostname, action, secret, reset, or Siteverify checks and validate the corrected flow.

Try These Prompts

Protect one form

Add Cloudflare Turnstile to the signup form and its existing backend handler. Ask before creating resources or writing secrets.

Protect selected actions

Scan this project for user-triggered requests. Recommend which actions need Turnstile, then integrate only the actions I approve.

Migrate another CAPTCHA

Migrate the existing reCAPTCHA or hCaptcha integration to Turnstile. Preserve valid action names and existing business logic.

Audit and repair Turnstile

Audit this Turnstile integration end to end. Verify secret handling, expected actions, hostname allowlists, widget resets, and replay rejection before making approved fixes.

Best Practices

Use separate production hostname allowlists and exclude loopback addresses from production.
Keep the secret in an ignored environment file or managed secret store.
Validate success, action, hostname, and replay behavior before reporting completion.

Avoid

Do not call Siteverify from browser code or expose the secret to the client.
Do not run credential-bearing commands through project-local package executables.
Do not replace existing business logic when adding the verification gate.