refactor: consolidate Cloudflare One skills#56
Open
irvinebroque wants to merge 8 commits into
Open
Conversation
Add 21 Cloudflare One deployment, migration, and operations skills covering Gateway (SWG), Access (ZTNA), Tunnels, WAN, Device Posture, CASB, DLP, Risk Scoring, Architecture Design, and vendor migration (Zscaler ZIA/ZPA, Palo Alto). Each skill follows the CF1 Lifecycle (Assess → Design → Implement → Validate → Operate) and includes both MCP-automated and manual (Dashboard/API) implementation paths. Source: https://gitlab.cfdata.org/fmeszaro/cf1stack
irvinebroque
commented
Jun 1, 2026
irvinebroque
commented
Jun 1, 2026
|
|
||
| ## API Safety | ||
|
|
||
| - Use fully qualified MCP tool names when MCP tools are available. |
Contributor
Author
There was a problem hiding this comment.
Suggested change
| - Use fully qualified MCP tool names when MCP tools are available. |
irvinebroque
commented
Jun 1, 2026
Co-authored-by: Brendan Irvine-Broque <brendanib@gmail.com>
irvinebroque
commented
Jun 1, 2026
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.
Summary
This is an alternate version of #55 that keeps Cloudflare One coverage but changes the skill shape:
cloudflare-oneandcloudflare-one-migrations.developers.cloudflare.com, Cloudflare MCP docs, or current API schemas.Rationale
PR #55 added about 6,000 lines across 21 separate Access, Gateway, Tunnel, CASB, DLP, risk, WAN, and migration skills. That structure makes skill activation and context use worse: many narrow skills can overlap, duplicate Cloudflare documentation, and load stale reference material that agents can already retrieve from canonical sources.
The intended use of Agent Skills is to add context the agent would otherwise lack, not to repackage public product docs. This version spends the skill context budget on workflow guidance, safety defaults, decision points, and non-obvious failure modes. Exact API fields, category IDs, dashboard paths, limits, and product behavior should be retrieved at task time.
This follows the canonical Agent Skills guidance:
Both sources emphasize concise skills, avoiding content the model already knows or can retrieve, using progressive disclosure, and spending context on project-specific or non-obvious guidance.
What changed compared with #55
mainis 186 added lines instead of roughly 6,000.Validation
skills/*/SKILL.mdfrontmatter with Ruby YAML parsing.git diff --check.