apify-generate-output-schema
Ce skill fait partie du repository officiel apify/agent-skills, une collection de skills d'agent IA pour le développement et le scraping sur la plateforme Apify. Il est entièrement fonctionnel et documenté : contrairement à un simple squelette, son SKILL.md contient des instructions détaillées guidant l'agent pas à pas.
Ce que fait ce skill
Le skill analyse le code source d'un Apify Actor existant pour générer automatiquement ses fichiers de schéma de sortie. Il produit trois fichiers principaux — dataset_schema.json, output_schema.json et, si nécessaire, key_value_store_schema.json — puis met à jour actor.json pour y référencer ces fichiers. Ces schémas permettent à Apify Console d'afficher correctement les résultats d'un Actor dans son interface.
Déroulement en phases
Le skill suit un processus structuré en sept phases : découverte de la structure de l'Actor, génération du schéma de dataset, génération du schéma de key-value store (si applicable), génération du schéma de sortie, mise à jour de actor.json, validation, puis résumé. Chaque phase s'appuie sur une analyse du code source réel (appels à pushData, setValue, interfaces TypeScript, classes Python) plutôt que sur des suppositions.
Conventions et règles appliquées
Le skill applique des règles strictes : tous les champs doivent avoir "nullable": true et "additionalProperties": true, les exemples doivent être anonymisés, et les conventions de nommage et de style doivent correspondre aux schémas existants dans le même repository. Il réutilise les types et interfaces déjà définis dans le code plutôt que de créer des définitions redondantes.
Comment l'utiliser
Une fois le skill installé via npx skills add apify/agent-skills, il suffit de l'invoquer en lui passant le chemin ou le nom de l'Actor cible. L'agent présente ses découvertes à chaque étape clé et soumet les schémas générés à la validation de l'utilisateur avant de les écrire sur le disque.