docs-review
Review documentation changes for correctness, style, and structure. Use AGENTS.md and the style guide at src/content/docs/style-guide/ as primary references.
When to Suggest vs. When to Edit
Decision logic
- Explicit instruction wins. If the user says "suggest", "only make suggestions", or "do not make changes" — post suggestions via
ghCLI, never push commits. If they say "fix", "address this", or "update" — edit files directly and commit. - Different actor = suggest. If the person invoking the review is not the PR author (and no explicit fix instruction was given), post suggestions so the author retains control.
- Same actor or ambiguous = fix by default. When the invoker is the PR author (or it is unclear), default to editing files directly. MDX syntax errors, broken code, invalid frontmatter, wrong component usage, and other obvious errors should always be fixed, not suggested.
Quick reference
| Instruction | Action |
|---|---|
| "review", "suggest changes", "provide suggestions" | Post suggestions only via gh CLI — do not push commits |
| "only make suggestions", "do not make changes" | Post suggestions only — never edit files or push |
| "fix", "address this", "update" | Always edit files directly and commit changes |
| "review and fix" | Fix low-severity issues directly; suggest high-impact changes |
| Invoked by someone other than PR author | Post suggestions unless explicitly told to fix |
More from cloudflare/cloudflare-docs
cloudflare
Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), networking (Tunnel, Spectrum), security (WAF, DDoS), and infrastructure-as-code (Terraform, Pulumi). Use for any Cloudflare development task.
133code-review
Reviews Workers and Cloudflare Developer Platform code for type correctness, API usage, and configuration validity. Load when reviewing TypeScript/JavaScript using Workers APIs, wrangler.jsonc/toml config, or Cloudflare bindings (KV, R2, D1, Durable Objects, Queues, Vectorize, AI, Hyperdrive).
110wrangler
Cloudflare Workers CLI for deploying, developing, and managing Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines, and Secrets Store. Load before running wrangler commands to ensure correct syntax and best practices.
105durable-objects
Create and review Cloudflare Durable Objects. Use when building stateful coordination (chat rooms, multiplayer games, booking systems), implementing RPC methods, SQLite storage, alarms, WebSockets, or reviewing DO code for best practices. Covers Workers integration, wrangler config, and testing with Vitest.
85agents-sdk
Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks.
76changelog
Creates, updates, and reviews product changelog entries for the Cloudflare documentation site. Load when generating changelog MDX files, editing existing entries, reviewing changelog style, or validating frontmatter.
73