Google Cloud's five-rule playbook for evaluating whether agent skills are worth their tokens

rseroter · x · 2026-11-05

Google Cloud's developer relations team published an engineering playbook for evaluating agent skills (SKILL.md), based on dozens of scenarios run against their own Google Cloud Developer Plugin with Gemini, Antigravity, and Claude Sonnet 5 in isolated Harbor pods on GKE Autopilot; they also contributed capabilities upstream to NVIDIA's open-source evaluator.

Rule 1: before rewriting your SKILL.md when evals show Δ=0, check trigger collisions and security — nine times out of ten the skill never loaded. Routers only inspect the YAML frontmatter name and description; past a dozen skills, under-triggering (describing implementation instead of intent) and sibling hijacking collide.

The other rules cover zero-contamination sandboxes (local workstations' cached credentials, shell history, and CPU contention mask baseline failures), measuring delta against real baselines, and keeping skills lean so they don't bloat the context window. Core point: pasting pages of CLI docs into markdown without an eval loop likely confuses a frontier model more than it helps.

Original post →

More from coding & agent

coding & agent channel →