release

Orchestrates versioned package releases with security audits, release notes, and user-run publish steps.

Updated May 19, 2026
One-click install
npx skills add https://github.com/davidsunglee/pi-flow --skill release-davidsunglee
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/davidsunglee/pi-flow/tree/main/packages/pi-release/skills/release
Command: npx skills add https://github.com/davidsunglee/pi-flow --skill release-davidsunglee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Releasing npm packages involves many error-prone steps — version bumps, changelogs, security checks, publishing, tagging — and skipping any of them can ship vulnerable or broken artifacts. This Skill drives the entire release through one guided checklist so nothing is missed. ## Core Features & Use Cases - Shape-aware release flow: Auto-detects single-package vs. monorepo projects (via lockfiles and workspace metadata) and loads the matching mechanics, including dependency-ordered monorepo publishing. - Mandatory security audit: Runs dependency audits and secret scans (e.g. gitleaks) before any release-mutating change, blocking the release on vulnerabilities or leaked credentials. - Commit-derived release notes with human review: Generates grouped changelog drafts from conventional commits and pauses for mandatory manual approval before proceeding. - User-owned publish actions: Prints exact publish, push, tag, and GitHub release commands for the user to run, keeping credentials and OTP out of the agent session. - Use Case: You maintain a pnpm monorepo and ask to "cut a release". The Skill confirms the shape, audits dependencies, drafts notes from commits since the last tag, bumps all manifests to one version, runs readiness checks, commits locally, then hands you the exact publish and tag commands. ## Quick Start Ask the assistant to cut a new release of this repository at version 1.4.0 and follow the guided checklist.

Frequently Asked Questions about release

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

FAQPage Schema
How do I release an npm package with a guided checklist?▼

Invoke the release flow and it walks through version confirmation, security audit, release notes review, version bump, readiness checks, and a local release commit. Publish, push, tag, and GitHub release commands are printed for you to run yourself.

How do I publish a pnpm monorepo in dependency order?▼

The monorepo mechanics enumerate publishable packages from workspace globs, topologically sort them so dependencies publish before dependents, and bump all manifests to one shared version. Packages with custom publish scripts are released via those scripts rather than raw pnpm publish.

Does the release flow run a security audit before publishing?▼

Yes, a mandatory audit runs before any release-mutating change: dependency audits (pnpm/npm/yarn audit), a gitleaks secret scan, and a git status check. Any vulnerability, leaked secret, or unexpected local change blocks the release.

Can the agent run npm publish or git push for me?▼

No. Publish, push, tag, and GitHub release steps are user-owned: the Skill prints exact commands and pauses for you to run them. This keeps npm OTP and credentials out of the agent session.

How are release notes generated from git commits?▼

Commits since the last tag are grouped by conventional-commit prefix into sections like Features, Bug Fixes, and Documentation. The draft requires your manual approval before the release proceeds, and it is reused for the GitHub release.

Can I customize the release process per project?▼

Yes, a .pi/release-profile.md file in the repo can declare the project shape, publishable set and order, custom publish tooling, extra gates, persistent notes destinations, and post-publish smoke tests. It can add gates but never weaken the core security audit.