worker-conventions-lint
description (verbatim frontmatter)
Structural lint for a workers/<name>/ directory against the fleet's five real conventions (each grep-verified 2026-07-09): direct-path ../../_shared/kit/<mod> imports (barrel imports evade scripts/worker-build.sh's kit drift gate), account_id pinned to the fleet Cloudflare account in wrangler.toml, an apex+www [[routes]] pair, [observability] enabled = true, and the package.json allowScripts block. Pure functions over file contents plus a report-only CLI (node scripts/lint.ts <worker-dir>). Use when scaffolding a new worker from workers/_template, reviewing a worker PR, or when a wrangler deploy silently exits 1 / esbuild-workerd binaries silently fail to install and you want the structural cause named. Do NOT use for kit HASH drift — scripts/worker-build.sh gates kit hashes; this lints STRUCTURE and complements, never replaces, that gate — nor for CSS/design-token conventions (cwc-design's fleet-design-system skill) or for executing deploys (cwc-deploy).
summary
Structural lint for a workers/<name>/ directory against the fleet's five real conventions (each grep-verified 2026-07-09): direct-path ../../_shared/kit/<mod> imports (barrel imports evade scripts/worker-build.sh's kit drift gate), account_id pinned to the fleet Cloudflare account in wrangler.tom...
source
plugins/cwc-engineering/skills/worker-conventions-lint/SKILL.md
provenance
created 2026-07-10 18:13:13 · JSON