skill-creator

Skill-creator is a meta-skill that guides authors in building effective skills for Apollo GraphQL and GraphQL development, following the Agent Skills specification. It solves the problem of inconsistent, hard-to-trigger skills by codifying the directory structure, SKILL.md frontmatter, description patterns, and body organization that make a skill discoverable and useful to an AI agent.

It documents the required and optional layout (SKILL.md plus optional references, scripts, templates, and assets), the frontmatter fields and their constraints (name rules, description length and trigger phrasing, license, compatibility, metadata, allowed-tools), and recommended body sections such as Overview, Process with checkboxes, Quick Reference, Security, Reference Files, and Ground Rules. A companion reference tailors this to the Apollo repository: product versus convention skill categories, consistent trigger-description templates, GraphOS MCP tool integration, process structures, and example GraphQL/TypeScript/Rover snippets. Notably, it puts real weight on security patterns — labeling security sections with the literal word "Security," placing warnings at the point of risk (for example warning that response caching is PUBLIC by default and that user-specific fields must be marked PRIVATE), requiring the author to understand the data model before generating cache config, adding security items to validation checklists, and using ALWAYS/NEVER ground rules such as never binding internal endpoints to 0.0.0.0 and always using environment variables for secrets.

It targets skill authors and Apollo/GraphQL developers who want to create or update skills that trigger reliably and encode secure defaults. It is purely instructional guidance and does not execute anything risky.