Compétences

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

Ou sans installer le CLI :

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

Filtrez ce qui est installé :

# 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

Forme de sortie JSON

Lorsque --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`

Utilisez --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-.

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.

---
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 — documentation complète des commandes
Serveur MCP — donnez à votre agent des outils Olostep en direct

Commencer

Fonctionnalités

Solde et Facturation

Les compétences

Configuration

Données web principales

Construire & intégrer

Recherche & débogage

Catégories

Copies hébergées

Installation

Utilisation courante

Référence des options

Forme de sortie JSON

Agents pris en charge

`olostep list skills`

`olostep remove skills`

Découverte et format des compétences

Convention de nommage

Connexes

​Les compétences

​Configuration

​Données web principales

​Construire & intégrer

​Recherche & débogage

​Catégories

​Copies hébergées

​Installation

​Utilisation courante

​Référence des options

​Forme de sortie JSON

​Agents pris en charge

​olostep list skills

​olostep remove skills

​Découverte et format des compétences

​Convention de nommage

​Connexes

Les compétences

Configuration

Données web principales

Construire & intégrer

Recherche & débogage

Catégories

Copies hébergées

Installation

Utilisation courante

Référence des options

Forme de sortie JSON

Agents pris en charge

`olostep list skills`

`olostep remove skills`

Découverte et format des compétences

Convention de nommage

Connexes