Créer des plugins
Un paquet Agent Plugins 1.0 est un dossier avec plugin.json à sa racine et des Skills, une configuration MCP ou les deux. Commencez par le plus petit composant répondant au besoin de vos utilisateurs. Un Skill fournit des instructions ; MCP fournit une connexion à des outils.
Disponibilité
L’installateur natif actuel, CLI, peut valider et installer des paquets standard. Les versions peuvent varier selon le canal ; vérifiez la version installée avec agentplugins version. Il n’inclut pas agentplugins author. Les commandes de création de ce parcours décrivent des compilations du code source actuel où la création est activée. Les preuves de publication des outils de création 0.1.65 restent propres à cette version et ne décrivent pas l’installateur actuel.
Vous pouvez écrire les fichiers à la main et utiliser l’installateur publié, ou compiler les outils ci-dessous pour créer une structure initiale, effectuer des vérifications statiques et lancer explicitement un cycle MCP. Une vérification statique réussie ne prouve ni l’activation par un client natif ni le bon fonctionnement d’une connexion à un service.
Écrivez un petit paquet à la main
Créez cette structure :
review-helper/
plugin.json
skills/
review-docs/
SKILL.mdDéfinissez l’identité du paquet dans plugin.json :
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "review-helper",
"version": "0.1.0",
"description": "Vérifier la clarté et les éléments justificatifs des modifications de documentation"
}Commencez skills/review-docs/SKILL.md ainsi :
---
name: review-docs
description: À utiliser pour examiner la clarté et les preuves d’une documentation.
---
# Examiner la documentation
Identifiez le lecteur et la tâche. Vérifiez les entrées et les effets de chaque
commande. Distinguez le comportement vérifié des prérequis et des affirmations
non testées. Signalez les problèmes avec leur emplacement et une correction.Installez le gestionnaire publié, puis validez et prévisualisez le paquet :
npm install -g universal-agent-plugins
agentplugins validate ./review-helper
agentplugins add ./review-helper --target codex --dry-runExaminez le plan et consultez Utiliser des plugins pour l’appliquer. La structure du paquet explique le rôle de chaque fichier.
Préparez les outils de création depuis le code source
Les commandes suivantes compilent la CLI actuelle avec les outils de création activés. Elle nécessite Git et la version de Go déclarée par le dépôt, actuellement Go 1.26.11. Notez le commit extrait lorsque vous partagez des résultats.
git clone https://github.com/777genius/universal-agent-plugins.git
cd universal-agent-plugins/cli
mkdir -p ../bin
authoring_module=$(go list -f '{{.Module.Path}}' ./cmd/agentplugins)
authoring_revision=$(git rev-parse HEAD)
go build -ldflags "-X ${authoring_module}/internal/authoring/commands.Enabled=release-cli-contract-v1 -X ${authoring_module}/internal/authoring/commands.Revision=${authoring_revision}" \
-o ../bin/agentplugins ./cmd/agentplugins
export PATH="$(cd ../bin && pwd):$PATH"
agentplugins author --helpUtilisez un autre dossier de travail pour les paquets des exemples. Ce binaire est une compilation de développement ; sa présence ne qualifie pas une publication publique des outils de création. Vérifiez le chemin de l’exécutable si le gestionnaire indique encore que la commande author est inconnue.
Choisissez une structure initiale
| Besoin | Parcours | Entrées de modèle obligatoires |
|---|---|---|
| Instructions pour un agent | Un Skill | --template skill |
| Connexion à un service existant | MCP distant | --template mcp-remote --url <endpoint> |
| Processus MCP local en Node | MCP stdio | --template mcp-stdio --runtime node |
| Instructions et outils | Plugin hybride | --template hybrid --mcp-template <choice> et les entrées de ce modèle MCP |
Un paquet avec un seul Skill contient toujours plugin.json à sa racine. Installer des Skills autonomes depuis un autre dépôt relève d’une opération de l’installateur distincte.
Suivez le cycle de création
- Créez un paquet dans une destination absente, puis modifiez les fichiers générés.
- Lancez validate, inspect et le test statique sur la racine exacte.
- Vérifiez les clients visés avec
compatet examinez les preuves dedoctor. - Pour MCP, évaluez l’exécution séparément et explicitement avec la compilation du code source.
- Partagez le paquet et ses preuves au moyen de la transmission à l’installateur.
Le code source actuel propose aussi bootstrap fondé sur un fichier de verrouillage, dev en continu, normalize pour JSON et import native explicite pour MCP de Claude. Consultez les vérifications et MCP stdio. La génération de projections pour les clients, l’exportation de paquets et leur publication restent hors de ces commandes de création. Les hooks propres aux clients restent distincts des composants portables Skill et MCP.