Skillshare CLI

CLI Skillshare

Use Skillshare para manter uma fonte e distribuir recursos para destinos configurados. Leia apenas a referência relevante para a operação solicitada; a tabela de roteamento está abaixo. Verifique skillshare <comando> --help se a versão instalada for diferente destes exemplos.

Escopo e seleção de recursos

• Configuração global: ~/.config/skillshare/config.yaml. Configuração do projeto: .skillshare/config.yaml ou skillshare/config.yaml; o arquivo oculto vence quando ambos existem. Use -g ou -p explicitamente quando a localização for importante, em vez de confiar na detecção automática.
• Habilidades são diretórios contendo SKILL.md; agentes são arquivos Markdown individuais. Os caminhos de origem podem ser personalizados. Use as fontes configuradas em vez de assumir os padrões.
• Cópias rastreadas de skills/<agente-conhecido>/<caminho-habilidade>/SKILL.md formam uma habilidade lógica por repositório/prefixo/sufixo. Merge/copy seleciona a variante exata do agente (incluindo aliases e identidade agent: da conta). O reconhecimento requer o mesmo sufixo sob dois agentes canônicos distintos. Destinos compatíveis que compartilham uma pasta selecionam a união de suas identidades de agente; um destino somente universal não infere um agente. Status conta habilidades lógicas e variantes físicas; operações de lista e sincronização mantêm nomes físicos. Destinos/sobrescritas explícitos e filtros físicos ainda se aplicam. O modo de link de diretório inteiro expõe todas as variantes. Veja sync.md.
• Use destinos de agentes nativos para agentes. Use extras para recursos de arquivo arbitrários ou quando for necessário achatamento/transformação de conteúdo; extension: funciona apenas em destinos de extras.
• Notas de memória compartilhada vivem no extra memory. Use extras memory para gerenciar notas Markdown e orientação de leitura; caminhos aninhados, como wiki/architecture.md, são suportados. Leia extras.md para escopo, verificações de versão e configuração do agente. Para uma retrospectiva de sessão ou Dreaming (sonhar) entre notas salvas, leia memory-review.md. O agente host realiza a revisão; Skillshare nunca inicia ou agenda um agente.
• MCP usa seus próprios destinos receptores e definições de origem. Leia mcp.md antes de editar configurações MCP ou importar configurações nativas. Suas notas de Agente cobrem o que é específico para Claude Code, Codex, OpenCode e Pi: escopos e arquivos, nomes e credenciais que eles recusam, o MCP embutido do Pi e piOptions, o MCP nativo do OMP e listas preservadas de ativar/desativar, a política portátil tools, atualizando configurações do Pi desde a versão 0.22, desligando um servidor global em um projeto, mcp.projects para muitas pastas a partir de uma configuração, e mcp serve para Agentes que não conseguem alcançar as pastas de habilidades sincronizadas.
• Plugins mantêm seus componentes nativos juntos. Leia plugins.md para instalação, importação, seleção de sincronização, atualizações e limites de compatibilidade nativa entre Claude, Codex, Cursor, Antigravity, Pi, OMP e OpenCode, incluindo pacotes Pi do pi.dev e plugins do marketplace OMP e seleção de extensão independente.
• Hooks preservam o mapa de eventos nativo de cada Agente ou código de extensão/plugin. Leia hooks.md antes de importar, sincronizar ou recuperar.

Regras de execução

1. Escolha entradas não interativas. Forneça nomes e flags de seleção suportados pelo comando específico. Use --no-tui para saída simples ou --json onde suportado. Não adicione --force apenas para evitar um prompt: ele pode sobrescrever conflitos ou anular auditorias.
2. Mantenha prévias separadas de gravações. Use --dry-run onde suportado. Após alterar habilidades ou agentes, sincronize o recurso e escopo pretendidos. Mutações de MCP e hooks salvam a origem apenas a menos que --sync seja fornecido; sync --all também inclui extras, MCP e hooks, mas exclui plugins.
3. Inspecione blocos de auditoria. Revise as descobertas antes de escolher uma sobrescrita. install --json permite sobrescrita e seleciona tudo quando nenhum filtro de habilidade/agente é fornecido, mas retém a porta de auditoria; não é meramente um formato de saída. Leia install.md e audit.md antes de usá-lo para automação.
4. Use o mecanismo de recuperação correspondente. Habilidades desinstaladas vão para a lixeira; entradas MCP nativas usam backups MCP. Não substitua exclusão de sistema de arquivos por desinstalação via CLI.
5. Mantenha credenciais fora das definições MCP. Use referências {fromEnv: VARIABLE}. Gerenciar configurações não requer resolver segredos, copiar credenciais OAuth, iniciar servidores ou sondar suas ferramentas.
6. Respeite o escopo da operação. O trabalho de configuração local não implica permissão para commitar, enviar ou publicar. Execute esses comandos quando incluídos na solicitação do usuário.

Fluxos de trabalho comuns

Inspecionar e diagnosticar

skillshare status --json
skillshare list --json
skillshare diff --json
skillshare doctor --json
skillshare mcp --json

doctor sai com código 1 quando encontra erros. Auditoria usa --format json; flags JSON e disponibilidade da TUI variam por comando. Veja a referência relevante em vez de assumir paridade.

Rastrear um repositório upstream ou instalar habilidades selecionadas

