Claude Code Club · Cuaderno de estudio
Etapa 5 — Skills & MCPs

📦 Encontrar e instalar tu primera Skill

← Índice del cuaderno

Lo que te llevarás: una Skill real instalada y apareciendo en tu sesión — tu primer plug-in.

Infografía: encontrar e instalar tu primera skill
Buscas en el marketplace → eliges una skill → Install → queda instalada y lista para usar.

Las Skills vienen de marketplaces — piénsalo como una app store para Claude. El marketplace oficial de Anthropic se llama claude-plugins-official y ya está ahí desde que abres Claude Code; no añades nada.

⚠️ No ejecutes /plugin marketplace add anthropics/claude-code para conseguir las skills oficiales — ese es un marketplace de demo aparte, y las instalaciones que esperan el catálogo oficial fallarán. El oficial (claude-plugins-official) ya está presente.

El flujo, en orden

🖥️ App de escritorio
No tiene una tienda de skills navegable — sirve para añadir una skill que ya tienes. Pulsa el botón + junto a la caja del prompt → Create skill → Upload a skill y apunta al ZIP de tu skill. Para descubrir nuevas, usa el CLI (abajo) y quedan disponibles en todas partes. Ojo: /plugin solo abre en un terminal real; en la caja de chat del escritorio dará «not available in this environment» — es normal.
⌨️ CLI (terminal)
  1. Escribe /plugin — se abre un panel con pestañas: Discover (explorar), Installed, Marketplaces, Errors.
  2. En Discover, encuentra una que encaje con lo que haces; pulsa Enter para verla (muestra un «coste de contexto» = cuánto pesa).
  3. Elige alcance User (úsala en todas partes) e instala.
  4. Ejecuta /reload-plugins para activarla en la sesión.

🛠️ ¿El marketplace no aparece? (el fix, en orden — el paso 1 lo resuelve el ~90% de las veces)

  1. Actualiza Claude Code y reinícialo del todo. La tienda oficial se auto-carga en builds actuales; un build viejo es la causa habitual. npm i -g @anthropic-ai/claude-code@latest (o brew upgrade claude-code).
  2. Mira qué tienes: /plugin marketplace list — quieres claude-plugins-official en la lista.
  3. Si falta, añádelo (ojo: claude-plugins-official, NO claude-code): /plugin marketplace add anthropics/claude-plugins-official. Si está pero vacío/obsoleto: /plugin marketplace update claude-plugins-official.
  4. Borra una entrada official-local perdida — es un marketplace local obsoleto que tapa al real. Bórrala en /plugin → pestaña Marketplaces.
  5. Reintenta: /plugin install <nombre>@claude-plugins-official, luego /reload-plugins.
🚫 ¿Dice «not available in this environment» o el marketplace nunca abre? No estás en un terminal interactivo — la causa nº 1. El panel /plugin es una pantalla interactiva en vivo, solo corre en un terminal real. Abre un terminal (el integrado de VS Code con View → Terminal, Terminal.app de macOS, o iTerm), ejecuta claude ahí, y escribe /plugin. La caja de chat del escritorio no es un terminal interactivo.

Cuando ya esté dentro, una Skill aparece como un comando con el nombre de su plugin — como /commit-commands:commit. Es Claude diciendo «ahora sé hacer este trabajo entero».

Lo que los principiantes hacen mal

  • Acaparar. Instalar 30 Skills que nunca usarás. Más no es mejor — solo llena el menú y olvidas qué tienes.
  • Olvidar /reload-plugins. Instalada pero sin activar, y creen que está «rota».
  • No leer la descripción de una línea. Te dice exactamente qué hace la Skill. Léela.

📋 Prompts (traducidos)

1 · Descubrir e recomendar
Abre el marketplace de plugins, muéstrame lo disponible, y recomiéndame UNA skill que encaje con alguien que construye webs y landing pages. Dime en una frase qué hace antes de instalar.
2 · Instalar y confirmar
Instala commit-commands@claude-plugins-official por mí, ejecuta /reload-plugins, luego confirma que está activa y muéstrame el nuevo comando que añadió.
Fuente: Claude Code Club · Aula · Etapa 5 «Skills & MCPs» — lección «Encontrar e instalar tu primera Skill».
Añadido al cuaderno: 7 de julio de 2026. Traducción al español para estudio personal.