toy-release

Guides versioning, stage promotion, and release verification for Lia Tools toys.

1|Updated Jun 30, 2026
One-click install
npx skills add https://github.com/Lia-Creative/lia-plugins --skill toy-release-lia-creative
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: toy-release
Source: https://github.com/Lia-Creative/lia-plugins/tree/main/lia-tools/skills/toy-release
Command: npx skills add https://github.com/Lia-Creative/lia-plugins --skill toy-release-lia-creative

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams shipping internal tools ("toys") through build, test, uat, and production environments often mis-version releases, skip approval gates, or lose track of which stage a tool is in. This Skill gives agents a single runbook for versioning correctly, enforcing founder gates, and recording promotions in the release register. ## Core Features & Use Cases - Version bump rules: Defines patch/minor/major semantics where the change picks the digit, never the promotion, with one-step-only increments and a 1.0.0 rule for first production promotion. - Gate enforcement: Blocks test-to-uat and uat-to-production moves unless a founder's approval is written on the promotion ticket. - Promotion runbook: A seven-step procedure covering release PRs, git tags, register inserts, two-direction verification, and distribution status reporting. - Use Case: An agent is asked to promote a tool from test to uat. It checks the ticket for the founder's call, determines no code changed so no version bump occurs, inserts the register row, verifies visibility for the uat group, and closes out with a Linear comment. ## Quick Start Ask the agent to promote the toy to uat and have it follow the toy-release runbook, checking the founder gate on the ticket first.

Frequently Asked Questions about toy-release

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

FAQPage Schema
How do I promote a toy from test to uat?▼

First confirm a founder's approval is written on the promotion ticket, since chat approval does not count. Then bump the manifest version only if code changed, raise a release PR, tag the merge commit, insert a register row, and verify the uat group sees the toy while the test group does not.

How does version bumping work for toy releases?▼

The size of the change picks the digit: a patch for fixes, a minor for new capabilities, a major for breaking changes. Promotions never pick the digit, except a 0.x tool's first promotion to production, which sets 1.0.0 whether or not code changed.

Does a promotion with no code change bump the version?▼

No. If nothing in the code changed, the version stays the same and only the register's stage row is updated. The single exception is a 0.x tool's first promotion to production, which always sets 1.0.0 and raises a release PR.

What happens if there is no founder approval on the promotion ticket?▼

The promotion stops. The runbook treats a missing founder comment as a hard stop condition with no judgement allowed, and the agent must ask for the decision to be written on the ticket before proceeding.

Where is a toy's current stage recorded?▼

The stage lives only in the release register on the server, never in the version number or git tags. Agents must read the register to learn a stage and insert new rows rather than update existing ones, since history is the promotion log.

What are the stop conditions during a toy promotion?▼

Stop if the register or account service is unavailable, if no founder comment exists on the ticket, if the manifest version and register disagree, or if the toy's entry bar for the target stage is not met. Never simulate a register locally.