Synthèse automatique
Guide la création ou la modification d'une skill d'agent dans un dépôt Go, sous forme de fichier YAML embarqué dans pkg/agent/skills/.
Points forts
- Rappelle les conventions du dépôt (nom, sections, auto_activation, priorité) avant d'écrire
- Impose la lecture des skills existantes et de prompt.go pour éviter les doublons et les incohérences
- Explique le filtrage déterministe des sections par port/service, point le plus facile à rater
- Inclut une étape de vérification via go build ./pkg/agent/
Limites
- Fortement lié à l'arborescence de ce dépôt précis : inutilisable tel quel ailleurs
- Ne détaille pas le contenu rédactionnel des sections ni les bonnes pratiques de formulation pour le LLM
- Suppose que l'agent sait déjà lire le code Go et le mécanisme //go:embed
À utiliser lorsqu'on veut ajouter ou retoucher une skill YAML dans pkg/agent/skills/ en respectant le format et le filtrage du projet.
À éviter pour rédiger une skill destinée à un autre framework ou pour documenter du code qui n'est pas un registre de skills embarquées.
Analyse de sécurité
SûrThe skill is a repository-specific authoring guide for creating/editing YAML skill definitions. It references reading files and running `go build`, but contains no destructive commands, credential access, network exfiltration, obfuscation, or safety-disabling instructions.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
Create a new skill in pkg/agent/skills/ that activates on the 'database' discovery category and covers Postgres port 5432. Read the existing skills first to avoid overlap.Our new skill's section never shows up. Check how sections are filtered by port/service in pkg/agent/prompt.go and fix the YAML patterns.Add a disk override for the existing 'http-probe' skill in pkg/agent/skills/ and confirm it still builds with go build ./pkg/agent/.Create or edit an agent skill: $ARGUMENTS
Context
Agent skills live in pkg/agent/skills/ as YAML files embedded at build time via //go:embed.
Disk skills in the same directory override embedded ones by name for customization.
Before Writing
- Read existing skills in
pkg/agent/skills/to understand the format and conventions. - Read
pkg/agent/prompt.goto understand how skills are referenced in the agent prompt. - Check how skills are loaded and filtered — skills have sections filtered by port/service (deterministic string match).
Skill YAML Structure
Key fields to understand:
- name — unique identifier, referenced by LLM
- sections — filtered by port/service match
- auto_activation — triggers on discovery categories
- priority — lower number = higher priority
Guidelines
- Skills should be generic enough to apply across target types where possible.
- Section filtering is deterministic string matching — be precise with service/port patterns.
- Auto-activation triggers should map to discovery categories from
report_discoverytool. - Test that the skill loads correctly:
go build ./pkg/agent/ - Read the 14 existing skills before creating a new one to avoid overlap.
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/create-or-edit-an-agent-skill-mts7ilbw/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/create-or-edit-an-agent-skill-mts7ilbw' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/create-or-edit-an-agent-skill-mts7ilbw/download' --output '.skill-downloads/create-or-edit-an-agent-skill-mts7ilbw/SKILL.md.part' && mv '.skill-downloads/create-or-edit-an-agent-skill-mts7ilbw/SKILL.md.part' '.skill-downloads/create-or-edit-an-agent-skill-mts7ilbw/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/create-or-edit-an-agent-skill-mts7ilbw/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.