Synthèse automatique
Guide l'utilisateur, par un entretien structuré en quatre étapes, dans la conception puis le scaffolding d'une Skill Spectackle de qualité destinée à des agents IA.
Points forts
- Entretien en quatre étapes explicites : découverte, déclencheur, procédure, scaffolding
- Posture volontairement critique : reformule les déclencheurs vagues en scénarios concrets (fichiers, situations)
- Exige l'approbation du plan d'architecture avant toute génération de fichiers, ce qui évite un scaffolding prématuré
- Impose une procédure en 3 à 5 étapes séquentielles avec une étape de vérification finale
Limites
- Suppose disponibles l'outil AskUserQuestion et la CLI `spk create-skill` ; sans eux le flux ne peut pas aboutir
- Ne couvre ni l'évaluation, ni les tests, ni le versionnage de la Skill produite
- La qualité du résultat dépend fortement des réponses de l'utilisateur, que l'assistant ne fait que challenger
À utiliser lorsqu'on veut concevoir une nouvelle Skill IA et clarifier ses conditions de déclenchement et sa procédure avant d'écrire le moindre fichier.
À éviter si la spécification de la Skill est déjà complète et qu'il ne reste qu'à générer les fichiers, ou si l'on cible un format de Skill autre que Spectackle.
Analyse de sécurité
PrudenceThe skill is primarily instructional and does not exfiltrate data, disable safety, or contain obfuscated payloads. However, it directs execution of a CLI command using a user-supplied name, which is a mild command-injection concern if the name is not strictly validated or safely quoted.
- •Instructs the agent to run `spk create-skill <name>` where `<name>` is user-controlled; without validation, this could become command injection if executed through an unsafe shell wrapper.
- •References the AskUserQuestion tool and a CLI command despite no allowed-tools being declared, creating ambiguity about execution permissions.
Exemples
Help me create a new skill called `api-breaking-change-guard` that tells agents how to handle changes to public API endpoints safely.I want a skill for database work, but my idea is just 'when writing code, be careful'. Challenge it and help me define precise triggers and a 4-step procedure, then scaffold it.Walk me through designing a Spectackle skill for reviewing pull requests, and don't run spk create-skill until I approve the architecture plan.description: Guide the user through creating a high-quality Spectackle Skill.
You are the Spectackle Skill Architect. Your mission is to help the user design and scaffold a production-grade AI Skill that provides clear, actionable instructions for AI agents.
Step 1: Initial Discovery
If the user hasn't provided a name or purpose, ask:
- What should the skill be named? (kebab-case)
- What is the primary problem this skill solves for the AI?
Step 2: Quality Challenge - The "Trigger"
A skill is only useful if the AI knows when to use it. Challenge the user to be specific:
- Instead of "When writing code", suggest "When modifying public API endpoints" or "When creating database migrations".
- Ask: "In which specific files or scenarios should this skill be activated?"
Step 3: Quality Challenge - The "Procedure"
A good procedure is a checklist, not a paragraph. Challenge the user to:
- Define 3-5 concrete, sequential steps.
- Include a "Final Verification" step.
- Ask: "How can the AI agent prove it has successfully followed this skill?"
Step 4: Scaffolding
Once you have clear and high-quality information:
- Run
spk create-skill <name>to create the directory and boilerplate. - Update the generated
SKILL.mdwith the refined description, triggers, and procedure you discussed. - Announce success and show the user where the file is located.
Conversation Stance:
- Be helpful but critical. If a skill is too vague, explain why it will fail to guide an AI effectively and suggest improvements.
- Use the AskUserQuestion tool to move through the steps.
- Do NOT scaffold until the user has approved the "Architecture Plan" you've built together in the chat.
$ARGUMENTS
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/spectackle-skill-architect-mrwake9k/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/spectackle-skill-architect-mrwake9k' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/spectackle-skill-architect-mrwake9k/download' --output '.skill-downloads/spectackle-skill-architect-mrwake9k/SKILL.md.part' && mv '.skill-downloads/spectackle-skill-architect-mrwake9k/SKILL.md.part' '.skill-downloads/spectackle-skill-architect-mrwake9k/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Le fichier ne fournit pas un en-tête name/description exploitable pour cette procédure native. Le téléchargement reste disponible pour lecture ; utilisez le mode manuel ci-dessous.
Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/spectackle-skill-architect-mrwake9k/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Bonnes pratiques React Hook Form
Developpement
Maîtrisez React Hook Form : évitez les anti-patterns, gérez les abonnements, et traitez correctement reset, dirty state et entrées contrôlées.
Migration Emotion vers Mantine
Developpement
Migrer les styled-components Emotion vers des composants Mantine avec style props et modules CSS. Pour convertir .styled.tsx ou supprimer les imports @emotion.
Détecteur de dérive de périmètre
Developpement
Analyse les diffs git par rapport à une intention pour détecter la dérive de périmètre, fichiers non liés et PR trop larges, puis suggère de garder, diviser ou justifier.