> ## Documentation Index > Fetch the complete documentation index at: https://docs.olostep.com/llms.txt > Use this file to discover all available pages before exploring further. # Compétences > Installez et gérez les compétences Olostep dans vos agents de codage IA 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](/sdks/cli). ## 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](/integrations/mcp-server) : 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 : ```bash theme={null} 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//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](https://www.olostep.com/skills/index.md). ## Installation ```bash theme={null} 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 ``` Ou sans installer le CLI : ```bash theme={null} npx -y olostep-cli@latest add skills ``` ## Utilisation courante ```bash theme={null} # 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 ``` Filtrez ce qui est installé : ```bash theme={null} # 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 ` | Compétences intégrées au CLI | Répertoire source des compétences | | `--cli-local-dir ` | CLI/skills | Répertoire où les compétences source sont synchronisées pour une utilisation locale CLI | | `--agent ` | — | 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 ` | `~/.agents/skills` | Emplacement de stockage canonique | | `--agent-skills-dir ` | — | Répertoire cible personnalisé (nécessite `--no-global`) | | `--skill ` | — | Inclut seulement cette compétence — répétable | | `--exclude ` | — | Exclut cette compétence — répétable | | `--category` | — | `usage`, `build`, ou `workflow` | | `--overwrite` / `--no-overwrite` | `--overwrite` | Remplace les installations existantes | | `--link-mode ` | `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 ### Forme de sortie JSON Lorsque `--json` est passé, la sortie ressemble à : ```json theme={null} { "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` | Utilisez `--all-agents` (par défaut) pour cibler tous les agents détectés, ou `--agent ` pour des agents spécifiques. ## `olostep list skills` Voyez quelles compétences sont installées et dans quels agents — sans fouiller dans les fichiers. ```bash theme={null} 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. ```bash theme={null} # 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 ` | — | 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 ` | `~/.agents/skills` | Répertoire canonique des compétences à supprimer | | `--agent-skills-dir ` | — | Répertoire cible personnalisé pour la suppression | | `--skill ` | — | 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-`. ## Découverte et format des compétences Les compétences sont découvertes en scannant les sous-répertoires pour un fichier `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. ```markdown theme={null} --- 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 * [Référence CLI](/sdks/cli) — documentation complète des commandes * [Serveur MCP](/integrations/mcp-server) — donnez à votre agent des outils Olostep en direct