Publicación de 8 Agent Skills y primer servidor MCP en npm
Описание и применение
Автор опубликовал пакет alpha-skills с 8 навыками агента и сервер MCP для NextDNS, используя semantic-release для версионирования и npm CLI с OIDC для публикации, устранив технический долг и упрощив CI/CD.
Задача
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.
Результат
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.
Рабочий процесс
- 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 --provenancesi es necesario.
Доказательства
La arquitectura que terminó funcionando son dos workflows compartidos, generalizados sobre cualquier paquete en mcp-servers/*
semantic-release se encarga del versionado; el CLI de npm realiza la publicación con OIDC.
- Дата записи: 2026-09-12T02:01:05.887Z