Skillshare CLI

CLI de Skillshare

Usa Skillshare para mantener una fuente y distribuir recursos a destinos configurados. Lee solo la referencia relevante para la operación solicitada; la tabla de enrutamiento está debajo. Verifica skillshare <comando> --help si la versión instalada difiere de estos ejemplos.

Alcance y selección de recursos

• Configuración global: ~/.config/skillshare/config.yaml. Configuración de proyecto: .skillshare/config.yaml o skillshare/config.yaml; el archivo oculto gana cuando ambos existen. Usa -g o -p explícitamente cuando la ubicación importe, en lugar de confiar en la detección automática.
• Las habilidades son directorios que contienen SKILL.md; los agentes son archivos Markdown individuales. Las rutas de origen se pueden personalizar. Usa las fuentes configuradas en lugar de asumir valores predeterminados.
• Las copias de skills/<agente-conocido>/<ruta-habilidad>/SKILL.md rastreadas forman una habilidad lógica por repositorio/prefijo/sufijo. Fusionar/copiar selecciona la variante exacta del agente (incluyendo alias e identidad agent: de la cuenta). El reconocimiento requiere el mismo sufijo bajo dos agentes canónicos distintos. Los destinos compatibles que comparten una carpeta seleccionan la unión de sus identidades de agente; un destino solo universal no infiere un agente. El estado cuenta habilidades lógicas y variantes físicas; las listas y operaciones de sincronización conservan nombres físicos. Los destinos explícitos/sobrescrituras y filtros físicos aún se aplican. El modo de enlace simbólico de directorio completo expone todas las variantes. Consulta sync.md.
• Usa destinos de agentes nativos para agentes. Usa extras para recursos de archivo arbitrarios o cuando se requiera aplanamiento/transformación de contenido; extension: funciona solo en destinos de extras.
• Las notas de memoria compartidas viven en el extra memory. Usa extras memory para gestionar notas Markdown y guía de lectura; se admiten rutas anidadas como wiki/architecture.md. Lee extras.md para alcance, verificaciones de versión y configuración del agente. Para una retrospectiva de sesión o soñar (Dreaming) sobre notas guardadas, lee memory-review.md. El agente anfitrión realiza la revisión; Skillshare nunca lanza o programa un agente.
• MCP usa sus propios destinos receptores y definiciones de origen. Lee mcp.md antes de editar configuraciones MCP o importar configuraciones nativas. Sus notas de agente cubren lo que es específico de Claude Code, Codex, OpenCode y Pi: ámbitos y archivos, nombres y credenciales que rechazan, MCP incorporado de Pi y piOptions, MCP nativo de OMP y listas de habilitar/deshabilitar preservadas, la política portable tools, actualizar la configuración de Pi desde 0.22, apagar un servidor global en un proyecto, mcp.projects para muchas carpetas desde una configuración, y mcp serve para Agentes que no pueden alcanzar las carpetas de habilidades sincronizadas.
• Los plugins mantienen sus componentes nativos juntos. Lee plugins.md para instalación, importación, selección de sincronización, actualizaciones y límites de compatibilidad nativa en Claude, Codex, Cursor, Antigravity, Pi, OMP y OpenCode, incluyendo paquetes Pi de pi.dev y plugins del mercado de OMP y selección de extensiones independientes.
• Los hooks preservan el mapa de eventos nativo o el código de extensión/plugin de cada Agente. Lee hooks.md antes de importar, sincronizar o recuperar.

Reglas de ejecución

1. Elige entradas no interactivas. Proporciona nombres y banderas de selección compatibles con el comando específico. Usa --no-tui para salida simple o --json donde sea compatible. No agregues --force solo para evitar un aviso: puede sobrescribir conflictos o anular auditorías.
2. Mantén las vistas previas separadas de las escrituras. Usa --dry-run donde sea compatible. Después de cambiar habilidades o agentes, sincroniza el recurso y alcance previstos. Las mutaciones de MCP y hooks guardan solo la fuente a menos que se proporcione --sync; sync --all también incluye extras, MCP y hooks, pero excluye plugins.
3. Inspecciona los bloques de auditoría. Revisa los hallazgos antes de elegir una sobrescritura. install --json permite sobrescribir y selecciona todo cuando no se da ningún filtro de habilidad/agente, pero retiene la puerta de auditoría; no es solo un formato de salida. Lee install.md y audit.md antes de usarlo para automatización.
4. Usa el mecanismo de recuperación correspondiente. Las habilidades desinstaladas van a la papelera; las entradas MCP nativas usan copias de seguridad de MCP. No sustituyas la eliminación del sistema de archivos por la desinstalación de la CLI.
5. Mantén las credenciales fuera de las definiciones MCP. Usa referencias {fromEnv: VARIABLE}. Gestionar configuraciones no requiere resolver secretos, copiar credenciales OAuth, iniciar servidores o sondear sus herramientas.
6. Respeta el alcance de la operación. El trabajo de configuración local no implica permiso para hacer commit, push o publicar. Ejecuta esos comandos cuando estén incluidos en la solicitud del usuario.

Flujos de trabajo comunes

Inspeccionar y diagnosticar

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

