Agent Skill Optimizer

Procedures, authoring principles, and quality standards for creating, auditing, and optimizing Agent Skills according to the Agent Skills specification and open-source best practices.

Available scripts

• scripts/count_tokens.py — Audits skills and categories against Tier 1, 2, and 3 token limits using Vertex AI ADC, Gemini API, or offline heuristic.

Skill Architecture & Progressive Disclosure Limits

Skills use a 3-tier progressive disclosure model to minimize token consumption:

1. Tier 1 — Routing & Discovery Metadata (~50–100 words / <= 150 tokens):
   • Fields: name (1–64 characters) and description (1–1024 characters).
   • Runtime behavior: Injected into the model's system prompt at startup for all available skills so the orchestrator can route tasks accurately.
   • Budget limit: Keep routing tokens <= 150 (ideal ~100 tokens). Keep description <= 1024 characters.