convez.ai
SkillDevOps & InfraestruturaAvançado
netresearch

GitHub Release Skill

netresearch/github-release-skill

Automatiza releases seguros no GitHub com segurança de cadeia de suprimentos

Ver no GitHub
BomPluginScore · de 0 a 100

Skill para Claude Code que automatiza releases seguros no GitHub com foco em segurança da cadeia de suprimentos. Bloqueia comandos perigosos, detecta o tipo de projeto, gerencia versionamento semântico e orquestra o fluxo completo de release com tags assinadas e validações de CI/CD.

Instalação

$npx convez-ai netresearch/github-release-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
1
Saúde
100%
Último commit
há 2 dias
Versão
v1.6.1
Issues abertas
2
Contribuidores
2

Casos de uso

  • Automatizar releases de projetos PHP, Node.js, Python, Go e Rust com segurança
  • Prevenir erros comuns como tags leves não assinadas e releases imutáveis
  • Integrar SBOMs, assinaturas cosign e attestations no pipeline de release
  • Sugerir e aplicar versionamento semântico baseado em conventional commits

Veredito

Ferramenta sólida e bem estruturada para times que precisam de releases confiáveis e seguras. Reduz drasticamente o risco de erros em operações críticas bloqueando ações perigosas no nível de hooks. Recomendado para projetos que tratam segurança de cadeia de suprimentos como requisito.

README

A tradução para o português deste README ainda está na fila.

github-release-skill

Claude Code skill plugin for safe, automated GitHub releases with supply chain security.

Problem

AI coding agents (Claude Code, Copilot, etc.) naturally reach for gh release create when asked to "create a release". This:

  1. Creates lightweight unsigned tags instead of signed annotated tags
  2. Creates immutable releases that permanently burn tag names (no recovery)
  3. Bypasses CI pipelines that handle SBOMs, attestations, and signing

This skill prevents these mistakes structurally via hooks and provides the correct release orchestration.

Features

  • Guard hooks: Block gh release create/delete/edit and lightweight tag creation at the tool level
  • Ecosystem detection: Auto-detect project type (TYPO3, PHP, Node.js, Go, Python, Rust, skill repos)
  • Version management: Suggest next semver version from conventional commits, update all version files
  • Release orchestration: Version bump PR → merge → signed tag → CI handles the rest
  • Health checks: Validate release workflow, tag integrity, supply chain security
  • CI templates: Release workflow templates with SBOM, cosign, attestation support

Commands

CommandDescription
/releaseFull release: detect, bump, PR, tag, CI
/release-prepareVersion bump PR only (tag manually)
/release-statusRelease health check

Installation

Claude Code Marketplace (recommended)

Installed automatically via the Netresearch marketplace.

Composer

composer require --dev netresearch/github-release-skill

npm (Node Projects)

npm install --save-dev \
  @netresearch/agent-skill-coordinator \
  github:netresearch/github-release-skill

Requires @netresearch/agent-skill-coordinator, which discovers the skill in node_modules and registers it in AGENTS.md via a postinstall hook. For pnpm, also allowlist the coordinator's postinstall:

{
  "pnpm": {
    "onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
  }
}

Limitation: This installation method only registers the skill's SKILL.md content (procedural knowledge that the agent reads). The slash commands (/release, /release-prepare, /release-status) and the PreToolUse guard hooks defined in .claude-plugin/ are not loaded by Claude Code when the skill is installed via npm — those require Claude Code's plugin mechanism. To get the full skill (slash commands + guard hooks + procedural knowledge), install via the Claude Code Marketplace instead.

Manual

Download the latest release and extract to ~/.claude/plugins/.

How It Works

  1. Hooks intercept dangerous commands before execution
  2. Ecosystem detection finds all version files in the project
  3. Version bump updates all files and promotes CHANGELOG
  4. PR workflow ensures changes go through review and CI
  5. Signed tag (git tag -s) triggers the release workflow
  6. CI pipeline creates the GitHub release with SBOMs, signatures, and attestations

Supported Ecosystems

EcosystemVersion Files
TYPO3ext_emconf.php, composer.json, Documentation/guides.xml
PHP/Composercomposer.json
Node.jspackage.json, package-lock.json
GoTags only (no version files)
Pythonpyproject.toml, setup.py
RustCargo.toml
Skill reposplugin.json, SKILL.md metadata

License

Ver o original no GitHub

Bom para

Relacionados