Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions skills/cloudflare-one/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ description: "Guides Cloudflare One Zero Trust and SASE work across Access, Gate

Before citing limits, settings, API fields, category IDs, or exact UI paths, retrieve current information from the [Cloudflare One docs](https://developers.cloudflare.com/cloudflare-one/), the Cloudflare docs MCP server, or the Cloudflare API schema.

**Resolve doc URLs, do not guess them.** Cloudflare One's docs have been reorganized repeatedly and its section names are not predictable — pages sit under `access-controls/access-settings/`, `team-and-resources/`, and `traffic-policies/` in ways that are easy to get wrong. Appending a guessed slug to a known parent path (for example `access-controls/policies/session-management/`) generally returns a 404, not a redirect.

When you need a page whose exact URL is not already linked in this skill or returned by the docs MCP server, fetch `https://developers.cloudflare.com/cloudflare-one/llms.txt` (~140KB — grep it, do not read it whole) and take the URL verbatim. `https://developers.cloudflare.com/llms.txt` is the index across all products. Append `index.md` to any page URL, or send `Accept: text/markdown`, to get the Markdown source.

## Workflow

1. Classify the ask: architecture, configuration, troubleshooting, migration, or review.
Expand Down
16 changes: 16 additions & 0 deletions skills/cloudflare/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,12 +22,28 @@ Fetch the **latest** information before citing specific numbers, API signatures,
| Source | How to retrieve | Use for |
|--------|----------------|---------|
| Cloudflare docs | `cloudflare-docs` search tool or `https://developers.cloudflare.com/` | Limits, pricing, API reference, compatibility dates/flags |
| Docs index (llms.txt) | `https://developers.cloudflare.com/llms.txt` | Finding the correct URL for a product before fetching it |
| Per-product page list | `https://developers.cloudflare.com/<product>/llms.txt` | Every page in one product, with descriptions |
| Per-product full text | `https://developers.cloudflare.com/<product>/llms-full.txt` | Whole product docs as one file (large — grep it, do not read it whole) |
| Workers types | `npm pack @cloudflare/workers-types` or check `node_modules` | Type signatures, binding shapes, handler types |
| Wrangler config schema | `node_modules/wrangler/config-schema.json` | Config fields, binding shapes, allowed values |
| Product changelogs | `https://developers.cloudflare.com/changelog/` | Recent changes to limits, features, deprecations |

When a reference file and the docs disagree, **trust the docs**. This is especially important for: numeric limits, pricing tiers, type signatures, and configuration options.

### Never guess a docs URL

Docs paths get reorganized, and a plausible-looking path is usually a 404 rather than a redirect. Do not build a URL by appending a guessed slug to a known parent.

If you do not already have the exact URL — from this skill, from `cloudflare-docs` search, or from a search result — resolve it first:

1. Fetch `https://developers.cloudflare.com/llms.txt` (~16KB) for the index of every product.
2. Fetch that product's `llms.txt` for its full page list, and take the URL verbatim.

Any page is also retrievable as Markdown by appending `index.md` to its URL, or by sending an `Accept: text/markdown` header. Prefer the Markdown form when you only need the content.

If a fetch does 404, do not retry variations of the guess — go to the product's `llms.txt` and find the real path.

## Quick Decision Trees

### "I need feature flags"
Expand Down