Installa le cartelle delle competenze di Olostep direttamente nei tuoi agenti di codifica AI dalla riga di comando.
- Installa le competenze di Olostep in agenti come Cursor, Claude, Codex, Windsurf e altri
- Le competenze vengono inserite 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
Questa funzionalità è disponibile tramite l’Olostep CLI.
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, poi 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 delle 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 globali delle competenze degli agenti conosciuti |
--canonical-dir <path> | ~/.agents/skills | Posizione di archiviazione canonica per le competenze di 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, ripiega sulla 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" }
]
}
]
}
SKILL.md. Il file deve includere un blocco di frontmatter con i campi name e description. I nomi duplicati sanitizzati vengono rifiutati.
---
name: research-agent
description: Agente di ricerca autonomo per l'indagine sul web profondo
---
# 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 |
--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 i caratteri non validi sostituiti da -. Questo prefisso mantiene le competenze gestite da Olostep chiaramente identificabili 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 di 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 dagli agenti specificati — ripetibile |
--all-agents / --no-all-agents | --all-agents | Se non ci sono --agent o dir personalizzato, usa tutti gli agenti installati 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 | — | 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-.
