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
Install
daymade/claude-code-skills/cloudflare-troubleshooting · repository language: Python
git clone https://github.com/daymade/claude-code-skills
cp -r claude-code-skills/cloudflare-troubleshooting ~/.claude/skills/cloudflare-troubleshootingnpx skillfed install daymade/claude-code-skills/cloudflare-troubleshootingFrequently 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)
Read as markdown · JSON record · Browse the source repository
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