Guide · Agent skill
How to use the Cloudflare Access Zero Trust Deployment agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
This is an agent skill: a folder of instructions and scripts that an AI agent such as Claude loads when your request matches its purpose. The deploying-cloudflare-access-for-zero-trust skill guides the agent through replacing a traditional VPN with Cloudflare One, using Cloudflare Access and Cloudflare Tunnel. After this guide you will know what the skill does, how to install it, how to ask for it, and what you need before running any of its steps.
Quick start
- 1Download and unzip the skill. Download the ZIP from this page and unzip it into ~/.claude/skills/ or the project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
- 2Check the requirements. Confirm you have a Cloudflare Zero Trust account, a Cloudflare-managed domain, a server, an identity provider and a CF_API_TOKEN with Access permissions.
- 3Describe your goal. Ask the agent in plain terms, for example to replace your VPN or to give contractors access to one application.
- 4Create the tunnel. Have the agent guide you through installing cloudflared, creating a named tunnel and writing the ingress rules for your internal services.
- 5Connect the identity provider. Configure your IdP such as Okta or Microsoft Entra ID through the Cloudflare API, as the skill's examples show.
- 6Create applications and policies. Define an Access application per service, then add allow policies, optionally requiring device posture checks.
- 7Audit the setup. Run the included Python audit scripts to list applications, policies and identity providers and check for weak settings.
What the skill makes the agent do
The skill covers deploying Cloudflare Access together with Cloudflare Tunnel to give zero trust access to self-hosted applications. Its description covers configuring identity-aware policies, device posture checks and WARP client enrollment as a VPN replacement.
The workflow in the skill is organised into four steps: create a Cloudflare Tunnel to internal applications, configure identity provider integration, create Access applications and policies, and deploy the WARP client for device enrollment. The examples cover internal web apps, SSH and RDP services, with access granted per application rather than to the whole network.
The skill also includes Python scripts that can query your Cloudflare account to audit existing Access applications, policies and identity providers.
- Expose internal web, SSH and RDP apps through a Cloudflare Tunnel without opening inbound ports
- Connect an identity provider such as Okta or Microsoft Entra ID
- Write allow policies that can also require device checks
- Audit an existing Access setup for missing session timeouts or weak policies
Install the skill from the ZIP or the Claude apps
Download the ZIP of the skill from this page. To use it with Claude Code for your user account, unzip it into ~/.claude/skills/. To use it for one project only, unzip it into the .claude/skills/ folder of that project.
If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.
- Personal use across projects: ~/.claude/skills/
- Single project: .claude/skills/ inside the project folder
- Claude apps: Settings → Capabilities → Skills
Trigger the skill with a natural request
You do not need to name the skill. The skill's description says when to use it: replacing VPN with Cloudflare One, exposing internal apps without open inbound ports, or securing contractor or third-party access to specific applications. Describe your goal in those terms and include the details the agent will need, such as the apps and the identity provider you use.
- "Help me replace our VPN with Cloudflare One. We run a wiki, Grafana and an SSH bastion."
- "Set up contractor access to only our staging Git server through Cloudflare Access."
- "Audit our existing Cloudflare Access apps and policies for missing session timeouts."
What you need before you start
The skill assumes a working Cloudflare setup. Its requirements are a Cloudflare account with a Zero Trust subscription, a domain managed by Cloudflare DNS, a Linux, Windows or macOS server to run the cloudflared daemon, and a Cloudflare API token (CF_API_TOKEN) with Access permissions.
You also need identity provider credentials (Okta, Microsoft Entra ID, Google, GitHub or SAML/OIDC), Python 3 with the requests library for the audit scripts, and cloudflared. The Cloudflare WARP client is optional.
- Cloudflare account with a Zero Trust subscription
- Domain managed by Cloudflare DNS
- Linux, Windows or macOS server for cloudflared
- CF_API_TOKEN with Access permissions
- Identity provider credentials
- Python 3 with the requests library
- cloudflared, and optionally the WARP client
pip install requestsSafety notes: scripts and network use
This skill runs scripts and uses the network. The audit scripts query your Cloudflare account through its API, and the setup steps create tunnels, applications and policies. Review the scripts in scripts/ and the commands before running them, and use an API token scoped to what you need.
The skill is not suited to environments that must stay fully on-premises or air-gapped, because traffic is routed through Cloudflare's cloud. It also does not apply to applications that need persistent UDP connections, which the skill says Cloudflare Tunnel does not support.
- scripts/agent.py and scripts/process.py are included; read them before running
- Setup commands change live Cloudflare configuration
- Store CF_API_TOKEN securely and do not paste it into chats
Tips for a smoother deployment
Start with one low-risk internal application, confirm that login and policy behave as expected, then add the rest. The skill's examples set a session_duration on each application, and its checklist template in assets/template.md tracks tunnels, applications and identity providers in one place.
Keep the catch-all ingress rule at the bottom of the tunnel configuration, as the skill's example does, and use an explicit precedence on policies so you know which one applies first.
- Migrate one application at a time
- Use assets/template.md as a deployment checklist
- Keep the required catch-all rule in the tunnel config
What people use it for
- Replacing a VPN for a distributed team by exposing wiki, Git and Grafana through a Cloudflare Tunnel
- Giving a contractor access to one staging application without full network access
- Exposing SSH and RDP services through Cloudflare Access without opening inbound firewall ports
- Auditing an existing Cloudflare Access account for missing session timeouts or weak policies
Frequently asked questions
How do I install the Cloudflare Access agent skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder. In the Claude apps, upload it under Settings → Capabilities → Skills.
What do I need to use this skill?
You need a Cloudflare account with a Zero Trust subscription, a domain managed by Cloudflare DNS, a Linux, Windows or macOS server for cloudflared, a CF_API_TOKEN with Access permissions, and identity provider credentials. Python 3 with requests is needed for the audit scripts.
Is this skill free?
The skill is licensed under Apache-2.0. Cloudflare Zero Trust is a separate service: the skill notes a Free plan for up to 50 users and paid plans for larger teams, so check Cloudflare's current pricing.
Can Cloudflare Access replace a VPN?
The skill is written for replacing a VPN with Cloudflare One, using Access and Tunnel to expose specific applications. It does not apply to applications that need persistent UDP connections or to fully on-premises or air-gapped environments.
Does the skill open inbound firewall ports?
No. The skill's approach is to expose internal services through a Cloudflare Tunnel, which the skill describes as eliminating inbound firewall rules.
Why won't the agent use the skill for my request?
Skills are triggered by matching the request to the skill's description. Mention Cloudflare Access, Cloudflare One, Tunnel or replacing a VPN explicitly, and check that the folder is unzipped in the correct skills directory.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits IT or platform engineers moving a team off a VPN to Cloudflare One, admins giving contractors access to specific apps, and teams auditing an existing Access setup. It is the wrong choice if your environment must stay fully on-premises or air-gapped, or if your applications need persistent UDP connections.
Download the skill