Installez les dossiers de compétences Olostep directement dans vos agents de codage IA depuis la ligne de commande.
- 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
- Fonctionne avec Cursor, Claude, Codex, Windsurf, Continue, et plus encore
Cette fonctionnalité est disponible via le CLI Olostep.
Les compétences
olostep add skills installe les 13. Chacune est un SKILL.md que votre agent lit pour savoir ce que Olostep peut faire et quand l’utiliser.
Les compétences s’associent avec le serveur MCP : le serveur MCP fournit à l’agent les outils en direct, les compétences lui donnent le savoir-faire pour savoir quand et comment les utiliser.
Configuration
Commencez ici — enseigne à l’agent comment configurer le serveur MCP Olostep.
| Compétence | Ce qu’elle fait |
|---|
setup | Configure le serveur MCP Olostep pour que toutes les autres compétences fonctionnent |
Données web principales
Les principales capacités d’Olostep — utilisez-les pour donner à votre agent un accès web en direct.
| Compétence | Ce qu’elle fait |
|---|
scrape | Transforme une URL en markdown / HTML / JSON / texte propre |
search | Recherche web en direct — résultats, réponses, et découverte d’URL sur site |
answers | Réponses structurées et citées à partir de données web en direct |
crawl | Explore de manière autonome un site entier |
map | Découvre chaque URL sur un site |
batch | Récupère jusqu’à 10 000 URLs en parallèle |
extract-schema | Récupère une page en JSON structuré correspondant à un schéma |
Construire & intégrer
Pour les agents aidant les développeurs à ajouter Olostep à une base de code ou à suivre les changements d’API.
| Compétence | Ce qu’elle fait |
|---|
integrate | Installe automatiquement le SDK Olostep dans un projet |
docs-to-code | Récupère les docs API et écrit du code fonctionnel à partir de celles-ci |
migrate-code | Lit un guide de migration et met à jour le code local |
Recherche & débogage
Pour les agents effectuant des recherches, prenant des décisions ou déboguant des erreurs de code.
| Compétence | Ce qu’elle fait |
|---|
research | Recherche web comparative et citée pour une décision |
debug-error | Recherche un message d’erreur sur GitHub / SO / docs en direct |
Catégories
Chaque compétence appartient à l’une des trois catégories, qui correspondent au drapeau --category :
usage — utiliser les fonctionnalités d’Olostep : scrape, search, answers, crawl, map, batch, extract-schema.build — installer et intégrer Olostep dans une base de code : setup (configurer le serveur MCP) et integrate (ajouter le SDK Olostep à un projet).workflow — produire un livrable avec Olostep : research, docs-to-code, migrate-code, debug-error.
Installez juste une catégorie :
olostep add skills --category usage # compétences principales de données web
olostep add skills --category build # compétences de configuration + intégration
olostep add skills --category workflow # compétences de recherche + livrables
Copies hébergées
Chaque compétence installée fait également référence à sa copie hébergée à https://www.olostep.com/skills/<name>/SKILL.md — un agent avec accès web peut récupérer la dernière version (qui peut inclure des capacités ajoutées depuis l’installation) et se rabat sur la copie locale sinon. Parcourez toutes les compétences hébergées sur olostep.com/skills.
Installation
npm install -g olostep-cli
# Installe toutes les 13 compétences dans chaque agent détecté
olostep add skills
# Ou utilisez la sous-commande skills (alias)
olostep skills install
npx -y olostep-cli@latest add skills
Utilisation courante
# Installe toutes les compétences
olostep skills install
# Rafraîchir / mettre à jour vers la dernière version
olostep skills update
# Voir ce qui est installé et où
olostep skills list
# Supprimer toutes les compétences
olostep skills uninstall
# Seulement les compétences principales de données web
olostep add skills --category usage
# Seulement les compétences de configuration + intégration
olostep add skills --category build
# Choisir à la carte
olostep add skills --skill scrape --skill search --skill setup
# Seulement des agents spécifiques
olostep add skills --agent cursor --agent claude
# Sortie lisible par machine
olostep add skills --json
Référence des options
| Option | Par défaut | Description |
|---|
--login | — | Exécute la connexion au navigateur avant l’installation |
--source <path> | Compétences intégrées au CLI | Répertoire source des compétences |
--cli-local-dir <path> | CLI/skills | Répertoire où les compétences source sont synchronisées pour une utilisation locale CLI |
--agent <name> | — | Cible un agent spécifique — répétable |
--all-agents / --no-all-agents | --all-agents | Cible tous les agents détectés |
--global / --no-global | --global | Installe dans les répertoires de compétences d’agent global |
--canonical-dir <path> | ~/.agents/skills | Emplacement de stockage canonique |
--agent-skills-dir <path> | — | Répertoire cible personnalisé (nécessite --no-global) |
--skill <name> | — | Inclut seulement cette compétence — répétable |
--exclude <name> | — | Exclut cette compétence — répétable |
--category | — | usage, build, ou workflow |
--overwrite / --no-overwrite | --overwrite | Remplace les installations existantes |
--link-mode <auto|symlink|copy> | auto | auto essaie d’abord le lien symbolique, puis se rabat sur la copie |
--json | — | 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
--json est passé, la sortie ressemble à :
{
"sync": {
"plugin_source_dir": "/path/to/CLI/skills",
"cli_local_dir": "/path/to/CLI/skills"
},
"selected_skills": ["scrape", "search"],
"canonical_dir": "~/.agents/skills",
"lockfile_path": "~/.agents/.skill-lock.json",
"installed": [
{
"skill": "scrape",
"canonical_path": "~/.agents/skills/olostep-scrape",
"targets": [
{ "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-scrape" },
{ "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-scrape" }
]
}
]
}
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 détectés, ou --agent <key> pour des agents spécifiques.
olostep list skills
Voyez quelles compétences sont installées et dans quels agents — sans fouiller dans les fichiers.
olostep list skills # résumé lisible par l'humain
olostep list skills --json # lisible par machine
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.
# Supprime toutes les compétences Olostep de tous les agents
olostep remove skills
# Supprime une compétence spécifique
olostep remove skills --skill research
# Supprime uniquement d'un agent spécifique
olostep remove skills --agent cursor
# Sortie JSON lisible par machine
olostep remove skills --json
| Option | Par défaut | Description |
|---|
--agent <name> | — | Supprime uniquement des agents spécifiés — répétable |
--all-agents / --no-all-agents | --all-agents | Cible tous les agents 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> | — | Supprime uniquement les compétences correspondantes — répétable |
--json | — | Sortie JSON lisible par machine |
Sécurité : Seuls les dossiers avec le préfixe olostep- sont touchés. Les dossiers de compétences non-Olostep dans les répertoires d’agents ne sont jamais modifiés. Le nettoyage du fichier de verrouillage ne supprime que les clés préfixées par olostep-.
SKILL.md. Le fichier doit inclure un bloc de frontmatter YAML avec les champs name et description. Les noms dupliqués et assainis sont rejetés.
---
name: my-skill
description: Ce que fait cette compétence et quand l'utiliser
---
# Ma Compétence
...instructions de compétence ici...
Convention de nommage
Les dossiers installés utilisent toujours le préfixe olostep- — par exemple, research devient olostep-research. Les noms sont assainis en minuscules avec les caractères invalides remplacés par -. Ce préfixe permet de garder les compétences gérées par Olostep clairement identifiables et évite les conflits avec d’autres outils.
Connexes
