Compétences - Olostep Docs

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.

Les compétences

olostep add skills installe toutes celles-ci. Chacune est un SKILL.md que votre agent lit pour savoir ce que Olostep peut faire et quand l’utiliser.

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 le 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
`docs-to-code`	Récupère des documents API et écrit du code fonctionnel à partir de ceux-ci
`integrate`	Installe automatiquement le SDK Olostep dans un projet
`migrate-code`	Lit un guide de migration et met à jour le code local
`research`	Recherche web comparative et citée pour une décision
`debug-error`	Recherche un message d’erreur dans GitHub / SO / docs en direct
`setup`	Apprend à l’agent comment configurer le serveur MCP

Les compétences se combinent 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.

Catégories

Chaque compétence appartient à l’une des trois catégories :

Compétences d’utilisation — utilisent les fonctionnalités d’Olostep : scrape, search, answers, crawl, map, batch.
Compétences de construction — installent et intègrent Olostep dans une base de code : setup (configure le serveur MCP) et integrate (ajoute le SDK Olostep à un projet).
Compétences de flux de travail — produisent un livrable avec Olostep : research, docs-to-code, migrate-code, debug-error, extract-schema.

Installez juste une catégorie avec olostep add skills --category usage (ou build, ou workflow). 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 avoir des capacités ajoutées depuis l’installation), et sinon se rabat sur la copie locale. Parcourez toutes les compétences hébergées sur olostep.com/skills.

`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écutez sans installer
npx -y olostep-cli@latest add skills

Utilisation

# Installe toutes les compétences dans tous les agents détectés (par défaut)
olostep add skills

# Authentifiez-vous d'abord, puis installez
olostep add skills --login

# Ciblez 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écute une connexion via le 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 CLI
`--agent <name>`	—	Cible 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`	Installe dans les répertoires de compétences globales connus des agents
`--canonical-dir <path>`	`~/.agents/skills`	Emplacement de stockage canonique pour les compétences Olostep
`--agent-skills-dir <path>`	—	Répertoire de compétences cible personnalisé (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`	Remplace les cibles existantes
`--link-mode <auto\|symlink\|copy>`	`auto`	`auto` essaie de lier symboliquement, sinon copie
`--json`	—	Émet 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" }
      ]
    }
  ]
}

`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'homme
olostep list skills --json     # lisible par machine

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 avec les champs name et description. Les noms dupliqués et nettoyés sont rejetés.

---
name: research-agent
description: Agent de recherche autonome pour une investigation web approfondie
---

# Agent de Recherche

...instructions de compétence ici...

Agents supportés

Agent	Clé
Cursor	`cursor`
Claude	`claude`
Codex	`codex`
Windsurf	`windsurf`
Continue	`continue`
Augment	`augment`
Roo	`roo`
Gemini	`gemini`
Copilot	`copilot`
Factory	`factory`

Chaque clé correspond à un chemin de répertoire de compétences connu dans le répertoire personnel. Utilisez --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 nettoyés 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

# Supprime toutes les compétences Olostep de tous les agents
olostep remove skills

# Supprime une compétence spécifique
olostep remove skills --skill research-agent

# Supprime 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>`	—	Supprime 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 de compétences canonique à partir duquel supprimer
`--agent-skills-dir <path>`	—	Répertoire de compétences cible personnalisé pour la suppression
`--skill <name>`	—	Supprime uniquement les compétences correspondantes — répétable
`--json`	—	Émet 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-.

Documentation Index

​Les compétences

​Catégories

​olostep add skills

​Installer le CLI

​Utilisation

​Options

​Sortie JSON

​olostep list skills

​Découverte et format des compétences

​Agents supportés

​Convention de nommage

​olostep remove skills

​Utilisation

​Options

Les compétences

Catégories

`olostep add skills`

Installer le CLI

Utilisation

Options

Sortie JSON

`olostep list skills`

Découverte et format des compétences

Agents supportés

Convention de nommage

`olostep remove skills`

Utilisation

Options