publish

Publish approved feature branches via pull requests, CI, merge, tag, and changelog updates.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/bernajaber/pi-product-system --skill publish-bernajaber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish
Source: https://github.com/bernajaber/pi-product-system/tree/main/skills/publish
Command: npx skills add https://github.com/bernajaber/pi-product-system --skill publish-bernajaber

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates and enforces a safe, repeatable release process after Gate 3 approval so operators do not have to manually coordinate pushing branches, creating pull requests, waiting for CI, merging, tagging, updating changelogs, and resetting workflow state.

Core Features & Use Cases

  • Pushes the feature branch to the configured remote and creates a GitHub pull request with an acceptance checklist.
  • Waits for CI (if present), merges with squash and deletes the branch, tags a new version, updates CHANGELOG.md and feature-list.json, and resets the workflow-state.json to the V2 schema.
  • Use Case: finalize and publish a completed feature after the review and validation gates so the repository and project state are consistent for the next cycle.

Quick Start

Use the publish skill to push the approved feature branch, create and merge the PR, tag the new version, update the changelog and feature list, and reset the workflow-state for the next feature.

Frequently Asked Questions about publish

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

FAQPage Schema
How do I automate GitHub release workflows after feature approval?

Automating GitHub release workflows after feature approval involves pushing the branch, creating a pull request, waiting for CI, merging, tagging a version, and updating the changelog. This skill coordinates that entire sequence to ensure consistent releases.

What is the best way to update CHANGELOG.md and tag versions after a pull request merge?

The best way to update CHANGELOG.md and tag versions after a merge is to run an automated workflow that squashes the pull request, applies a new package.json version tag, and appends the changes to the changelog in one continuous step.

Does the publish workflow require a package.json file for versioning?

No, the publish workflow does not strictly require a package.json file for versioning. It applies optional package.json versioning, meaning it can tag releases and update changelogs even if your repository uses a different versioning scheme.

Can I use this release automation skill if my repository has no CI checks configured?

Yes, you can use this release automation skill if your repository has no CI checks configured. The workflow waits for CI only if present, allowing you to proceed directly to merging and tagging if no continuous integration checks are detected.

How do I reset workflow-state.json to the V2 schema after merging a feature branch?

Resetting workflow-state.json to the V2 schema after merging happens automatically at the end of the release process. Once the feature branch is merged, the workflow updates feature-list.json and resets the state file to prepare for the next cycle.

What happens to the feature branch after a pull request is merged in GitHub?

After a pull request is merged in GitHub, the feature branch is deleted. The release workflow uses a squash merge to integrate the changes and then automatically deletes the remote branch to keep the repository clean.