Passer au contenu principal
Afficher en Markdown

Créer des powers

Les développeurs peuvent utiliser nos powers organisés à partir du registre de powers, notamment Datadog, Figma, Neon, Netlify, Postman, Supabase et Stripe, ou concevoir et partager leurs propres powers pour n'importe quel outil ou framework. Des membres de la communauté ont aussi créé des powers pour créer des applications SaaS, gérer une infrastructure AWS CDK et créer des agents avec Pydantic AI.

Les powers suivent la spécification Agent Plugins — un format ouvert et neutre par rapport aux fournisseurs pour regrouper des composants réutilisables qui étendent les agents d'IA. Lorsque vous mentionnez des mots-clés pertinents, Kiro charge automatiquement le contexte et les outils du power.

Consultez nos powers organisés à kiro.dev/powers

Ce dont vous avez besoin

Chaque power nécessite un manifeste plugin.json. Vous pouvez aussi, en option, ajouter :

  • skills/ — des Agent Skills avec des instructions propres à une tâche
  • mcp.json — la configuration du serveur MCP pour les intégrations d'outils

Créer plugin.json

Votre manifeste plugin.json identifie le power et indique à Kiro quand l'activer. Au minimum, il exige :

json
{ "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "supabase", "version": "1.0.0", "description": "Build fullstack applications with Supabase's Postgres database, authentication, storage, and real-time subscriptions", "author": { "name": "Supabase" }, "keywords": ["database", "postgres", "auth", "storage", "realtime", "backend", "supabase", "rls"] }

Champs obligatoires

ChampDescription
$schemaURL du schéma : https://agent-plugins.org/schemas/1.0.0/plugin.schema.json
nameIdentifiant du plugiciel (kebab-case, sans espaces). Utilisé à l'interne par Kiro pour identifier le power.
versionVersion sémantique du power (p. ex. 1.0.0).
descriptionCourte description de ce que fait le power.
authorObjet contenant au minimum un champ name. Peut aussi inclure email et url.
keywordsTableau de chaînes qui déclenchent l'activation. Utilisez des termes qui correspondent à la façon dont les développeurs parlent de votre outil.

Lorsque quelqu'un dit « Configurons la base de données », Kiro voit « database » dans les mots-clés et active le power Supabase. Les outils MCP et les skills du power se chargent automatiquement dans le contexte.

Champs optionnels

Vous pouvez aussi inclure ces champs dans votre manifeste :

json
{ "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "supabase", "version": "1.0.0", "description": "Build fullstack applications with Supabase", "author": { "name": "Supabase", "url": "https://supabase.com" }, "keywords": ["database", "postgres", "supabase"], "homepage": "https://supabase.com/docs", "repository": "https://github.com/supabase/kiro-power", "license": "Apache-2.0" }

Ajouter des skills

Les skills sont des instructions qui guident l'agent tout au long de tâches précises. Chaque skill se trouve dans son propre répertoire sous skills/ et nécessite un fichier SKILL.md.

skills/ └── setup/ ├── SKILL.md ├── scripts/ │ └── validate-setup.sh └── references/ └── schema-patterns.md

SKILL.md

Le fichier SKILL.md contient les instructions que suit l'agent lorsque le skill est invoqué. Structurez-le avec des étapes claires :

markdown
--- name: setup description: Set up a new Supabase project with local development --- # Set up Supabase ## Step 1: Validate dependencies Before using Supabase, ensure the following are installed: - **Docker Desktop**: Required for the local development stack - Verify with: `docker --version` - **Supabase CLI**: Install via npm or Homebrew - Verify with: `supabase --version` ## Step 2: Initialize the project Run `supabase init` to create the project configuration. ## Step 3: Start local services Run `supabase start` to spin up the local Supabase stack.

Scripts

Le répertoire scripts/ contient les fichiers exécutables que l'agent peut lancer pendant l'exécution du skill. Utilisez des scripts pour la validation, l'automatisation de la configuration ou des tâches de génération de code.

References

Le répertoire references/ contient de la documentation complémentaire, comme de la documentation, des exemples ou des définitions de schéma que l'agent peut consulter pendant l'exécution du skill.

Ajouter des serveurs MCP

Si votre power fournit des outils MCP, créez un fichier mcp.json à la racine du power :

json
{ "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json", "mcpServers": { "supabase-local": { "type": "stdio", "command": "npx", "args": ["-y", "@supabase/mcp-server-supabase"], "env": { "SUPABASE_URL": "${SUPABASE_URL}", "SUPABASE_ANON_KEY": "${SUPABASE_ANON_KEY}" } } } }

Utilisez des variables d'environnement pour les clés d'API et les secrets. Pendant l'installation, Kiro attribue automatiquement un espace de noms aux noms de serveurs pour éviter les conflits (p. ex., supabase-local devient power-supabase-supabase-local).

Structure de répertoire

Voici à quoi ressemble un power complet :

power-supabase/ ├── plugin.json # Required manifest ├── mcp.json # MCP server configuration └── skills/ # Agent Skills ├── setup/ │ ├── SKILL.md │ └── scripts/ │ └── validate-deps.sh └── migrations/ ├── SKILL.md └── references/ └── migration-patterns.md

Tester en local

  1. Créez votre répertoire de power avec les fichiers ci-dessus
  2. Ouvrez Kiro → panneau Powers → Add Custom Power
  3. Sélectionnez Import power from a folder
  4. Sélectionnez votre répertoire de power
  5. Testez l'activation en utilisant des mots-clés de votre power dans une conversation

Partager votre power

Un power peut se trouver à la racine d'un dépôt ou dans un dossier. Vous pouvez aussi inclure plusieurs powers dans un même dépôt, à condition que chacun ait son propre dossier. Poussez votre power vers un dépôt GitHub public :

bash
git init git add . git commit -m "Initial release" git push origin main

D'autres personnes peuvent l'installer via Add Custom Power → Import power from GitHub en utilisant l'URL de votre dépôt.

Exemples

Power minimal (manifeste seulement) :

power-simple-tool/ ├── plugin.json # Keywords and description └── mcp.json # MCP server configuration

Power avec skills seulement (sans MCP) :

power-react-patterns/ ├── plugin.json └── skills/ ├── component-patterns/ │ └── SKILL.md └── hooks-patterns/ └── SKILL.md

Power complet avec tous les composants :

power-full-stack/ ├── plugin.json ├── mcp.json └── skills/ ├── setup/ │ ├── SKILL.md │ └── scripts/ └── deployment/ ├── SKILL.md └── references/

Documentation connexe

Page mise à jour : 8 octobre 2026