Synthèse automatique
Génère l'ossature d'une nouvelle skill (SKILL.md, README, plugin et entrée marketplace) dans le dépôt agent-skills, puis valide le résultat.
Points forts
- Vérifie que le nom est en kebab-case et qu'aucune skill du même nom n'existe déjà, avec arrêt sur erreur
- Crée en une passe SKILL.md, README.md, le répertoire de plugin, marketplace.json et la ligne du tableau du README racine
- Pose deux questions ciblées (catégorie, description) via AskUserQuestion pour remplir le frontmatter
- Termine par l'exécution de scripts/validate.py et affiche les prochaines étapes à faire manuellement
Limites
- Fortement lié au dépôt 2ykwang/agent-skills : il dépend de scripts/generate_plugins.py, de scripts/validate.py et de l'arborescence skills/ existante
- Le contenu produit reste volontairement des TODO ; la rédaction réelle des instructions n'est pas automatisée
- La liste de catégories proposée (development, design-frontend, productivity, integrations, media) est propre au dépôt et ne recoupe pas les taxonomies habituelles
À utiliser lorsqu'on ajoute une nouvelle skill au dépôt agent-skills et qu'on veut un squelette cohérent, un plugin généré et les entrées README synchronisées.
À éviter hors de ce dépôt précis, ou lorsqu'il s'agit de rédiger et d'affiner le contenu d'une skill existante plutôt que d'en créer l'ossature.
Analyse de sécurité
PrudenceThe skill is a scaffolding utility: it validates a name, creates a directory with two files, asks the user for metadata, runs two in-repo Python scripts, and appends a row to the README. Nothing is destructive, obfuscated, or exfiltrating; the kebab-case regex blocks path-traversal tricks. It is 'caution' only because it exercises file-write and code-execution capabilities that are undeclared in allowed-tools and depends on the safety of scripts it invokes.
- •No allowed-tools declared, yet the workflow instructs file creation/editing and execution of repo scripts (`python3 scripts/generate_plugins.py`, `python3 scripts/validate.py`)
- •Step 6/8 run local Python scripts whose behavior is not described here; the agent must trust them without inspecting them
- •Step 7 edits the repository root README table by loosely described text matching ('between the two --- separators'), which could corrupt the file if the structure differs
- •Input is constrained to kebab-case (^[a-z0-9]+(-[a-z0-9]+)*$), which usefully prevents path traversal in `skills/$ARGUMENTS/`
Exemples
/add-skill pdf-table-extractor/add-skill PDF_Table_Extractor/add-skill code-reviewdescription: Scaffold a new skill with validation, plugin generation, and README update. argument-hint: "<skill-name>"
Add Skill
Scaffold a new skill named $ARGUMENTS.
Workflow
1. Validate Input
- Check
$ARGUMENTSis kebab-case (^[a-z0-9]+(-[a-z0-9]+)*$). Stop with error if not. - Check
skills/$ARGUMENTS/does not already exist. Stop with error if it does.
2. Create Directory Structure
skills/<name>/
├── SKILL.md
└── README.md
3. Write SKILL.md
---
name: <name>
version: 0.0.1
category: TODO
description: "TODO — one sentence describing what this skill does and when to trigger it."
argument-hint: "<argument>"
---
## Instructions
TODO
4. Ask User
Use AskUserQuestion:
- Category — one of:
development,design-frontend,productivity,integrations,media - Description — one sentence for the skill description
Update SKILL.md frontmatter with the user's answers.
5. Write README.md
Create skills/<name>/README.md with this structure:
# <name>
<description from step 4>
## When to use
- TODO
## Usage
/skill-name <example>
## Installation
### Claude Code
```bash
claude plugin marketplace add 2ykwang/agent-skills
claude plugin install <name>@2ykwang-agent-skills
npx skills
npx skills add 2ykwang/agent-skills --skill <name>
### 6. Generate Plugins
Run `python3 scripts/generate_plugins.py`. This generates:
- `plugins/<name>/` directory with plugin.json, README.md, and copied skills
- Updated `.claude-plugin/marketplace.json`
### 7. Update README.md Skills Table
Find the table between the two `---` separators. Append 3-row block before the closing `---`:
```markdown
| [<name>](skills/<name>) | <description> |
| | `npx skills add 2ykwang/agent-skills --skill <name>` |
| | `claude plugin install <name>@2ykwang-agent-skills` |
8. Validate and Report
Run python3 scripts/validate.py. Show output.
Print summary:
Created skills/<name>/
Next steps:
1. Edit skills/<name>/SKILL.md — replace TODOs
2. Edit skills/<name>/README.md — add "When to use" and "Usage" examples
3. just generate && just validate
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/add-skill-ms47vqoi/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/add-skill-ms47vqoi' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/add-skill-ms47vqoi/download' --output '.skill-downloads/add-skill-ms47vqoi/SKILL.md.part' && mv '.skill-downloads/add-skill-ms47vqoi/SKILL.md.part' '.skill-downloads/add-skill-ms47vqoi/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/add-skill-ms47vqoi/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.