Competenze - Olostep Docs

Installa le cartelle delle competenze Olostep direttamente nei tuoi agenti di codifica AI dalla riga di comando.

Installa le competenze Olostep in agenti come Cursor, Claude, Codex, Windsurf e altri
Le competenze si trovano 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 su ~/.agents/.skill-lock.json

Questa funzionalità è disponibile tramite l’Olostep CLI.

Le competenze

olostep add skills installa tutte queste. Ciascuna è un SKILL.md che il tuo agente legge per sapere cosa può fare Olostep e quando usarlo.

Competenza	Cosa fa
`scrape`	Trasforma un URL in markdown / HTML / JSON / testo pulito
`search`	Ricerca web in tempo reale — risultati, risposte e scoperta di URL nel sito
`answers`	Risposte strutturate e citate dai dati web in tempo reale
`crawl`	Esegue autonomamente il crawling di un intero sito
`map`	Scopre ogni URL su un sito
`batch`	Esegue scraping di fino a 10.000 URL in parallelo
`extract-schema`	Esegue scraping di una pagina in JSON strutturato che corrisponde a uno schema
`docs-to-code`	Esegue scraping di documentazione API e scrive codice funzionante da essa
`integrate`	Installa automaticamente l’SDK Olostep in un progetto
`migrate-code`	Legge una guida alla migrazione e aggiorna il codice locale
`research`	Ricerca web comparativa e citata per una decisione
`debug-error`	Cerca un messaggio di errore su GitHub / SO / documenti in tempo reale
`setup`	Insegna all’agente come configurare il server MCP

Le competenze si abbinano al server MCP: il server MCP fornisce all’agente gli strumenti in tempo reale, le competenze gli danno il know-how su quando e come usarli.

Categorie

Ogni competenza appartiene a una delle tre categorie:

Competenze di utilizzo — usano le funzionalità di Olostep: scrape, search, answers, crawl, map, batch.
Competenze di costruzione — installano e integrano Olostep in una base di codice: setup (configura il server MCP) e integrate (aggiunge l’SDK Olostep a un progetto).
Competenze di flusso di lavoro — producono un risultato con Olostep: research, docs-to-code, migrate-code, debug-error, extract-schema.

Installa solo una categoria con olostep add skills --category usage (o build, o workflow). Ogni competenza installata fa anche riferimento alla sua copia ospitata su https://www.olostep.com/skills/<name>/SKILL.md — un agente con accesso web può recuperare l’ultima versione (che potrebbe avere capacità aggiunte dopo l’installazione), e altrimenti ricorre alla copia locale. Sfoglia tutte le competenze ospitate su olostep.com/skills.

`olostep add skills`

Sincronizza le competenze da una directory di origine nel CLI, le installa nell’archivio canonico, quindi le distribuisce nella directory delle competenze di ciascun agente.

Installa il CLI

# Installazione globale
npm install -g olostep-cli

# Oppure esegui senza installare
npx -y olostep-cli@latest add skills

Utilizzo

# Installa tutte le competenze in tutti gli agenti rilevati (predefinito)
olostep add skills

# Autenticati prima, quindi installa
olostep add skills --login

# Destina agenti specifici
olostep add skills --agent cursor --agent claude

# Copia sempre invece di collegare simbolicamente
olostep add skills --link-mode copy

# Output JSON leggibile dalla macchina
olostep add skills --json

Opzioni

Opzione	Predefinito	Descrizione
`--login`	—	Esegui il login del browser prima dell’installazione
`--source <path>`	Dir competenze incluse nel CLI	Directory di origine delle competenze
`--cli-local-dir <path>`	CLI/skills	Directory dove le competenze di origine sono sincronizzate per l’uso locale del CLI
`--agent <name>`	—	Destina un agente specifico — ripetibile
`--all-agents` / `--no-all-agents`	`--all-agents`	Se non è impostato `--agent`, destina tutti gli agenti installati rilevati
`--global` / `--no-global`	`--global`	Installa nelle directory delle competenze globali degli agenti noti
`--canonical-dir <path>`	`~/.agents/skills`	Posizione di archiviazione canonica per le competenze Olostep
`--agent-skills-dir <path>`	—	Directory delle competenze di destinazione personalizzata (richiede `--no-global`)
`--skill <name>`	—	Includi solo questa competenza — ripetibile
`--exclude <name>`	—	Escludi questa competenza — ripetibile
`--overwrite` / `--no-overwrite`	`--overwrite`	Sostituisci i target esistenti
`--link-mode <auto\|symlink\|copy>`	`auto`	`auto` prova il collegamento simbolico, ricorre alla copia
`--json`	—	Emetti 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
I nomi degli agenti sconosciuti genereranno un errore
Una selezione di competenze vuota dopo --skill / --exclude genererà un errore

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

Vedi quali competenze sono installate e in quali agenti — senza scavare tra i file.

olostep list skills            # riepilogo leggibile dall'uomo
olostep list skills --json     # leggibile dalla macchina

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 con i campi name e description. I nomi duplicati e sanitizzati vengono rifiutati.

---
name: research-agent
description: Agente di ricerca autonomo per indagini approfondite sul web
---

# Agente di Ricerca

...istruzioni per la competenza qui...

Agenti supportati

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

Ogni chiave mappa a un percorso noto della directory delle competenze nella home directory. Usa --all-agents (predefinito) per destinare tutti gli agenti installati rilevati, o passa --agent <key> per destinare quelli specifici.

Convenzione di denominazione

I nomi delle cartelle installate usano sempre il prefisso olostep-: ad esempio, research-agent diventa olostep-research-agent. I nomi sono sanitizzati in minuscolo con caratteri non validi sostituiti da -. Questo prefisso mantiene chiaramente identificabili le competenze gestite da Olostep e previene conflitti con altri strumenti.

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

Utilizzo

# Rimuovi tutte le competenze Olostep da tutti gli agenti
olostep remove skills

# Rimuovi una competenza specifica
olostep remove skills --skill research-agent

# Rimuovi solo da un agente specifico
olostep remove skills --agent cursor

# Output JSON leggibile dalla macchina
olostep remove skills --json

Opzioni

Opzione	Predefinito	Descrizione
`--agent <name>`	—	Rimuovi solo da agenti specificati — ripetibile
`--all-agents` / `--no-all-agents`	`--all-agents`	Se non è impostato `--agent` o una directory personalizzata, utilizza tutti gli agenti installati rilevati
`--canonical-dir <path>`	`~/.agents/skills`	Directory delle competenze canoniche da cui rimuovere
`--agent-skills-dir <path>`	—	Directory delle competenze di destinazione personalizzata per la rimozione
`--skill <name>`	—	Rimuovi solo le competenze corrispondenti — ripetibile
`--json`	—	Emetti output JSON leggibile dalla macchina

Sicurezza: Vengono toccate solo le cartelle con il prefisso olostep-. Le cartelle degli agenti non-Olostep non vengono mai modificate. La pulizia del file di blocco rimuove solo le chiavi con prefisso olostep-.

Documentation Index

​Le competenze

​Categorie

​olostep add skills

​Installa il CLI

​Utilizzo

​Opzioni

​Output JSON

​olostep list skills

​Scoperta e formato delle competenze

​Agenti supportati

​Convenzione di denominazione

​olostep remove skills

​Utilizzo

​Opzioni

Le competenze

Categorie

`olostep add skills`

Installa il CLI

Utilizzo

Opzioni

Output JSON

`olostep list skills`

Scoperta e formato delle competenze

Agenti supportati

Convenzione di denominazione

`olostep remove skills`

Utilizzo

Opzioni