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

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

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

{
  "$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"]
}

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.

Vous pouvez aussi inclure ces champs dans votre manifeste :

{
  "$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"
}

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

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

---
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.

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.

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.

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

{
  "$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).

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

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

Poussez votre power vers un dépôt GitHub public :

git init
git add plugin.json mcp.json skills/ dev.kiro/
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.

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/

• Spécification Agent Plugins - La norme ouverte sur laquelle sont conçus les powers
• Aperçu des powers - Ce que sont les powers et comment ils fonctionnent
• Installer des powers - Installer depuis la place de marché ou GitHub
• Skills - Ensembles d'instructions portables et autonomes
• Configuration MCP - Référence de configuration du serveur MCP