Repository navigation
Conversation
Agents asked about a 5xx, 4xx, or 1xxx error on a proxied site had no guidance for deciding whether Cloudflare or the origin produced it. Add a short decision-rule section that links the troubleshooting docs, and mention error triage in the skill description so the skill loads for these questions.
Separate who generated a page from where the fix belongs, cover TLS and Custom Errors, scope Security Events to 1020 and WAF blocks, and narrow the description trigger.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a short "Troubleshoot HTTP errors on a proxied site" section to the
cloudflareskill, and extends the skill description so it loads when a user reports a Cloudflare error page, a52xstatus, a 1xxx error code, or a Cloudflare403.The section is decision rules only. Each rule links the troubleshooting page that holds the facts:
502and504: branding reverses the usual reading (branded means the origin returned it).cf-error-typediagnostic header, and keep "who generated the page" separate from "where the fix belongs".520–526: start at the origin; for525/526, also check the SSL/TLS mode.403: check the page first; for 1020 or the WAF block page, search Security Events (sampled) for the rule.It also tells the agent to retrieve the page for the specific code instead of answering from memory, and to ask about Custom Errors before relying on branding.
Why
Agents asked about an error on a proxied site had no guidance for deciding whether to fix Cloudflare configuration or the origin, and tend to answer from memory. The underlying docs were corrected first (cloudflare/cloudflare-docs#34327, #34334, #34336), so the skill can link them rather than restate them.
Checks
#http-status-codesanchor exists.cloudflareskill description. Keeping both sentences resolves it.