Tu entorno de programación con IA, en todas partes.
Gestiona skills, agents, rules, conexiones MCP y hooks en un solo lugar.
Para Claude Code, Codex, Pi, OpenCode y más.
> [!NOTE]
> **Última versión**: v0.30.0 — El dashboard web rechaza los cambios que otro sitio web envía a través de tu navegador y responde solo en `localhost`, una dirección IP y las direcciones en las que confías, así que una página de DNS rebinding tampoco puede alcanzarlo. Detrás de un proxy inverso, inícialo con [`--trusted-origin`](https://skillshare.runkids.cc/docs/reference/commands/ui#reverse-proxy) y todas las páginas funcionan a través de tu dominio, incluidos MCP, Hooks y Plugins; un dashboard abierto con cualquier otro nombre de dominio ahora necesita este ajuste. [`skillshare plugin`](https://skillshare.runkids.cc/docs/reference/commands/plugin) también ofrece a Codex los plugins que solo traen un manifiesto de Claude, con los skills y servidores MCP que Codex puede usar. [Todas las versiones →](https://github.com/runkids/skillshare/releases)
## Por qué skillshare
Cambiar de herramienta de IA no debería obligarte a reconstruir tu entorno.
skillshare da a tus skills y demás recursos de IA un lugar que tú controlas.
- **Cambia de herramienta, conserva tus skills** — edita una vez y sincroniza con Claude Code, Codex, Pi y las demás herramientas que uses.
- **Lleva tu entorno contigo** — versiona tu fuente con Git y tráela a otra máquina.
- **Comparte con tu equipo** — guarda los recursos del proyecto junto a tu código y distribuye skills compartidos mediante tracked repositories.
Una persona del equipo usa Claude Code y otra, Codex. Guardad vuestra checklist común de revisión de código en `.skillshare/`, junto al proyecto. Quien se incorpora instala los skills declarados y los sincroniza con las herramientas configuradas, en lugar de copiar instrucciones del chat. [Incorporación de equipos →](https://skillshare.runkids.cc/docs/how-to/recipes/team-onboarding-recipe)
Usa la app de escritorio o el CLI para gestionarlo todo en local, [auditar los skills antes de usarlos](https://skillshare.runkids.cc/docs/reference/commands/audit) y [elegir qué recibe cada herramienta](https://skillshare.runkids.cc/docs/how-to/daily-tasks/filtering-skills).
> ¿Vienes de otra herramienta? [Guía de migración](https://skillshare.runkids.cc/docs/how-to/advanced/migration) · [Comparación](https://skillshare.runkids.cc/docs/understand/philosophy/comparison)
## Vista previa del CLI y la UI
| Detalle de un skill | Auditoría de seguridad |
|---|---|
| | |
| Panel web | Página Skills en la web |
|---|---|
| | |
## Instalación
> [!TIP]
> **Usa skillshare desde tu escritorio.** [Descarga Skillshare App](https://github.com/runkids/skillshare-app/releases/latest) para macOS (Apple Silicon), Windows y Linux. En el primer inicio te ayuda a instalar o localizar el CLI, elegir tus herramientas de IA y hacer tu primera sincronización. [Guía de instalación](https://skillshare.runkids.cc/docs/getting-started/desktop-app).
### App de escritorio — configuración visual y gestión diaria
[Skillshare App](https://github.com/runkids/skillshare-app) reúne skills, agents, MCP y hooks en una ventana de escritorio. Instala la app, ábrela y sigue la configuración del primer inicio.
macOS (Apple Silicon), con Homebrew:
```bash
brew tap runkids/tap
brew install --cask skillshare-app
```
**Windows / Linux, o instalación manual en macOS:** [Descarga los instaladores más recientes](https://github.com/runkids/skillshare-app/releases/latest). Consulta la [guía de la app de escritorio](https://skillshare.runkids.cc/docs/getting-started/desktop-app) para los detalles de cada plataforma.
### CLI: macOS / Linux
```bash
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
```
El script instala por defecto en `~/.local/bin`, así que las instalaciones y actualizaciones normales no necesitan `sudo`. Si el instalador muestra instrucciones para configurar el PATH, síguelas antes de ejecutar `skillshare`. Añade la línea sugerida a la configuración de tu shell (como `~/.zshrc` o `~/.bashrc`) para las próximas terminales. Define `INSTALL_DIR` para usar otra ubicación.
### Windows PowerShell
```powershell
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
```
### CLI: Homebrew
```bash
brew install skillshare
```
> **Consejo:** ejecuta `skillshare upgrade` para actualizar a la última versión. Detecta tu método de instalación y se encarga del resto.
### CLI: Nix
```bash
nix profile add github:runkids/skillshare
```
Actualiza con `nix profile upgrade skillshare`. Requiere Nix 2.30+ con flakes habilitados; con Nix más antiguo o Lix, usa `nix profile install`. Las configuraciones de NixOS y Home Manager pueden usar el `overlays.default` del flake.
### GitHub Actions
```yaml
- uses: runkids/setup-skillshare@v1
with:
source: ./skills
- run: skillshare sync
```
Consulta [`setup-skillshare`](https://github.com/marketplace/actions/setup-skillshare) para ver todas las opciones (audit, modo proyecto, versión fija).
### Atajo (opcional)
Añade un alias a la configuración de tu shell (`~/.zshrc` o `~/.bashrc`):
```bash
alias ss='skillshare'
```
## Inicio rápido
```bash
skillshare init # Crea la config, la fuente y los targets detectados
skillshare sync # Sincroniza los skills con todos los targets
```
## Cómo funciona
- macOS / Linux: `~/.config/skillshare/`
- Windows: `%AppData%\skillshare\`
```
┌─────────────────────────────────────────────────────────────┐
│ Source Directory │
│ ~/.config/skillshare/skills/ ← skills (SKILL.md) │
│ ~/.config/skillshare/agents/ ← agents │
│ ~/.config/skillshare/extras/ ← rules, commands, etc. │
└─────────────────────────────────────────────────────────────┘
│ sync
┌───────────────┼───────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Claude │ │ OpenCode │ │ OpenClaw │ ...
└───────────┘ └───────────┘ └───────────┘
```
| Plataforma | Fuente de skills | Fuente de agents | Fuente de extras | Tipo de enlace |
|----------|---------------|---------------|---------------|-----------|
| macOS/Linux | `~/.config/skillshare/skills/` | `~/.config/skillshare/agents/` | `~/.config/skillshare/extras/` | Symlinks |
| Windows | `%AppData%\skillshare\skills\` | `%AppData%\skillshare\agents\` | `%AppData%\skillshare\extras\` | Junctions NTFS para carpetas (sin permisos de administrador); los symlinks de archivos requieren el Developer Mode, si no se copian |
| | Imperativo (una instalación por comando) | Declarativo (skillshare) |
|---|---|---|
| **Fuente única** | Skills copiados por separado | Una sola fuente → symlinks (o copias) |
| **Máquina nueva** | Repetir cada instalación a mano | `git clone` de la config + `sync` |
| **Auditoría de seguridad** | Ninguna | `audit` integrado + análisis automático al instalar y actualizar |
| **Panel web** | Ninguno | `skillshare ui` |
| **Dependencia en tiempo de ejecución** | Node.js + npm | Ninguna (un único binario de Go) |
> [Comparación completa →](https://skillshare.runkids.cc/docs/understand/philosophy/comparison)
## Funciones destacadas
**Instalar y actualizar skills** — desde GitHub, GitLab o cualquier host Git
```bash
skillshare install github.com/reponame/skills
skillshare update --all
skillshare target claude --mode copy # si los symlinks no funcionan
```
**¿Problemas con los symlinks?** — cambia a modo copy por target
```bash
skillshare target --mode copy
skillshare sync
```
**Auditoría de seguridad** — analiza los skills antes de que lleguen a tu agent
```bash
skillshare audit
```
**Skills de proyecto** — por repositorio, con commit junto a tu código
```bash
skillshare init -p && skillshare sync
```
**Agents** — sincroniza agents personalizados con los targets que los admiten
```bash
skillshare sync agents # sincroniza solo los agents
skillshare sync --all # sincroniza skills + agents + extras + MCP + hooks a la vez
```
**Extras** — gestiona rules, commands, prompts y más
```bash
skillshare extras init rules # crea un extra "rules"
skillshare sync --all # sincroniza skills + agents + extras + MCP + hooks a la vez
skillshare extras collect rules # recupera los archivos locales en la fuente
```
**Conexiones MCP** — configura una vez para Claude Code, Codex, Pi, VS Code, OpenCode y más
```bash
skillshare mcp add # configuración guiada por URL o JSON
skillshare sync mcp --dry-run # vista previa de los cambios en las configuraciones nativas
skillshare sync mcp # aplica la configuración de conexión
```
Guarda las definiciones en `config.yaml` o haz referencia a un `mcp.yaml` aparte.
Consulta [la configuración de MCP](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-mcp)
para ver ejemplos, referencias a variables de entorno y la importación de conexiones existentes.
Gestiona hooks nativos sin ejecutarlos:
```bash
skillshare hooks add check --file ./check.yaml
skillshare hooks sync --dry-run
skillshare hooks sync
```
**Plugins** — instala un plugin completo y elige qué herramientas lo reciben
```bash
skillshare plugin add # guiado: fuente, plugin, targets, revisión
skillshare plugin add owner/repo --target claude --target codex --no-tui
skillshare sync plugins --dry-run # los plugins se sincronizan aparte de sync --all
```
Las instalaciones nativas existentes se pueden adoptar con `plugin import`.
Consulta [Gestionar plugins entre herramientas](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins).
**Autocompletado del shell** — completa comandos, flags y subcomandos con Tab
```bash
skillshare completion bash --install # también: zsh, fish, powershell, nushell
```
**Puntos de control locales** — haz commit de los cambios de la fuente sin hacer push
```bash
skillshare commit -m "Update review skill"
skillshare commit --dry-run
```
**Panel web** — un panel de control visual
```bash
skillshare ui
```
**Panel de Herdr** — skillshare junto a tus agentes en [Herdr](https://herdr.dev): actualizaciones, sync, instalaciones auditadas y el repositorio fuente en un solo panel
[Configurar el panel de Herdr →](https://skillshare.runkids.cc/docs/learn/with-herdr)
[Todos los comandos y guías →](https://skillshare.runkids.cc/docs/reference/commands)
## Contribuir
¡Las contribuciones son bienvenidas! Abre primero un issue y luego envía una draft PR con tests.
Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para la configuración.
```bash
git clone https://github.com/runkids/skillshare.git && cd skillshare
make check # format + lint + test
```
> [!TIP]
> ¿No sabes por dónde empezar? Revisa los [issues abiertos](https://github.com/runkids/skillshare/issues) o prueba el [Playground](https://skillshare.runkids.cc/docs/learn/with-playground), un entorno de desarrollo sin configuración.
## Colaboradores
Gracias a todas las personas que han ayudado a dar forma a skillshare. La lista está en el [README en inglés](README.md#contributors).
---
Si skillshare te resulta útil, regálale una ⭐
## Star History
---
## Licencia
MIT