> ## 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. # Competenze > Installa e gestisci le competenze di Olostep nei tuoi agenti di codifica AI Installa le cartelle delle competenze di Olostep direttamente nei tuoi agenti di codifica AI dalla riga di comando. * Le competenze vengono collocate in un archivio canonico (`~/.agents/skills`) e sono collegate simbolicamente o copiate nella directory delle competenze di ciascun agente * Tiene traccia di tutte le installazioni in un file di blocco in `~/.agents/.skill-lock.json` * Funziona con Cursor, Claude, Codex, Windsurf, Continue e altri Questa funzionalità è disponibile tramite l'[Olostep CLI](/sdks/cli). ## Le competenze `olostep add skills` installa tutte le 13. Ciascuna è un `SKILL.md` che il tuo agente legge per sapere **cosa** può fare Olostep e **quando** usarlo. Le competenze si abbinano al [server MCP](/integrations/mcp-server): il server MCP fornisce all'agente gli *strumenti* live, le competenze gli danno il *know-how* su quando e come usarli. ### Configurazione Inizia qui — insegna all'agente come configurare il server MCP di Olostep. | Competenza | Cosa fa | | ---------- | -------------------------------------------------------------------------------- | | `setup` | Configura il server MCP di Olostep affinché tutte le altre competenze funzionino | ### Dati web principali Le principali capacità di Olostep — usale per dare al tuo agente accesso web live. | Competenza | Cosa fa | | ---------------- | --------------------------------------------------------------------- | | `scrape` | Trasforma un URL in markdown / HTML / JSON / testo pulito | | `search` | Ricerca web live — risultati, risposte e scoperta di URL nel sito | | `answers` | Risposte strutturate e citate dai dati web live | | `crawl` | Scansiona autonomamente un intero sito | | `map` | Scopri ogni URL su un sito | | `batch` | Scansiona fino a 10.000 URL in parallelo | | `extract-schema` | Scansiona una pagina in JSON strutturato che corrisponde a uno schema | ### Costruisci e integra Per agenti che aiutano gli sviluppatori ad aggiungere Olostep a un codice o a tenere il passo con i cambiamenti delle API. | Competenza | Cosa fa | | -------------- | ------------------------------------------------------------------- | | `integrate` | Installa automaticamente l'SDK di Olostep in un progetto | | `docs-to-code` | Scansiona la documentazione API e scrivi codice funzionante da essa | | `migrate-code` | Leggi una guida alla migrazione e aggiorna il codice locale | ### Ricerca e debug Per agenti che fanno ricerca, prendono decisioni o eseguono il debug di errori nel codice. | Competenza | Cosa fa | | ------------- | ----------------------------------------------------------------- | | `research` | Ricerca web comparativa e citata per una decisione | | `debug-error` | Cerca un messaggio di errore su GitHub / SO / documentazione live | ### Categorie Ogni competenza appartiene a una delle tre categorie, che si mappano al flag `--category`: * **`usage`** — usa le funzionalità di Olostep: `scrape`, `search`, `answers`, `crawl`, `map`, `batch`, `extract-schema`. * **`build`** — installa e integra Olostep in un codice: `setup` (configura il server MCP) e `integrate` (aggiungi l'SDK di Olostep a un progetto). * **`workflow`** — produce un deliverable con Olostep: `research`, `docs-to-code`, `migrate-code`, `debug-error`. Installa solo una categoria: ```bash theme={null} olostep add skills --category usage # competenze di dati web principali olostep add skills --category build # competenze di configurazione + integrazione olostep add skills --category workflow # competenze di ricerca + deliverable ``` ### Copie ospitate Ogni competenza installata fa anche riferimento alla sua copia ospitata su `https://www.olostep.com/skills//SKILL.md` — un agente con accesso web può recuperare l'ultima versione (che può includere capacità aggiunte dopo l'installazione) e, in caso contrario, utilizza la copia locale. Sfoglia tutte le competenze ospitate su [olostep.com/skills](https://www.olostep.com/skills/index.md). ## Installazione ```bash theme={null} npm install -g olostep-cli # Installa tutte le 13 competenze in ogni agente rilevato olostep add skills # Oppure usa il sottocomando delle competenze (alias) olostep skills install ``` Oppure senza installare il CLI: ```bash theme={null} npx -y olostep-cli@latest add skills ``` ## Uso comune ```bash theme={null} # Installa tutte le competenze olostep skills install # Aggiorna / aggiorna all'ultima versione olostep skills update # Vedi cosa è installato e dove olostep skills list # Rimuovi tutte le competenze olostep skills uninstall ``` Filtra cosa viene installato: ```bash theme={null} # Solo competenze di dati web principali olostep add skills --category usage # Solo competenze di configurazione + integrazione olostep add skills --category build # Selezione personalizzata olostep add skills --skill scrape --skill search --skill setup # Solo agenti specifici olostep add skills --agent cursor --agent claude # Output leggibile dalla macchina olostep add skills --json ``` ## Riferimento opzioni | Opzione | Predefinito | Descrizione | | ----------------------------------- | -------------------------- | ----------------------------------------------------------------------------------- | | `--login` | — | Esegui il login del browser prima dell'installazione | | `--source ` | Competenze incluse nel CLI | Directory di origine delle competenze | | `--cli-local-dir ` | CLI/skills | Directory dove le competenze di origine sono sincronizzate per l'uso locale del CLI | | `--agent ` | — | Destina un agente specifico — ripetibile | | `--all-agents` / `--no-all-agents` | `--all-agents` | Destina tutti gli agenti rilevati | | `--global` / `--no-global` | `--global` | Installa nelle directory delle competenze globali degli agenti | | `--canonical-dir ` | `~/.agents/skills` | Posizione di archiviazione canonica | | `--agent-skills-dir ` | — | Directory di destinazione personalizzata (richiede `--no-global`) | | `--skill ` | — | Includi solo questa competenza — ripetibile | | `--exclude ` | — | Escludi questa competenza — ripetibile | | `--category` | — | `usage`, `build`, o `workflow` | | `--overwrite` / `--no-overwrite` | `--overwrite` | Sostituisci le installazioni esistenti | | `--link-mode ` | `auto` | `auto` prova prima il collegamento simbolico, poi copia | | `--json` | — | Output JSON leggibile dalla macchina | **Regole di validazione:** * `--link-mode` deve essere `auto`, `symlink`, o `copy` * `--agent-skills-dir` richiede `--no-global` * `--no-global` richiede `--agent-skills-dir` * Nomi di agenti sconosciuti genereranno un errore * Una selezione di competenze vuota dopo `--skill` / `--exclude` genererà un errore ### Forma dell'output JSON Quando viene passato `--json`, l'output appare così: ```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" } ] } ] } ``` ## Agenti supportati | Agente | Chiave | | -------- | ---------- | | Cursor | `cursor` | | Claude | `claude` | | Codex | `codex` | | Windsurf | `windsurf` | | Continue | `continue` | | Augment | `augment` | | Roo | `roo` | | Gemini | `gemini` | | Copilot | `copilot` | | Factory | `factory` | Usa `--all-agents` (il predefinito) per destinare tutti gli agenti rilevati, o `--agent ` per quelli specifici. ## `olostep list skills` Vedi quali competenze sono installate e in quali agenti — senza scavare tra i file. ```bash theme={null} olostep list skills # riepilogo leggibile dall'uomo olostep list skills --json # leggibile dalla macchina ``` ## `olostep remove skills` Rimuove le cartelle delle competenze installate da Olostep dall'archivio canonico e dalle directory delle competenze degli agenti, e pulisce il file di blocco. ```bash theme={null} # Rimuovi tutte le competenze di Olostep da tutti gli agenti olostep remove skills # Rimuovi una competenza specifica olostep remove skills --skill research # Rimuovi solo da un agente specifico olostep remove skills --agent cursor # Output JSON leggibile dalla macchina olostep remove skills --json ``` | Opzione | Predefinito | Descrizione | | ---------------------------------- | ------------------ | -------------------------------------------------------------------------- | | `--agent ` | — | Rimuovi solo da agenti specificati — ripetibile | | `--all-agents` / `--no-all-agents` | `--all-agents` | Destina tutti gli agenti rilevati | | `--canonical-dir ` | `~/.agents/skills` | Directory canonica delle competenze da cui rimuovere | | `--agent-skills-dir ` | — | Directory delle competenze di destinazione personalizzata per la rimozione | | `--skill ` | — | Rimuovi solo le competenze corrispondenti — ripetibile | | `--json` | — | Output JSON leggibile dalla macchina | **Sicurezza:** Solo le cartelle con il prefisso `olostep-` vengono toccate. Le cartelle delle competenze non-Olostep nelle directory degli agenti non vengono mai modificate. La pulizia del file di blocco rimuove solo le chiavi con prefisso `olostep-`. ## Scoperta e formato delle competenze Le competenze vengono scoperte scansionando le sottodirectory per un file `SKILL.md`. Il file deve includere un blocco di frontmatter YAML con i campi `name` e `description`. I nomi duplicati sanitizzati vengono rifiutati. ```markdown theme={null} --- name: my-skill description: Cosa fa questa competenza e quando usarla --- # My Skill ...istruzioni per la competenza qui... ``` ## Convenzione di denominazione Le cartelle installate usano sempre il prefisso `olostep-` — ad esempio, `research` diventa `olostep-research`. I nomi sono sanitizzati in minuscolo con caratteri non validi sostituiti da `-`. Questo prefisso mantiene le competenze gestite da Olostep chiaramente identificabili e previene conflitti con altri strumenti. ## Correlati * [Riferimento CLI](/sdks/cli) — documentazione completa dei comandi * [Server MCP](/integrations/mcp-server) — fornisci al tuo agente strumenti Olostep live