Escolha o recurso e o escopo antes de instalar. Use -g para recursos de todo o usuário ou -p para este projeto; mantenha esse escopo na prévia, aplicação, atualização e sincronização.

Intenção	Comando
Manter uma coleção de habilidades upstream como um checkout Git	skillshare install owner/repo --track --name team -g
Instalar apenas habilidades nomeadas com seus metadados de origem	skillshare install owner/repo -s pdf,commit -g
Instalar todas as habilidades descobertas individualmente	skillshare install owner/repo --all -g
Gerenciar um plugin nativo completo, incluindo hooks/MCP	Use plugin discover e plugin add; veja abaixo

Para o fluxo de trabalho de prévia com escopo → aplicar → atualizar → sincronizar, leia install.md. Ele cobre seguir o branch upstream mais recente, combinações de flags rejeitadas e filtros de destino.

Para configuração de projeto, use init -p, depois install -p e sync -p. Reidrate dependências remotas configuradas com install sem uma origem. Para detalhes completos de flags e agentes, leia install.md e sync.md.

Para usar um checkout local de habilidades no lugar, execute skillshare link <caminho> --enable, depois sync; skillshare unlink <nome> remove apenas o link. Leia TROUBLESHOOTING.md para saber como esses links são seguidos.

Desabilitar ou remover

skillshare disable 'draft-*' --dry-run
skillshare disable 'draft-*'
skillshare enable 'draft-*'
skillshare uninstall my-skill
skillshare sync
skillshare trash restore my-skill
skillshare sync

Execute a operação solicitada, não esta sequência completa de exemplos. Coloque padrões glob entre aspas para que Skillshare os receba inalterados. Desabilitar usa regras de ignorar; desinstalar usa a lixeira.

Mover habilidades para pastas

skillshare move my-skill frontend --dry-run
skillshare move my-skill other-skill frontend
skillshare sync

Use move em vez de mv para habilidades instaladas: isso mantém seus registros de instalação, então nada é baixado novamente. Não sincroniza; execute sync depois. Leia install.md para recusas e modo de projeto.

Pastas de projeto a partir da configuração global

skillshare project list --json
skillshare project localize ~/work/existing --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --sync
skillshare project edit app --skills-include 'frontend-*'
skillshare project sync app --json
skillshare project remove app --dry-run --json

project sempre usa a configuração global, inclusive dentro de um repositório; não aceita -p. Novos projetos são salvos em config.yaml, ou apenas nesta máquina com --machine-local ou projects_storage: machine-local (--shared sobrescreve a configuração); localize e share movem um entre os dois. Remover uma cópia local de um projeto config.yaml mantém a versão de config.yaml a menos que --shared seja fornecido. Editar filtros substitui listas. A remoção desanexa habilidades e mantém arquivos de agente; a remoção JSON requer --yes a menos que seja prévia. Leia targets.md para falhas de salvar-depois-sincronizar, novas tentativas e resultados de remoção parcial.

Configurações MCP

skillshare mcp import --from claude --json
skillshare mcp add docs --url https://example.com/mcp --target claude --no-tui
skillshare sync mcp --dry-run --json
skillshare sync mcp

--target é singular e repetível. Uma prévia não aplica alterações. Para revisões, edição, conflitos de importação, credenciais, backups e comandos TUI operados por humanos, leia mcp.md.

Plugins completos

Use plugin discover e plugin add para um pacote nativo completo; plugin import adota uma instalação nativa existente. Execute apenas a operação solicitada. Leia plugins.md antes de aplicar alterações; ele cobre o fluxo de trabalho upstream com escopo, destinos suportados e regras de source-ref. plugin check/update lida com alterações upstream; sync plugins reconcilia a seleção de destino. Plugins são excluídos de sync --all.

Hubs de habilidades

skillshare hub add https://example.com/hub.json          # Salvar uma fonte de hub
skillshare hub add https://example.com/hub.json --label my-hub  # Com rótulo personalizado
skillshare hub add [email protected]:team/skills.git --label ghe  # Fonte de hub SSH/privada/GHE
skillshare hub list                                      # Listar hubs salvos
skillshare hub default my-hub                            # Definir hub padrão
skillshare hub remove my-hub                             # Remover um hub
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit  # Construir índice do hub

A configuração ativa follow_source_links também se aplica a hub index (incluindo --source), pesquisa de dashboard embutida e candidatos a rascunho do Hub.

Referências

Leia o arquivo correspondente para flags de comando, exemplos e limitações. Evite carregar todas as referências para uma única tarefa.

Tópico	Arquivo
Agentes nativos, seleção, regras de ignorar e recuperação	native-agents.md
Configuração MCP, importações, TUI e recuperação	mcp.md
Hooks nativos, bindings de código, escopos e recuperação	hooks.md
Plugins completos, ciclo de vida nativo e seleção de sincronização	plugins.md
Flags do init	init.md
Sync/collect/commit/push/pull	sync.md
Install/update/uninstall/move/new	install.md
Status/diff/list/search/check	status.md
Auditoria de segurança	audit.md
Revisando uma habilidade não confiável antes de instalar	audit-review.md
Lixeira	trash.md
Log de operações	log.md
Destinos	targets.md
Extras (regras/comandos/prompts)	extras.md
Retrospectivas de sessão e Dreaming (sonhar) sobre notas salvas	memory-review.md
Backup/restore	backup.md
Solução de problemas	TROUBLESHOOTING.md