Release Decision
Use this skill to decide whether a repository change needs a package version
release and what release action to recommend.
Workflow
- Identify the reviewed scope:
- For local work, inspect
git status --short and the relevant diff.
- For a commit or PR, inspect the diff against its base.
- Map changed files to package(s):
- Use each package's
package.json name and private field.
- Treat root marketplace files, plugin manifests, install docs, package
READMEs, and packaged skill files as user-visible surfaces.
- Classify the highest-impact user-visible change.
- Decide whether a changeset is needed.
- Report the decision in the response shape below.
Do not manually edit package versions just to satisfy this checklist. Version
bumps are handled through Changesets and the release workflow unless the user
explicitly asks for release-versioning work.
Decisions
No release needed
Use when the change does not alter published package behavior, public APIs,
packaged output, marketplace-visible metadata, or install behavior.
Common examples:
- Tests, fixtures, CI-only behavior, or local developer tooling.
- Formatting, comments, or internal refactors with no behavior change.
- Agent-only instructions such as
AGENTS.md or project-local skills, unless
they are packaged and shipped to users.
- Root documentation or maintenance notes that do not change install or package
usage semantics.
- Changes limited to private packages, unless their versioned artifact or
distribution path is part of the release plan.
If the change is user-visible but intentionally has no package release, mention
whether an empty/no-release changeset is useful for project history.
Patch release recommended
Use for backward-compatible fixes to published package behavior or package
output.
Common examples:
- Bug fixes in
@call-e/cli, @call-e/core, @call-e/codex-plugin,
@call-e/claude-plugin, or @call-e/cursor-plugin.
- Compatibility fixes for supported host tools.
- Corrections to packaged manifests, plugin metadata, skills, command guidance,
bundled assets, or package READMEs.
- Runtime dependency updates that affect published behavior.
- Install or usage documentation corrections that are shipped inside a package
or required to keep a packaged integration accurate.
Minor release recommended
Use for backward-compatible new functionality.
Common examples:
- New commands, flags, options, agent capabilities, or integration workflows.
- New marketplace-visible capabilities or packaged skills.
- New package entry points that do not break existing consumers.
- Backward-compatible expansion of documented public APIs.
Major release required
Use for breaking changes.
Common examples:
- Removing or renaming commands, flags, package exports, plugin identifiers,
marketplace identifiers, skills, or install entry points.
- Changing documented behavior in an incompatible way.
- Changing required setup or install commands in a way that breaks existing
users.
- Incompatible public API, package layout, or telemetry attribution changes.
Needs maintainer decision
Use when the semver or release boundary is unclear.
Common examples:
- Multi-package changes where dependent package bump levels are ambiguous.
- Marketplace alias,
latest tag, package naming, or release workflow changes.
- Private packages or productized skills whose distribution path is unclear.
- Security fixes where urgency, disclosure, or backport policy affects the
release shape.
- Conflicts between Changesets behavior and project release expectations.
Changesets
For user-visible package changes, recommend a changeset for the affected
package(s). Use the smallest semver bump that matches the highest-impact change.
For a deliberate no-release record, this repository may use an empty changeset:
---
---
No release: <short reason>.
Relevant commands:
pnpm changeset
pnpm run check:versions
pnpm pack:dry-run
For release PR work only:
pnpm run version-packages
Repository Checks
When relevant, inspect:
- Root
package.json scripts for release and validation commands.
- Package-level
package.json files under packages/.
.changeset/config.json and existing .changeset/*.md files.
docs/documentation-maintenance.md before changing user-facing docs,
repeated commands, install steps, package usage, or visible metadata.
docs/agent-integration-layout.md before changing marketplace entry points,
plugin names, visible labels, or install commands.
pnpm pack:dry-run output when packaged files or manifests changed.
Response Shape
Always report:
- Decision:
- Affected package(s):
- Changeset:
- Reason:
- Suggested version bump:
- Follow-up commands, if any:
1---2name: release-decision3description: Use this project-local skill when deciding whether a CALL-E Integrations change needs a package version release, changeset, or maintainer release decision, especially before finishing code, docs, marketplace, plugin, package metadata, or install-flow changes.4metadata:5 source: https://skillmd.com/skills/calle-ai/release-decision6---78# Release Decision910Use this skill to decide whether a repository change needs a package version11release and what release action to recommend.1213## Workflow14151. Identify the reviewed scope:16 - For local work, inspect `git status --short` and the relevant diff.17 - For a commit or PR, inspect the diff against its base.182. Map changed files to package(s):19 - Use each package's `package.json` name and `private` field.20 - Treat root marketplace files, plugin manifests, install docs, package21 READMEs, and packaged skill files as user-visible surfaces.223. Classify the highest-impact user-visible change.234. Decide whether a changeset is needed.245. Report the decision in the response shape below.2526Do not manually edit package versions just to satisfy this checklist. Version27bumps are handled through Changesets and the release workflow unless the user28explicitly asks for release-versioning work.2930## Decisions3132### No release needed3334Use when the change does not alter published package behavior, public APIs,35packaged output, marketplace-visible metadata, or install behavior.3637Common examples:3839- Tests, fixtures, CI-only behavior, or local developer tooling.40- Formatting, comments, or internal refactors with no behavior change.41- Agent-only instructions such as `AGENTS.md` or project-local skills, unless42 they are packaged and shipped to users.43- Root documentation or maintenance notes that do not change install or package44 usage semantics.45- Changes limited to private packages, unless their versioned artifact or46 distribution path is part of the release plan.4748If the change is user-visible but intentionally has no package release, mention49whether an empty/no-release changeset is useful for project history.5051### Patch release recommended5253Use for backward-compatible fixes to published package behavior or package54output.5556Common examples:5758- Bug fixes in `@call-e/cli`, `@call-e/core`, `@call-e/codex-plugin`,59 `@call-e/claude-plugin`, or `@call-e/cursor-plugin`.60- Compatibility fixes for supported host tools.61- Corrections to packaged manifests, plugin metadata, skills, command guidance,62 bundled assets, or package READMEs.63- Runtime dependency updates that affect published behavior.64- Install or usage documentation corrections that are shipped inside a package65 or required to keep a packaged integration accurate.6667### Minor release recommended6869Use for backward-compatible new functionality.7071Common examples:7273- New commands, flags, options, agent capabilities, or integration workflows.74- New marketplace-visible capabilities or packaged skills.75- New package entry points that do not break existing consumers.76- Backward-compatible expansion of documented public APIs.7778### Major release required7980Use for breaking changes.8182Common examples:8384- Removing or renaming commands, flags, package exports, plugin identifiers,85 marketplace identifiers, skills, or install entry points.86- Changing documented behavior in an incompatible way.87- Changing required setup or install commands in a way that breaks existing88 users.89- Incompatible public API, package layout, or telemetry attribution changes.9091### Needs maintainer decision9293Use when the semver or release boundary is unclear.9495Common examples:9697- Multi-package changes where dependent package bump levels are ambiguous.98- Marketplace alias, `latest` tag, package naming, or release workflow changes.99- Private packages or productized skills whose distribution path is unclear.100- Security fixes where urgency, disclosure, or backport policy affects the101 release shape.102- Conflicts between Changesets behavior and project release expectations.103104## Changesets105106For user-visible package changes, recommend a changeset for the affected107package(s). Use the smallest semver bump that matches the highest-impact change.108109For a deliberate no-release record, this repository may use an empty changeset:110111```md112---113---114115No release: <short reason>.116```117118Relevant commands:119120```bash121pnpm changeset122pnpm run check:versions123pnpm pack:dry-run124```125126For release PR work only:127128```bash129pnpm run version-packages130```131132## Repository Checks133134When relevant, inspect:135136- Root `package.json` scripts for release and validation commands.137- Package-level `package.json` files under `packages/`.138- `.changeset/config.json` and existing `.changeset/*.md` files.139- `docs/documentation-maintenance.md` before changing user-facing docs,140 repeated commands, install steps, package usage, or visible metadata.141- `docs/agent-integration-layout.md` before changing marketplace entry points,142 plugin names, visible labels, or install commands.143- `pnpm pack:dry-run` output when packaged files or manifests changed.144145## Response Shape146147Always report:148149- Decision:150- Affected package(s):151- Changeset:152- Reason:153- Suggested version bump:154- Follow-up commands, if any: