Skill Hub

Es una plantilla de una instancia por empresa que permite que las personas «buenas con la IA» de la empresa registren skills (instrucciones + material de referencia) para Claude Code en un solo lugar, y que los empleados puedan usar esas skills con solo pegar una línea de comando en Claude Code. Es una aplicación Worker única que se ejecuta en Cloudflare Workers + D1 y se despliega en la cuenta de Cloudflare de tu empresa.

Qué es esto (honestamente)

Las skills no se «distribuyen como archivos», sino que se «sirven desde el servidor en cada solicitud». Esta diferencia es el núcleo del valor.

• La instalación se reduce a una sola línea de comando

• Si actualizas las skills de forma centralizada, todos usarán la versión más reciente a partir del siguiente uso

• Si un empleado se va o se traslada, basta con revocar el token para que deje de funcionar de inmediato

• Como no se entrega el repositorio completo, es menos probable que se redistribuya fuera de la organización

Las respuestas de MCP se entregan como texto plano en la conversación del usuario. No son un «secreto ilegible». Quien quiera leerlas, puede hacerlo. Lo que este mecanismo protege es el «canal de distribución» y la «inmediatez de la revocación»; la lógica que se quiera ocultar por completo queda fuera del alcance de este mecanismo (para esos casos se prevé usar las herramientas de ejecución en servidor de la v2).

Diferencias con las skills nativas de Claude Code

Lo que se distribuye es «texto que se lee como instrucciones». No se pueden usar las funciones de frontmatter de las skills nativas, el /inicio con barra ni ejecutar scripts incluidos. Para acercarse a la activación automática nativa, configura la «descripción» al registrar la skill con las condiciones de activación de la herramienta (se usará tal cual como descripción de la herramienta MCP).

Related MCP server: Superpowers MCP Server

Arquitectura

[Claude Code (member)] --Streamable HTTP MCP--> POST /mcp ┐
[ブラウザ (admin/editor/member)] --Bearer--> /api/* + 静的UI ├─ Cloudflare Worker (Hono/TS)
[招待リンク] --> /join (明示ボタンPOSTでclaim・1回表示)      ┘        │
                                                D1: tokens/skills/skill_files/skill_versions/invites/audit_log

Un solo Worker y una sola base de datos D1. No se usan KV ni Durable Objects. La interfaz estática (public/) también se sirve a través del Worker y todas las respuestas incluyen cabeceras de seguridad.

Configuración

Requisitos: Node.js 20 o superior y una cuenta de Cloudflare.

git clone <このリポジトリ>
cd skill-hub
npm ci
npx wrangler login      # 唯一の手作業（ブラウザでCloudflareにログイン）
node scripts/setup.mjs --seed

setup.mjs es idempotente. Se puede ejecutar tantas veces como se quiera de forma segura y omite lo que ya existe.

• Comprueba o crea la base de datos D1 skill-hub-db y reescribe el database_id en wrangler.jsonc

• Aplica las migraciones (solo las pendientes)

• Despliega el Worker

• Solo si no hay ningún token de administrador válido, genera y muestra un token de administrador inicial una sola vez (este token no volverá a mostrarse. Asegúrate de guardarlo)

• Con --seed se cargan las 3 skills de ejemplo de skills-samples/

Si tienes varias cuentas de Cloudflare, especifica la que quieras con la variable de entorno CLOUDFLARE_ACCOUNT_ID.

Uso (según el rol)

Procedimiento para member

1. Abre el enlace de invitación que te ha enviado el administrador (https://<host>/join?code=...)

2. Pulsa el botón «Emitir token» (con GET no ocurre nada. El token solo se emite al pulsar el botón)

3. Copia el comando que se muestra y pégalo en la terminal de Claude Code

claude mcp add --transport http --scope user skillhub https://<host>/mcp --header "Authorization: Bearer <token>"

Como es --scope user, a partir de entonces podrás usar las skills en todos los proyectos. **La visualización es única.** Si cierras esta pantalla, no podrás volver a verlo, así que cópialo en ese momento.

Matriz de permisos (todo se aplica en el servidor; la diferenciación en la interfaz es solo auxiliar)

La visibilidad de groups se determina con un OR (si la intersección de skill.groups y token.groups no está vacía, o si cualquiera de los dos es "*", se ve). Aunque se especifiquen varios groups, no es un «filtro». Para las skills confidenciales, usa un único group dedicado.

El descubrimiento de nuevas skills requiere una sesión nueva. Como MCP no envía tools/listChanged, si añades skills en segundo plano con Claude Code abierto, no aparecerán en la lista de herramientas de esa sesión (las actualizaciones del contenido sí se reflejan en la siguiente llamada, incluso en sesiones existentes). Para que se apliquen, reinicia Claude Code.

Plan gratuito y facturación

Tanto Cloudflare Workers como D1 tienen plan gratuito (Workers: 100 000 solicitudes/día; D1: 5 millones de filas leídas/día y 100 000 filas escritas/día como referencia; consulta siempre los precios actualizados en la página de precios de Cloudflare). Para un uso interno de unas decenas de personas, normalmente basta con el plan gratuito, pero si se supera, habrá que migrar al plan de pago (Workers Paid). Puedes consultar el uso en el panel de Cloudflare.

Fuera del alcance de la v1 (limitaciones honestas)

• No hay integración OAuth/SSO ni IdP (solo el método de token). Si pones Cloudflare Access por delante, el acceso desde la CLI puede quedarse bloqueado en el desafío de autenticación del navegador, así que compruébalo antes si usas Access.

• No hay flujo de aprobación por dos personas para las skills. Se confía en los editor y se actúa a posteriori con los registros de auditoría, el historial de versiones y la reversión.

• Si las skills visibles superan las 40, el tools/list de MCP se vuelve demasiado grande. El método de búsqueda en dos fases para organizaciones grandes (search_skills) está previsto para la v2.

• No se admiten archivos adjuntos binarios (solo texto)

• La selección de región/jurisdicción de D1 solo se indica como opción manual en el script de configuración

• No se incluye CI

Licencia

MIT. Consulta LICENSE para más detalles.

Más información

• Diseño de seguridad: docs/security.md

• Guía de uso para miembros: docs/member-guide.md

• Guía de operación (para administradores): docs/operations.md

• Procedimiento de configuración autónoma con Claude Code: CLAUDE.md