AI Skills : concept et catalogue
À la fin de ce tutoriel AI Skills : concept et catalogue, vous saurez définir un skill (procédure réutilisable chargée à la demande), le distinguer d’un prompt jetable, d’une Rule, d’un Custom GPT, d’un outil MCP et d’une routine planifiée, cartographier le catalogue multi-outils 2026, et bâtir un lab factice sous
/tmp/lab-ai-skills-concept(catalogue + stubSKILL.md) — sans secrets ni APIs réelles.Niveau : Intermédiaire · Temps estimé : 45–60 min · Versions / contexte : Cursor Skills · Claude Skills / Projects · Codex / Agent Skills · Custom GPTs · agentskills.io · Dernière vérification : 2026-09-11
Prérequis
- Hub IA pour DevOps : parcours 2026
- Voisins : Cursor Skills, Skills Claude, Routines, MCP DevOps
- Terminal bash ; lab local sous
/tmp— aucun token, kubeconfig ou clé API
Coût lab : 0 € (conso LLM selon offre / à revérifier).
Ce que nous allons construire
/tmp/lab-ai-skills-concept/
├── CATALOGUE.md (8 skills DevOps fictifs)
├── skills/
│ └── incident-triage-lab/
│ └── SKILL.md (stub minimal)
└── CHECKLIST.md
→ concept · vs prompt/rules/MCP/routines · carte 2026 · taxonomie · lab · anti-patterns
(Schéma à remplacer par une image locale, alt : « AI Skills : asset réutilisable vs prompt jetable, catalogue multi-outils DevOps 2026 ».)
Chapitre module D #28 : vocabulaire + catalogue avant de fabriquer. Objectif : assets versionnés, pas des prompts jetables.
Étape 1 — Qu’est-ce qu’un AI Skill ?
Un AI Skill est une procédure empaquetée et réutilisable : nom, description (quand l’utiliser), instructions, et optionnellement scripts ou références. L’agent la charge à la demande — auto-match sur la description, ou invocation explicite (/skill-name).
Ce n’est pas un collage one-shot : asset versionnable, reviewable en PR. En DevOps 2026, il remplace le « prompt magique » perdu dans Slack.
| Élément | Rôle |
|---|---|
name |
Identifiant stable (incident-triage-lab) |
description |
Déclencheur : « Use when… » |
| Instructions | Étapes, garde-fous, format de sortie |
| Scripts / refs | Smoke checks, check-lists — au besoin |
Skill = runbook exécutable par un agent, pas une conversation jetable.
Étape 2 — Skill vs prompt, Rule, GPT, MCP, routine
| Concept | Nature | Quand |
|---|---|---|
| Prompt jetable | Texte collé une fois | Exploration |
| Rule / guideline | Contrainte courte, souvent active | Norme permanente |
| Custom GPT / instructions | Persona + outils chat | Assistant thématique |
| MCP tool | Capacité d’appel (API, logs) | Quoi toucher |
| Skill | Procédure multi-étapes à la demande | Comment dérouler |
| Routine | Skill + déclencheur temps/événement | Digest, alerte — routines |
Rule = norme ; Skill = procédure ; MCP = connecteur ; Routine = horloge/webhook. Ne confondez pas skill et cron : sans déclencheur, le skill attend un appel.
Étape 3 — Pourquoi un catalogue DevOps ?
Sans catalogue, chacun réinvente le même prompt. Drift, risques prod, zéro ownership.
Cas prioritaires :
- Deploy runbooks — staging / canary, jamais destroy silencieux
- Incident triage — symptômes → 1 action HITL
- PR review — conventions, sécu, tests (draft)
- Terraform plan review — destroy, IAM trop large
- Secrets hygiene — scan patterns ; jamais de secrets dans le skill
- Docs sync — drift README / runbook vs code
Le catalogue répond : qui possède ? quel risque ? quand invoquer ? — inventaire versionné dans Git.
Étape 4 — Carte catalogue multi-outils 2026
Haut niveau (pas de versions inventées ; selon offre / changelog).
Cursor Skills
SKILL.md sous .cursor/skills/ ou ~/.cursor/skills/. Invocation /skill-name, auto-apply via description. Suite : Cursor Skills : créer et partager.
Claude Skills / Projects / CLAUDE.md
Instructions projet, skills / custom instructions (Projects, Claude Code, CLAUDE.md). Détail : Skills Claude.
Codex / Agent Skills
Dossiers skills (souvent .agents/skills/ ou équivalents Codex). Format converge vers dossiers + markdown — vérifiez la doc éditeur.
ChatGPT Custom GPTs / Actions
Voisins utiles mais pas identiques à un skill fichier repo. GPT = produit OpenAI ; skill équipe = Git. Voir Custom GPTs.
agentskills.io / format portable
Idée open Agent Skills : format portable multi-agents (interop 2026).
Compléments : Agent workflows, function calling, MCP DevOps, RAG docs infra.
Étape 5 — Taxonomie catalogue DevOps
| Champ | Exemple |
|---|---|
name |
incident-triage-lab |
| When-to-use | Alerte / symptôme prod |
| Owner | platform / SRE |
| Risk | low / medium / high |
| HITL | obligatoire si mutation |
Par domaine (deploy, incident, review, iac, security, docs) ; par risque (lecture → draft → mutation HITL) ; par portée (perso ~/ vs équipe repo).
Étape 6 — Lab /tmp/lab-ai-skills-concept
Lab offline, heredocs bash. Aucune API.
mkdir -p /tmp/lab-ai-skills-concept/skills/incident-triage-lab
cd /tmp/lab-ai-skills-concept
cat > CATALOGUE.md << 'EOF'
# Catalogue skills DevOps (lab fictif)
| name | when-to-use | owner | risk |
|------|-------------|-------|------|
| incident-triage-lab | Alerte / symptôme prod ; + 1 action HITL | sre-platform | medium |
| deploy-staging-runbook | Ship / promote staging après merge | platform | medium |
| pr-review-security | Review PR : secrets, IAM, deps | security-champions | low |
| terraform-plan-review | Plan : destroy, IAM large, drift | iac-owners | medium |
| secrets-hygiene-scan | Patterns secrets dans diff / logs | security-champions | low |
| docs-sync-runbook | Drift README/runbook vs code | docs-owners | low |
| ci-flaky-triage | Isoler job flaky, proposer quarantine | ci-maintainers | low |
| rollback-checklist | Checklist rollback (pas de cmd prod auto) | sre-platform | high |
EOF
cat > skills/incident-triage-lab/SKILL.md << 'EOF'
---
name: incident-triage-lab
description: Triage a suspected incident from symptoms or alerts. Use when the user reports prod symptoms, an alert, or asks to classify severity — lab only, no real APIs.
---
# Incident triage (lab)
## When to use
- User describes symptoms or pastes a fake alert summary
- Need short triage: severity, likely area, one human action
## Instructions
1. Summarize symptoms in ≤5 bullets (no invented metrics).
2. Propose severity SEV1 / SEV2 / SEV3 with one-line rationale.
3. Suggest exactly ONE non-destructive next step for a human (HITL).
4. Forbidden: restart prod, rotate secrets, call real APIs, invent green checks.
5. If data is missing, say what is missing — do not hallucinate logs.
EOF
cat > CHECKLIST.md << 'EOF'
# Checklist catalogue AI Skills (lab)
- [ ] name + when-to-use + owner + risk
- [ ] Aucun secret / token / kubeconfig dans les skills
- [ ] High-risk = HITL obligatoire
- [ ] Description « Use when… » (pas vague)
- [ ] Skill ≠ cron (déclencheur = routine)
- [ ] Revue PR du catalogue comme un runbook
EOF
Vérifiez : find /tmp/lab-ai-skills-concept -type f | sort. Inventaire + stub — détail création dans cursor-skills-creer.
Étape 7 — Anti-patterns
| Anti-pattern | Correctif |
|---|---|
| Mega-skill trop large | Un skill = un job clair |
| Description vague | « Use when… » + déclencheurs |
| Secrets dans le skill | Vault / runner ; stubs factices |
| Mutation prod sans HITL | Lecture + proposition humaine |
| Skill confondu avec cron | Skill = recette ; routine = déclencheur |
| Pas d’owner | Owner + revue trimestrielle |
Étape 8 — Bonnes pratiques + skill vs routine
- Noms
kebab-casestables. - Descriptions pour l’auto-match, pas le marketing.
- Versionnez dans Git ; review comme du code.
- Séparez MCP (outils) et skills (procédures).
- Évaluez avec fixtures — Évaluer un skill.
- Cataloguez avant de multiplier les skills perso.
| Skill | Routine | |
|---|---|---|
| Déclencheur | Humain / agent | Cron ou événement |
| Contenu | Recette / runbook | Recette + quand |
| Risque silence | Faible | Élevé → RAS, HITL |
Détail : ai-routines-agents.
Quiz (4 questions)
1. Un AI Skill, c’est surtout :
– A. Un prompt collé une seule fois dans le chat
– B. Une procédure empaquetée (name + description + instructions) chargée à la demande
– C. Un cron qui tourne chaque nuit sans fichier
2. Quelle affirmation est correcte ?
– A. MCP et Skill sont synonymes
– B. Une Rule remplace toujours un skill multi-étapes
– C. Le skill dit comment ; le MCP expose souvent quoi appeler
3. Anti-pattern majeur DevOps ?
– A. Catalogue avec owner + risk
– B. Secrets et kubeconfigs dans SKILL.md
– C. HITL sur les mutations
4. Dans le lab, CATALOGUE.md sert à :
– A. Remplacer GitHub Actions
– B. Inventarier name / when-to-use / owner / risk
– C. Publier automatiquement en production
Réponses : 1‑B · 2‑C · 3‑B · 4‑B
Compléments opérationnels
Standard de brief réutilisable
Pour ai-skills-concept, adoptez un brief unique partagé par l’équipe. Il contient toujours cinq champs : objectif mesurable, contexte borné (lab/staging), liste blanche de fichiers ou ressources, interdits explicites (secrets, réseau, prod), et definition of done exécutable (commande de test ou checklist). Sans ces champs, l’outil improvisera — parfois avec élégance, souvent hors périmètre.
Stockez les briefs gagnants sous briefs/ai-skills-concept/ dans un dépôt de documentation interne. Chaque brief cite le commit de référence et le modèle utilisé. Au troisième succès comparable, ouvrez une PR qui transforme le brief en rule, Skill ou slash command. Voir ai-skills-concept, claude-skills-instructions et evaluer-qualite-skill.
Revue de diff comme compétence P0
La vitesse d’un agent n’a aucune valeur si personne ne sait lire un diff. Instituez une règle simple : aucun apply massif sans parcours hunk par hunk. Posez-vous trois questions : ce changement est-il demandé ? est-il testé ? est-il réversible ? Si une réponse est non, refusez ou exigez un plan plus petit.
En atelier, faites commenter un diff à voix haute pendant cinq minutes. Les juniors apprennent ainsi le vocabulaire du refus. Reliez cette pratique à ai-code-review-pr et aux workflows ai-agent-workflows.
Sécurité continue
Les surfaces ai-skills-concept multiplient les occasions d’injection et de fuite. Traitez tickets, README upstream, logs et ressources MCP comme des données non fiables. Séparez instructions et données. Allowlist tools. Confirmation humaine avant mutation. Guide : ai-prompt-injection-securite, mcp-servers-devops, claude-code-mcp.
Secrets : variables d’environnement de session, gestionnaire d’équipe, rotation, jamais de commit. Si un secret fuit dans un chat vendor, supposez-le compromis et rotatez.
Coûts, modèles et mode dégradé
Documentez un mapping fast/strong et un soft-cap mensuel dans la stack perso. OpenRouter peut aider à basculer — openrouter-multi-modeles. Le local (ollama-llm-locaux + continue-dev) sert de mode dégradé ou de bac à sable confidentialité.
Surveillez les changements silencieux de modèle par défaut : une régression de qualité est souvent un routing vendor, pas « l’équipe qui a oublié comment prompter ».
Ancrage parcours
ai-skills-concept n’est qu’une étape du parcours IA DevOps 2026. Tronc commun d’abord (prompts, injection, skills), puis surface spécialisée, puis industrialisation (routines, MCP, RAG). Hub de navigation : /ia/. Comparatifs utiles : claude-vs-gpt-code, codex-vs-claude-code, claude-vs-cursor-vs-copilot.
FAQ
Skill ou prompt jetable pour une review PR ponctuelle ?
Prompt jetable OK pour explorer. Dès que la procédure revient : skill + entrée catalogue.
Skill vs Custom GPT ?
GPT = persona + Actions dans le produit chat. Skill = asset fichier reviewable en PR. Gouvernance DevOps → catalogue Git. Voir chatgpt-custom-gpts.
Faut-il un skill par outil (Cursor + Claude) ?
Préférez un cœur portable + adaptateurs minimes. Visez agentskills.io / dossiers communs quand pertinent.
Où mettre le catalogue ?
Repo plateforme ou monorepo docs/ops (CATALOGUE.md + dossiers skills). Lien hub IA parcours.
Comment éviter qu’un skill touche la prod ?
Risk high + HITL, pas de credentials dans le skill, scripts lab factices, MCP lecture seule. Voir MCP DevOps et routines.
RAG ou skill pour la doc infra ?
RAG pour retrouver ; skill pour dérouler. Souvent les deux : rag-docs-infra.
Pour aller plus loin
- Hub : IA parcours DevOps 2026
- Suite : Cursor Skills : créer et partager
- Aussi : Skills Claude · Agent workflows · MCP DevOps · RAG docs infra · Routines · Évaluer un skill · Function calling · Custom GPTs
- Réf. : agentskills.io · docs Cursor Skills · aide Claude Projects / Code
Maillage série IA Outils 2026 — Skills & agents
Retour parcours IA — hub Claude, Codex, ChatGPT et Skills.