codex-trace: Skill for Claude Code

.claude/skills/cut-release/SKILL.md

cut-release is a skill for Claude Code from PixelPaw-Labs/codex-trace. It costs 210 tokens per session (1,415 once invoked), scanned A, a copy of cut-release, MIT.

A release procedure for the codex-trace project that determines the next version, updates version files, writes a changelog entry, and creates a release commit and tag. A changelog records what changed, while a tag marks a specific version in Git.

In plain words
What is it for?
Use it when publishing a new codex-trace release, including preparing the release branch, tagging the version, pushing it, and triggering the project's release process.
Why use it?
It keeps version information and release notes synchronized and follows the project's required checks and publishing pipeline. It uses commits since the last tag to choose the version increase.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_SKILL_DIR} variable. Also seen: names the AskUserQuestion tool; mentions Codex.

This is PixelPaw-Labs/codex-trace's own configuration. It tells Claude Code how to work on codex-trace itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything codex-trace configures →

Reuse

Borrowing it

Nothing to install: this file belongs to PixelPaw-Labs/codex-trace. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/PixelPaw-Labs/codex-trace/main/.claude/skills/cut-release/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/PixelPaw-Labs/codex-trace

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cut-release

README.md
[![agentmods](https://agentmods.dev/badge/skills/pixelpaw-labs/codex-trace/cut-release/github.svg)](https://agentmods.dev/skills/pixelpaw-labs/codex-trace/cut-release)
Your own site
<a href="https://agentmods.dev/skills/pixelpaw-labs/codex-trace/cut-release"><img src="https://agentmods.dev/badge/skills/pixelpaw-labs/codex-trace/cut-release/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cut-release

Your own site · 80×15
<a href="https://agentmods.dev/skills/pixelpaw-labs/codex-trace/cut-release"><img src="https://agentmods.dev/badge/skills/pixelpaw-labs/codex-trace/cut-release.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 210 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,415 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 98% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00210 $0.01415
Opus 5.5 $0.00084 $0.00566
Sonnet 5.5 $0.00042 $0.00283
Haiku 4.5 $0.00021 $0.00142

Measured 1mo ago against content hash e8dde62c52aa, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cut-release scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

98% identical to cut-release — 10 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.claude/skills/cut-release/SKILL.md · 124 lines

How it starts

The opening of the file, as written. The whole thing — 124 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Cut a Release — codex-trace

Turns "we should release this" into a tagged, pushed, pipeline-triggered, publicly published release with a curated CHANGELOG, in a way that survives the project's strict pre-commit hook and stays honest about what's actually shipping.

The skill is project-local because the steps depend on this repo's specific shape (three version files, two lockfiles, GH Actions release on v* tag, the test-reflection pre-commit hook).

Operating mode

The skill is fully automated end-to-end and fully synchronous. It never calls AskUserQuestion, never waits for "yes", never branches on user preference, and never runs any command in the background. Every Bash invocation runs in the foreground so the session holds continuously from Phase 1 through Phase 9 — no run_in_background: true, no trailing &, no nohup, no disown. This includes long-running steps like gh run watch in Phase 7; set the Bash timeout parameter to match the expected duration (e.g. 1800000 ms for the release pipeline) rather than detaching.

Defaults are deterministic:

  • Scope — always linear: every commit since git describe --tags --abbrev=0 ships.
  • Bump tier — highest conventional-commit tier in the subset (see ${CLAUDE_SKILL_DIR}/references/conventional-commits.md). BREAKING CHANGE: or !: produces a minor bump while the version is 0.X.Y (pre-1.0 caveat) and a major bump otherwise; the skill never silently promotes to 1.0.0.
  • CHANGELOG — every Added/Fixed bullet is written from commit subjects + diff reads; chore: / docs: / test: / ci: are always skipped.
  • Push order — tag first, then main (so CI sees the tag immediately; main catches up after).

The skill aborts (loudly) only on hard preconditions that would corrupt the release:

  • Duplicate version — the proposed vX.Y.Z tag already exists on origin. Abort with Error: vX.Y.Z already exists on origin (commit <sha>). Refusing to release the same version twice. The user must delete the remote tag intentionally if they want a re-release, or bump again.
  • Dirty working tree — uncommitted changes the skill didn't create. Abort with a list of dirty files.
  • npm run check fails — abort and surface the failure verbatim.

Read the full file on GitHub · 124 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 124 lines · 210 tokens per session scan A e8dde62c52aa

Subscribe to this mod's changes

cut-release is a skill published in the GitHub repository PixelPaw-Labs/codex-trace (116 stars, last pushed 6d ago), licensed MIT. It adds 210 tokens to every session and 1,415 once invoked, about $0.0008 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 98% identical to cut-release, differing in 10 lines, and is treated as a copy.

Related

Other skills, from other repositories

app-release

Use when the user asks to release a new version, ship a build, or publish a Skill Zoo release. Also use when a tag push results in Homebrew 404 errors or missing artifact failures.

luochang212/skill-zoo · 43 tokens

npm-release

Use when publishing or preparing to publish an npm package from this repository, especially the Skill Zoo CLI package under packages/cli. Also use when npm publish fails because of duplicate versions, npm authentication, browser authentication, dist-tag propagation, tarball contents, bin entry issues, or…

luochang212/skill-zoo · 66 tokens

github

Drive GitHub via the official gh CLI — repos, issues, pull requests, releases, gists, Actions runs, and raw REST through gh api. Use when the user asks to inspect or manage GitHub.

AtomicBot-ai/Atomic-Chat · 48 tokens

mina-ralph-loop-bootstrap-nextjs

Bootstrap or extend a new or early-stage Next.js App Router + TypeScript repository around a Ralph-style task-promotion loop. Use when Codex needs to ask the founder product and architecture questions, generate or update the repo-local markdown knowledge base, create the initial scaffold or the next feature wave…

stevennana/mina-ralph-loop-bootstrap-nextjs · 88 tokens

release-safety

Release safety rules. INVOKE WHEN: yarn release, npm publish, release canary, release packages, publishing, skip checks, skip tests. NEVER skip checks or tests without explicit permission.

tamagui/tamagui · 0 tokens

git-workflow

Guided git workflows: prepare PRs, clean up branches, resolve merge conflicts, handle monorepo tags, squash-and-merge patterns. Use when asked to prepare a PR, clean branches, resolve conflicts, or tag a release.

jezweb/claude-skills · 52 tokens