Publicación de 8 Agent Skills y primer servidor MCP en npm

Description and use

The author published the alpha-skills package with 8 Agent Skills and a NextDNS MCP server, using semantic-release for versioning and npm CLI with OIDC for publishing, eliminating technical debt and simplifying CI/CD.

Problem

El autor necesitaba evitar la deuda técnica de reescribir repetidamente los mismos comandos para resolver problemas comunes, y publicar un servidor MCP funcional con autenticación OIDC confiable.

Outcome

El autor logró eliminar la deuda técnica, compartir habilidades reutilizables y publicar un servidor MCP con autenticación OIDC confiable, reduciendo la complejidad de los flujos de CI/CD.

Workflow

• 1. Crear la carpeta skills/ con subcarpetas external/, local/ y general/ y añadir los SKILL.md correspondientes.
• 2. Publicar el paquete alpha-skills en npm.
• 3. Instalar cada skill con npx skills add Alpha018/alpha-skills -s <skill> según necesidad.
• 4. Desarrollar el servidor MCP @alpha018/nextdns-mcp basado en la referencia de nextdns-api.
• 5. Configurar dos workflows de GitHub Actions: pr-test-mcp-servers.yml para lint, typecheck, build y test en PRs; build-publish-mcp-servers.yml para versionado con semantic-release y publicación con npm CLI usando OIDC.
• 6. En build-publish-mcp-servers.yml, ejecutar semantic-release con npmPublish:false, comparar versiones y publicar con npm publish --provenance si es necesario.

Evidence

La arquitectura que terminó funcionando son dos workflows compartidos, generalizados sobre cualquier paquete en mcp-servers/*

Source

semantic-release se encarga del versionado; el CLI de npm realiza la publicación con OIDC.

Source