ci-validation-gates

Enforce semver, token-type, retry, and draft-release checks in GitHub Actions workflows.

2|1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/PlagueHO/plagueho.learn --skill ci-validation-gates-plagueho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ci-validation-gates
Source: https://github.com/PlagueHO/plagueho.learn/tree/main/.copilot/skills/ci-validation-gates
Command: npx skills add https://github.com/PlagueHO/plagueho.learn --skill ci-validation-gates-plagueho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CI/CD pipelines are prone to outages when versioning, tokens, and retry logic are not guarded. This collection centralizes defensive patterns to prevent misconfigurations and fragile deployments.

Core Features & Use Cases

  • Semver Validation Gate: Validate version strings before publish to avoid npm mangling or invalid tags.
  • NPM Token Type Verification: Enforce use of Automation tokens, not user tokens with 2FA, to enable seamless CI publishing.
  • Retry Logic for Propagation: Implement retry checks after publish to account for eventual consistency in registries.
  • Draft Release Detection: Ensure workflows trigger only on published releases, not drafts or pre-releases.

Quick Start

Add these gates to your CI workflows and run the included checks during releases.

Frequently Asked Questions about ci-validation-gates

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate semver format before publishing an npm package in GitHub Actions?

To validate semver format in GitHub Actions, you add a defensive CI gate that checks version strings before publish, preventing npm mangling and invalid tags. This stops broken releases caused by misconfigured versioning.

Why does my npm publish workflow fail in CI when using a user token with 2FA?

Your npm publish workflow fails because user tokens with 2FA block automated CI publishing. You need a gate that enforces npm Automation tokens instead of user tokens, enabling seamless CI publishing without manual intervention.

How do I prevent GitHub Actions workflows from triggering on draft releases?

To prevent GitHub Actions workflows from triggering on draft releases, implement a draft-release detection gate that ensures workflows trigger only on published releases, not drafts or pre-releases, guarding against premature deployments.

What is the best way to handle eventual consistency in npm registries after a publish step?

The best way to handle eventual consistency in npm registries is implementing retry logic after publish. This propagation check retries verification steps to ensure the published artifact is actually available before proceeding.

Do I need any dependencies to add defensive CI gates to my release pipelines?

No, you do not need any dependencies to add defensive CI gates. This skill provides explicit gates and scripts to validate semver, ensure automation tokens, implement retry logic, and guard build steps directly in GitHub Actions.

What defensive CI/CD practices should I enforce to stop broken release deployments?

To stop broken release deployments, enforce defensive CI/CD practices like semver validation, npm automation token verification, retry propagation for registry consistency, and draft-release detection across your GitHub Actions workflows.