Installez les dossiers de compétences Olostep directement dans vos agents de codage IA depuis la ligne de commande.
- Installe les compétences Olostep dans des agents comme Cursor, Claude, Codex, Windsurf, et plus encore
- Les compétences sont placées dans un magasin canonique (
~/.agents/skills) et sont liées symboliquement ou copiées dans le répertoire de compétences de chaque agent
- Suit toutes les installations dans un fichier de verrouillage à
~/.agents/.skill-lock.json
Cette fonctionnalité est disponible via le CLI Olostep.
olostep add skills
Synchronise les compétences depuis un répertoire source dans le CLI, les installe dans le magasin canonique, puis les déploie dans le répertoire de compétences de chaque agent.
Installer le CLI
# Installation globale
npm install -g olostep-cli
# Ou exécuter sans installer
npx -y olostep-cli@latest add skills
Utilisation
# Installer toutes les compétences dans tous les agents détectés (par défaut)
olostep add skills
# Authentification d'abord, puis installation
olostep add skills --login
# Cibler des agents spécifiques
olostep add skills --agent cursor --agent claude
# Toujours copier au lieu de lier symboliquement
olostep add skills --link-mode copy
# Sortie JSON lisible par machine
olostep add skills --json
Options
| Option | Par défaut | Description |
|---|
--login | — | Exécuter la connexion au navigateur avant l’installation |
--source <path> | Répertoire de compétences intégré au CLI | Répertoire source des compétences |
--cli-local-dir <path> | CLI/skills | Répertoire où les compétences sources sont synchronisées pour une utilisation locale du CLI |
--agent <name> | — | Cibler un agent spécifique — répétable |
--all-agents / --no-all-agents | --all-agents | Si aucun --agent n’est défini, cible tous les agents installés détectés |
--global / --no-global | --global | Installer dans les répertoires de compétences globales connus de l’agent |
--canonical-dir <path> | ~/.agents/skills | Emplacement de stockage canonique pour les compétences Olostep |
--agent-skills-dir <path> | — | Répertoire cible personnalisé pour les compétences (nécessite --no-global) |
--skill <name> | — | Inclure uniquement cette compétence — répétable |
--exclude <name> | — | Exclure cette compétence — répétable |
--overwrite / --no-overwrite | --overwrite | Remplacer les cibles existantes |
--link-mode <auto|symlink|copy> | auto | auto essaie de lier symboliquement, puis se rabat sur la copie |
--json | — | Émettre une sortie JSON lisible par machine |
Règles de validation :
--link-mode doit être auto, symlink, ou copy--agent-skills-dir nécessite --no-global--no-global nécessite --agent-skills-dir- Les noms d’agents inconnus provoqueront une erreur
- Une sélection de compétences vide après
--skill / --exclude provoquera une erreur
Sortie JSON
{
"sync": {
"plugin_source_dir": "/path/to/CLI/skills",
"cli_local_dir": "/path/to/CLI/skills"
},
"selected_skills": ["research-agent"],
"canonical_dir": "~/.agents/skills",
"lockfile_path": "~/.agents/.skill-lock.json",
"installed": [
{
"skill": "research-agent",
"canonical_path": "~/.agents/skills/olostep-research-agent",
"targets": [
{ "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-research-agent" },
{ "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-research-agent" }
]
}
]
}
SKILL.md. Le fichier doit inclure un bloc de métadonnées avec les champs name et description. Les noms dupliqués et assainis sont rejetés.
---
name: research-agent
description: Agent de recherche autonome pour l'investigation du web profond
---
# Agent de Recherche
...instructions de compétence ici...
Agents pris en charge
| Agent | Clé |
|---|
| Cursor | cursor |
| Claude | claude |
| Codex | codex |
| Windsurf | windsurf |
| Continue | continue |
| Augment | augment |
| Roo | roo |
| Gemini | gemini |
| Copilot | copilot |
| Factory | factory |
--all-agents (par défaut) pour cibler tous les agents installés détectés, ou passez --agent <key> pour cibler des agents spécifiques.
Convention de nommage
Les noms de dossiers installés utilisent toujours le préfixe olostep- : par exemple, research-agent devient olostep-research-agent. Les noms sont assainis en minuscules avec les caractères invalides remplacés par -. Ce préfixe permet d’identifier clairement les compétences gérées par Olostep et évite les conflits avec d’autres outils.
olostep remove skills
Supprime les dossiers de compétences installés par Olostep du magasin canonique et des répertoires de compétences des agents, et nettoie le fichier de verrouillage.
Utilisation
# Supprimer toutes les compétences Olostep de tous les agents
olostep remove skills
# Supprimer une compétence spécifique
olostep remove skills --skill research-agent
# Supprimer uniquement d'un agent spécifique
olostep remove skills --agent cursor
# Sortie JSON lisible par machine
olostep remove skills --json
Options
| Option | Par défaut | Description |
|---|
--agent <name> | — | Supprimer uniquement des agents spécifiés — répétable |
--all-agents / --no-all-agents | --all-agents | Si aucun --agent ou répertoire personnalisé, utilise tous les agents installés détectés |
--canonical-dir <path> | ~/.agents/skills | Répertoire canonique des compétences à supprimer |
--agent-skills-dir <path> | — | Répertoire cible personnalisé pour la suppression |
--skill <name> | — | Supprimer uniquement les compétences correspondantes — répétable |
--json | — | Émettre une sortie JSON lisible par machine |
Sécurité : Seuls les dossiers avec le préfixe olostep- sont touchés. Les dossiers d’agents non-Olostep ne sont jamais modifiés. Le nettoyage du fichier de verrouillage ne supprime que les clés préfixées par olostep-.
