cloudflare-troubleshooting
This skill guides you through evidence-based troubleshooting of Cloudflare configuration problems by querying the Cloudflare API to examine actual settings rather than making assumptions. It covers common issues including redirect loops, SSL certificate errors, DNS misconfigurations, and origin server errors, providing specific API calls and diagnostic logic for each.
Cloudflare Troubleshooting helps you systematically diagnose and fix Cloudflare issues using API-driven investigation.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-27
Cloudflare Troubleshooting helps you systematically diagnose and fix Cloudflare issues using API-driven investigation. This skill guides you through evidence-based troubleshooting of Cloudflare configuration problems by querying the Cloudflare API to examine actual settings rather than making assumptions. It covers common issues including redirect loops, SSL certificate errors, DNS misconfigurations, and origin server errors, providing specific API calls and diagnostic logic for each.
Use it when
- cloudflare-troubleshooting helps diagnose and fix SSL certificate errors like ERR_SSL_PROTOCOL_ERROR and error 526 by teaching you to query.
- cloudflare-troubleshooting teaches you to systematically investigate DNS issues by querying the Cloudflare API to examine your DNS records.
Verify before relying
Read SKILL.md below before installing (7 files). Open directory: indexed for reading, not audited.
Install
daymade/claude-code-skills/cloudflare-troubleshooting · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I fix cloudflare redirect loop issues?
cloudflare-troubleshooting guides you to diagnose redirect loops by querying the Cloudflare API to examine your actual configuration state. Start by checking your SSL/TLS mode, page rules, and origin server settings via API calls before making changes. Common causes include mismatched SSL modes between Cloudflare and your origin, conflicting page rules that redirect to themselves, or the 'Always Use HTTPS' rule combined with an insecure origin. The skill provides specific API patterns to inspect each configuration layer systematically.
What does cloudflare-troubleshooting help with SSL errors?
cloudflare-troubleshooting helps diagnose and fix SSL certificate errors like ERR_SSL_PROTOCOL_ERROR and error 526 by teaching you to query the Cloudflare API for your zone's SSL configuration. It covers SSL mode selection (Flexible vs Full vs Strict), certificate validation failures at your origin, and TLS handshake problems. The skill emphasizes checking your origin server's certificate validity and ensuring your SSL mode matches your origin's capabilities before applying fixes.
How do I troubleshoot cloudflare DNS problems using the API?
cloudflare-troubleshooting teaches you to systematically investigate DNS issues by querying the Cloudflare API to examine your DNS records and zone configuration. Use API calls to verify that your DNS records are correctly configured, your nameservers are pointing to Cloudflare, and your origin IP addresses are accurate. The skill provides diagnostic logic to identify misconfigurations before they cause resolution failures or routing errors.
What should I check for cloudflare 502 bad gateway errors?
cloudflare-troubleshooting guides you through troubleshooting 502 bad gateway errors by examining origin server connectivity and configuration via the Cloudflare API. Check your origin server's health, SSL certificate validity, and whether it's responding to requests. The skill teaches you to query API endpoints to inspect your origin settings, page rules, and firewall rules that might be blocking legitimate traffic, then apply targeted fixes based on evidence.
How can I check my cloudflare zone configuration with the API?
cloudflare-troubleshooting teaches you to query the Cloudflare API to examine your zone's actual configuration state before making changes. Use API calls to inspect SSL/TLS settings, DNS records, page rules, firewall rules, and origin server configuration. This evidence-based approach prevents assumptions and helps you identify the root cause of issues like redirect loops, SSL errors, and DNS problems systematically.
What does cloudflare-troubleshooting cover for origin server errors?
cloudflare-troubleshooting helps you troubleshoot origin server connectivity and certificate validation errors by providing Cloudflare API patterns for unfamiliar scenarios. It covers error 503 (origin unreachable), certificate mismatches, and TLS handshake failures. The skill teaches you to query your zone configuration via API to verify origin settings, then diagnose whether the problem lies in your origin's health, SSL certificate, or Cloudflare's routing configuration.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Cloudflare Troubleshooting
> Methodology base: the general evidence-driven network-diagnosis discipline (falsification, layered isolation, counter-review) lives in the debugging-network-issues skill. This skill is the Cloudflare domain layer on top of it.
Core Principle
Investigate with evidence, not assumptions. Always query Cloudflare API to examine actual configuration before diagnosing issues. The skill's value is the systematic investigation methodology, not predetermined solutions.
Investigation Methodology
1. Gather Credentials
Request from user: - Domain name - Cloudflare account email - Cloudflare Global API Key (or API Token)
Global API Key location: Cloudflare Dashboard → My Profile → API Tokens → View Global API Key
2. Get Zone Information
First step for any
(truncated - see the full file via the links below)
File tree — 7 files
cloudflare-troubleshooting/.security-scan-passed
cloudflare-troubleshooting/SKILL.md
cloudflare-troubleshooting/references/api_overview.md
cloudflare-troubleshooting/references/common_issues.md
cloudflare-troubleshooting/references/ssl_modes.md
cloudflare-troubleshooting/scripts/check_cloudflare_config.py
cloudflare-troubleshooting/scripts/fix_ssl_mode.py
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Systematically investigate and resolve Cloudflare configuration issues using API queries”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill automates low-level DNS operations on Cloudflare using the API v4, including record creation, modification, deletion, and zone configuration. It provides both helper scripts and direct curl methods for manual DNS management, dynamic IP updates, and advanced zone settings control.
Access Cloudflare's REST API directly for operations beyond wrangler and MCP: bulk DNS migrations, custom hostnames for white-label domains, email routing rules, cache purging, WAF configuration, and cross-database queries. Generates curl commands and batch scripts for fleet-wide resource audits and one-time bulk changes.
This skill systematically identifies and resolves IPv6 DNS problems that cause local network clients to bypass direct access and connect through Cloudflare Tunnel with OAuth authentication. It verifies Pi-hole's filter-AAAA configuration, tests IPv6 blocking, clears client DNS caches, and confirms local access works without authentication prompts.
Systematically identifies and resolves Cloudflare Tunnel connectivity failures that block remote access. Checks container status, validates tunnel tokens, analyzes logs for Error 1033 and QUIC issues, and provides targeted recovery commands.
Configure Workers to reach private APIs across cloud providers and on-premise infrastructure using encrypted tunnels. This skill covers tunnel setup, VPC service creation, wrangler binding configuration, and the critical rules that prevent common errors like dns_error and requests leaking to public endpoints.
This skill systematically identifies and resolves Cloudflare Access authentication problems, from Google OAuth misconfigurations to policy mismatches and domain blocking. It guides you through verifying OAuth credentials, checking allowed email lists, confirming Pi-hole whitelisting, and validating redirect URIs to pinpoint exactly why authentication is failing.