Agent Skills

Les Skills sont des paquets d'instructions portables qui suivent la norme ouverte Agent Skills. Ils regroupent des instructions, des scripts et des modèles dans des paquets réutilisables que Kiro peut activer lorsqu'ils sont pertinents pour votre tâche.

Kiro prend en charge la norme Agent Skills, ce qui vous permet d'importer des Skills de la communauté ou d'autres outils d'IA compatibles, et de partager vos propres Skills dans l'écosystème.

Les agents d'IA sont de plus en plus capables, mais il leur manque souvent le contexte précis nécessaire pour le travail réel. Sans connaissance du processus de déploiement de votre équipe, des normes de révision de code de votre entreprise ou du pipeline d'analyse de données de votre projet, les agents devinent et itèrent - tout comme vous le feriez en apprenant quelque chose de nouveau.

Charger tout ce contexte dès le départ n'est pas non plus pratique. Trop d'information submerge l'agent, ce qui ralentit les réponses et réduit la qualité.

Les Skills résolvent ce problème grâce à la divulgation progressive :

1. Découverte - Au démarrage, Kiro charge seulement le nom et la description de chaque Skill
2. Activation - Lorsque votre requête correspond à la description d'un Skill, Kiro charge les instructions complètes
3. Exécution - Kiro suit les instructions, en chargeant les scripts ou les fichiers de référence seulement au besoin

Cela permet de garder le contexte ciblé tout en donnant à Kiro accès à des connaissances spécialisées étendues à la demande.

Les Skills peuvent s'activer de deux façons :

• Automatiquement - Kiro compare votre requête aux descriptions des Skills et charge le Skill pertinent
• Comme commandes à barre oblique - Tapez / suivi du nom du Skill pour l'invoquer directement

Les Skills peuvent être créés avec une portée d'espace de travail ou une portée globale.

Lorsque des Skills portent le même nom, les Skills d'espace de travail ont priorité sur les Skills globaux. Cela vous permet de définir des Skills globaux qui s'appliquent généralement à tous vos espaces de travail, tout en conservant la possibilité de les remplacer pour des projets précis.

{
  "name": "my-agent",
  "resources": [
    "skill://.kiro/skills/*/SKILL.md",
    "skill://~/.kiro/skills/*/SKILL.md"
  ]
}

Le schéma d'URI skill:// prend en charge des chemins précis, des motifs génériques (glob) et l'expansion du répertoire personnel.

Un Skill est un dossier contenant un fichier SKILL.md :

my-skill/
├── SKILL.md           # Required
├── scripts/           # Optional executable code
├── references/        # Optional documentation
└── assets/            # Optional templates

Le fichier commence par un en-tête YAML suivi d'instructions en markdown :

---
name: pr-review
description: Review pull requests for code quality, security issues, and test coverage. Use when reviewing PRs or preparing code for review.
---

## Review checklist

When reviewing a pull request:

1. Check for vulnerabilities, injection risks, exposed secrets
2. Verify edge cases and failure modes are handled
3. Confirm new code has appropriate tests
4. Ensure variables and functions have clear names

## Common issues to flag

- Hardcoded credentials or API keys
- Missing input validation
- Unhandled promise rejections
- Console.log statements left in production code

Consultez la spécification complète pour les contraintes détaillées des champs.

Pour une documentation étendue, utilisez un dossier references/ :

aws-deployment/
├── SKILL.md
└── references/
    ├── ecs-guide.md
    └── troubleshooting.md

Référencez les fichiers dans votre SKILL.md :

For ECS deployments, follow the guide in `references/ecs-guide.md`.

Kiro charge les fichiers de référence seulement lorsque les instructions le lui indiquent.

Un Skill de déploiement CDK :

cdk-deploy/
├── SKILL.md
└── references/
    └── stack-patterns.md

SKILL.md :

---
name: cdk-deploy
description: Deploy AWS CDK stacks with best practices. Use when deploying infrastructure, running cdk deploy, or troubleshooting CDK issues.
---

## Deployment workflow

1. Run `cdk synth` to validate templates before deploying
2. Use `cdk diff` to preview what will change
3. Run `cdk deploy` and review IAM changes

## Pre-deployment checks

- Verify AWS credentials are configured for the target account
- Check that the CDK version matches the project's requirements
- Review `references/stack-patterns.md` for environment-specific patterns

## Rollback procedure

If deployment fails:
1. Check CloudFormation console for the specific error
2. Run `cdk destroy` only if the stack is in a failed state
3. Fix the issue and redeploy

Utilisation :

> Deploy my CDK stack to staging

I'll follow the deployment workflow. First, let me synthesize the templates...

Les Skills sont des paquets portables suivant une norme ouverte. Ils se chargent à la demande et peuvent inclure des scripts. À utiliser pour les flux de travail réutilisables que vous voulez partager ou importer d'autres personnes.

Le Steering est un contexte propre à Kiro qui façonne le comportement de l'agent. Il prend en charge les modes always, auto, fileMatch et manual. À utiliser pour les normes et conventions de projet.

Les Powers regroupent des outils MCP avec des connaissances et des flux de travail. Ils s'activent dynamiquement selon le contexte. À utiliser pour les intégrations où vous avez besoin à la fois d'outils et de conseils.

Rédigez des descriptions précises - La description déterminait quand Kiro active le Skill. Incluez des mots-clés et des actions précis qui correspondent à la façon dont vous formuleriez vos requêtes :

• Bon : Review pull requests for security vulnerabilities and test coverage. Use when reviewing PRs or preparing code for review.
• Vague : Helps with code review

Gardez SKILL.md ciblé - Placez le matériel de référence détaillé dans des fichiers references/. Kiro charge le SKILL.md complet lors de l'activation, alors gardez-le concret.

Utilisez des scripts pour les tâches déterministes - La validation, la génération de fichiers et les appels d'API fonctionnent mieux comme scripts que comme code généré par un grand modèle de langage.

Choisissez la bonne portée - Global pour les flux de travail personnels que vous utilisez partout (votre liste de vérification de révision). Espace de travail pour les procédures d'équipe et les conventions propres au projet.

Gérez les skills d'espace de travail avec le contrôle de version - Faites un commit de .kiro/skills/ dans votre dépôt pour que l'équipe partage les mêmes flux de travail.

• Steering - Contexte et normes propres au projet
• Powers - Intégrations MCP avec connaissances intégrées
• Agents personnalisés - Configuration et ressources de l'agent
• Spécification Agent Skills - Détails complets du format