doctor sale con código 1 cuando encuentra errores. La auditoría usa --format json; las banderas JSON y la disponibilidad de la TUI varían según el comando. Consulta la referencia relevante en lugar de asumir paridad.

Rastrear un repositorio upstream o instalar habilidades seleccionadas

Elige el recurso y el alcance antes de instalar. Usa -g para recursos de todo el usuario o -p para este proyecto; mantén ese alcance en vista previa, aplicación, actualización y sincronización.

Intención	Comando
Mantener una colección de habilidades upstream como un checkout de Git	skillshare install owner/repo --track --name team -g
Instalar solo habilidades nombradas con sus metadatos de origen	skillshare install owner/repo -s pdf,commit -g
Instalar todas las habilidades descubiertas individualmente	skillshare install owner/repo --all -g
Gestionar un plugin nativo completo, incluyendo hooks/MCP	Usa plugin discover y plugin add; ver abajo

Para el flujo de trabajo de vista previa → aplicar → actualizar → sincronizar con alcance, lee install.md. Cubre el seguimiento de la última rama upstream, combinaciones de banderas rechazadas y filtros de destino.

Para la configuración del proyecto, usa init -p, luego install -p y sync -p. Rehidrata las dependencias remotas configuradas con install sin una fuente. Para detalles completos de banderas y agentes, lee install.md y sync.md.

Para usar un checkout local de habilidades en su lugar, ejecuta skillshare link <ruta> --enable, luego sync; skillshare unlink <nombre> elimina solo el enlace. Lee TROUBLESHOOTING.md para saber cómo se siguen esos enlaces.

Deshabilitar o eliminar

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

Ejecuta la operación solicitada, no esta secuencia de ejemplo completa. Pon entre comillas los patrones glob para que Skillshare los reciba sin cambios. Deshabilitar usa reglas de ignorar; desinstalar usa la papelera.

Mover habilidades a carpetas

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

Usa move en lugar de mv para habilidades instaladas: mantiene sus registros de instalación, por lo que no se descarga nada de nuevo. No sincroniza; ejecuta sync después. Lee install.md para rechazos y modo de proyecto.

Carpetas de proyecto desde la configuración 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 siempre usa la configuración global, incluso dentro de un repositorio; no acepta -p. Los nuevos proyectos se guardan en config.yaml, o solo en esta máquina con --machine-local o projects_storage: machine-local (--shared sobrescribe la configuración); localize y share mueven uno entre los dos. Eliminar una copia local de un proyecto config.yaml mantiene la versión de config.yaml a menos que se proporcione --shared. Los filtros de edición reemplazan listas. La eliminación desvincula las habilidades y mantiene los archivos del agente; la eliminación JSON requiere --yes a menos que se esté en vista previa. Lee targets.md para fallos de guardado luego sincronización, reintentos y resultados de eliminación parcial.

Configuraciones 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 es singular y repetible. Una vista previa no aplica cambios. Para revisiones, edición, conflictos de importación, credenciales, copias de seguridad y comandos TUI operados por humanos, lee mcp.md.

Plugins completos

Usa plugin discover y plugin add para un paquete nativo completo; plugin import adopta una instalación nativa existente. Ejecuta solo la operación solicitada. Lee plugins.md antes de aplicar cambios; cubre el flujo de trabajo upstream con alcance, destinos compatibles y reglas de referencia de origen. plugin check/update maneja cambios upstream; sync plugins reconcilia la selección de destino. Los plugins están excluidos de sync --all.

Hubs de habilidades

skillshare hub add https://example.com/hub.json          # Guardar una fuente de hub
skillshare hub add https://example.com/hub.json --label my-hub  # Con etiqueta personalizada
skillshare hub add [email protected]:team/skills.git --label ghe  # Fuente de hub SSH/privada/GHE
skillshare hub list                                      # Listar hubs guardados
skillshare hub default my-hub                            # Establecer hub predeterminado
skillshare hub remove my-hub                             # Eliminar un hub
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit  # Construir índice de hub

La configuración activa follow_source_links también se aplica a hub index (incluyendo --source), la búsqueda integrada del panel y los candidatos de borrador del Hub.

Referencias

Lee el archivo correspondiente para banderas de comando, ejemplos y limitaciones. Evita cargar todas las referencias para una sola tarea.

Tema	Archivo
Agentes nativos, selección, reglas de ignorar y recuperación	native-agents.md
Configuración MCP, importaciones, TUI y recuperación	mcp.md
Hooks nativos, enlaces de código, ámbitos y recuperación	hooks.md
Plugins completos, ciclo de vida nativo y selección de sincronización	plugins.md
Banderas de init	init.md
Sincronización/recolectar/commit/push/pull	sync.md
Instalar/actualizar/desinstalar/mover/nuevo	install.md
Estado/diff/listar/buscar/verificar	status.md
Auditoría de seguridad	audit.md
Revisar una habilidad no confiable antes de instalar	audit-review.md
Papelera	trash.md
Registro de operaciones	log.md
Destinos	targets.md
Extras (reglas/comandos/prompts)	extras.md
Retrospectivas de sesión y soñar (Dreaming) sobre notas guardadas	memory-review.md
Copia de seguridad/restauración	backup.md
Solución de problemas	TROUBLESHOOTING.md