graphos-factory
Ce skill fait partie du repo officiel apollographql/skills, qui regroupe les skills Apollo GraphQL pour les agents IA (Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, etc.). Contrairement à d'autres entrées de ce repo, graphos-factory n'est pas un squelette ou un template : il contient un SKILL.md complet et opérationnel, copié en lecture seule depuis le repo source apollographql/graphos-factory lors de chaque release.
Ce que fait ce skill
graphos-factory instruit l'agent pour transformer une REST API en subgraph Apollo Connectors destiné à un supergraph GraphOS, avec ou sans spec OpenAPI/Swagger. L'agent gère l'intégralité du cycle de vie : découverte de l'API (discover), sélection des opérations et des champs (select), génération incrémentale du schéma (apply), validation multicouche (composition, tests unitaires, end-to-end, live), et export vers GraphOS (export). Tout l'état durable — inventaire, sélections, décisions de conception, résultats de vérification — est conservé dans un workspace git dédié par subgraph.
Architecture du skill
Le SKILL.md définit un protocole précis : verbes (init, discover, select, apply, codify, validate, record, export), références documentaires internes, et un binaire graphos-factory (téléchargé automatiquement via scripts/bootstrap.sh, environ 3 Mo). L'agent est explicitement positionné comme le décideur de conception — le binaire et les wrappers shell effectuent le travail mécanique (lecture de spec, rendu, appels rover, vérification d'invariants), mais n'écrivent jamais le schéma à la place de l'agent.
Comment l'utiliser
Ce skill s'installe via le Skills CLI (npx skills add apollographql/skills@graphos-factory), via le GitHub CLI (gh skill install apollographql/graphos-factory), ou directement depuis son repo source. Dans Claude Code, il est également disponible comme commande slash /apollo-skills:graphos-factory via le plugin apollo-skills. Il remplace le skill apollo-connectors, désormais déprécié. La première utilisation déclenche le téléchargement du binaire graphos-factory par l'agent.