Competenze

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.

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: 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:

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/<name>/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.

Installazione

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:

npx -y olostep-cli@latest add skills

Uso comune

# 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:

# 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 <path>`	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`	Destina tutti gli agenti rilevati
`--global` / `--no-global`	`--global`	Installa nelle directory delle competenze globali degli agenti
`--canonical-dir <path>`	`~/.agents/skills`	Posizione di archiviazione canonica
`--agent-skills-dir <path>`	—	Directory di destinazione personalizzata (richiede `--no-global`)
`--skill <name>`	—	Includi solo questa competenza — ripetibile
`--exclude <name>`	—	Escludi questa competenza — ripetibile
`--category`	—	`usage`, `build`, o `workflow`
`--overwrite` / `--no-overwrite`	`--overwrite`	Sostituisci le installazioni esistenti
`--link-mode <auto\|symlink\|copy>`	`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ì:

{
  "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 <key> per quelli specifici.

`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

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

# 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 <name>`	—	Rimuovi solo da agenti specificati — ripetibile
`--all-agents` / `--no-all-agents`	`--all-agents`	Destina tutti gli agenti rilevati
`--canonical-dir <path>`	`~/.agents/skills`	Directory canonica delle competenze 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`	—	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.

---
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 — documentazione completa dei comandi
Server MCP — fornisci al tuo agente strumenti Olostep live

Inizia

Funzionalità

Saldo e Fatturazione

Le competenze

Configurazione

Dati web principali

Costruisci e integra

Ricerca e debug

Categorie

Copie ospitate

Installazione

Uso comune

Riferimento opzioni

Forma dell’output JSON

Agenti supportati

`olostep list skills`

`olostep remove skills`

Scoperta e formato delle competenze

Convenzione di denominazione

Correlati

​Le competenze

​Configurazione

​Dati web principali

​Costruisci e integra

​Ricerca e debug

​Categorie

​Copie ospitate

​Installazione

​Uso comune

​Riferimento opzioni

​Forma dell’output JSON

​Agenti supportati

​olostep list skills

​olostep remove skills

​Scoperta e formato delle competenze

​Convenzione di denominazione

​Correlati

Le competenze

Configurazione

Dati web principali

Costruisci e integra

Ricerca e debug

Categorie

Copie ospitate

Installazione

Uso comune

Riferimento opzioni

Forma dell’output JSON

Agenti supportati

`olostep list skills`

`olostep remove skills`

Scoperta e formato delle competenze

Convenzione di denominazione

Correlati