Skip to content

Add Tracks release skill#363

Draft
mokagio wants to merge 1 commit into
trunkfrom
mokagio/add-tracks-release-skill
Draft

Add Tracks release skill#363
mokagio wants to merge 1 commit into
trunkfrom
mokagio/add-tracks-release-skill

Conversation

@mokagio

@mokagio mokagio commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Adds a repo-local release skill for Tracks so release runs follow this repository's Swift Package flow: release branch, changelog-only versioning, and GitHub Releases creating tags.

  • I have considered if this change warrants release notes and have added them to the appropriate section in the CHANGELOG.md if necessary.

How to test:

  • python3 /Users/gio/.codex/skills/.system/skill-creator/scripts/quick_validate.py .claude/skills/release-tracks
  • ruby -e "require 'yaml'; YAML.load_file('.claude/skills/release-tracks/agents/openai.yaml')"
  • git diff --check
  • mise exec ruby@3.2.2 -- ruby -S bundle install

Posted by Codex (GPT-5) on behalf of @mokagio with approval.

The release workflow here is specific to this Swift Package:
release branches carry the version change, and GitHub Releases create the release tags consumed by Swift Package Manager.

---

Generated with the help of Codex, https://openai.com/codex

Co-Authored-By: Codex GPT-5 <noreply@openai.com>
Copilot AI review requested due to automatic review settings June 16, 2026 06:13
@mokagio mokagio self-assigned this Jun 16, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a repo-local “release-tracks” skill under .claude/skills/ and links it from AGENTS.md so release runs follow this repository’s Swift Package release flow (release branch + changelog-driven versioning + GitHub Release-created tags).

Changes:

  • Add .claude/skills/release-tracks/SKILL.md documenting the Tracks release contract and workflow.
  • Add an agent descriptor at .claude/skills/release-tracks/agents/openai.yaml.
  • Update AGENTS.md to reference the new release skill and fix a formatting issue in “Common pitfalls”.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
AGENTS.md Adds a “Releases” section pointing to the new release skill; adjusts a pitfall list item formatting.
.claude/skills/release-tracks/SKILL.md Introduces the release contract/workflow for Tracks releases.
.claude/skills/release-tracks/agents/openai.yaml Adds an agent UI config and default prompt for the release skill.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +66 to +67
Target `trunk` so GitHub creates the tag on the merge commit.
`gh release create <version> --target trunk --title <version> --notes-file <notes-file>` is acceptable when the notes file contains only the released changelog section.
Comment on lines +72 to +76
```bash
git fetch origin --tags
git rev-parse <version>
git rev-parse origin/trunk
```
@mokagio mokagio marked this pull request as draft June 16, 2026 06:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants