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