[PR #19] [MERGED] add workers-best-practices skill #22

New issue

Closed

opened 2026-03-02 03:21:17 +03:00 by kerem · 0 comments

kerem commented

2026-03-02 03:21:17 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/cloudflare/skills/pull/19
Author: @elithrar
Created: 2/12/2026
Status: ✅ Merged
Merged: 2/12/2026
Merged by: @elithrar

Base: main ← Head: add-workers-best-practices-skill

📝 Commits (2)

c8cae3a add workers-best-practices skill
91a8cf6 address self-review findings

📊 Changes

3 files changed (+764 additions, -0 deletions)

View changed files

➕ skills/workers-best-practices/SKILL.md (+127 -0)
➕ skills/workers-best-practices/references/review.md (+174 -0)
➕ skills/workers-best-practices/references/rules.md (+463 -0)

📄 Description

Retrieval-first skill for writing and reviewing Cloudflare Workers code against production best practices.

Content sourced from cloudflare/cloudflare-docs#28295 (21 rules across 7 sections) and the code-review skill in cloudflare-docs, distilled into agent-consumable format.

SKILL.md (127 lines) — retrieval sources, quick-reference rules table, anti-patterns table, review workflow
references/rules.md (454 lines) — 17 best practice rules with code examples, anti-patterns, and "Retrieve" callouts for anything that may drift
references/review.md (174 lines) — type validation, config validation, binding access patterns, serialization boundaries, review process with output format

Retrieval bias: the skill opens with "Prefer retrieval over pre-training" and instructs the agent to fetch the latest workers types, wrangler config schema, and best practices page before doing any work. Mirrors the approach from the code-review skill but is fully self-contained — no dependency on project-level skills.

Dropped 3 purely operational rules from the PR (environments, custom domains/routes, static assets) and kept the 17 that are relevant to code review and authoring. Scoped to Workers-only; links to the existing durable-objects skill and Workflows docs for those topics.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/cloudflare/skills/pull/19 **Author:** [@elithrar](https://github.com/elithrar) **Created:** 2/12/2026 **Status:** ✅ Merged **Merged:** 2/12/2026 **Merged by:** [@elithrar](https://github.com/elithrar) **Base:** `main` ← **Head:** `add-workers-best-practices-skill` --- ### 📝 Commits (2) - [`c8cae3a`](https://github.com/cloudflare/skills/commit/c8cae3aa8f822fcaf5fd840009f54561bf12a458) add workers-best-practices skill - [`91a8cf6`](https://github.com/cloudflare/skills/commit/91a8cf609d0277dd4f98604ba80eb75a9fbde419) address self-review findings ### 📊 Changes **3 files changed** (+764 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `skills/workers-best-practices/SKILL.md` (+127 -0) ➕ `skills/workers-best-practices/references/review.md` (+174 -0) ➕ `skills/workers-best-practices/references/rules.md` (+463 -0) </details> ### 📄 Description Retrieval-first skill for writing and reviewing Cloudflare Workers code against production best practices. Content sourced from [cloudflare/cloudflare-docs#28295](https://github.com/cloudflare/cloudflare-docs/pull/28295) (21 rules across 7 sections) and the code-review skill in cloudflare-docs, distilled into agent-consumable format. - `SKILL.md` (127 lines) — retrieval sources, quick-reference rules table, anti-patterns table, review workflow - `references/rules.md` (454 lines) — 17 best practice rules with code examples, anti-patterns, and "Retrieve" callouts for anything that may drift - `references/review.md` (174 lines) — type validation, config validation, binding access patterns, serialization boundaries, review process with output format Retrieval bias: the skill opens with "Prefer retrieval over pre-training" and instructs the agent to fetch the latest workers types, wrangler config schema, and best practices page before doing any work. Mirrors the approach from the code-review skill but is fully self-contained — no dependency on project-level skills. Dropped 3 purely operational rules from the PR (environments, custom domains/routes, static assets) and kept the 17 that are relevant to code review and authoring. Scoped to Workers-only; links to the existing `durable-objects` skill and Workflows docs for those topics. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>