Agent skill

Knockoff Release Shipper

by Shpigford in Shpigford/chops

Cuts a new Knockoff release by bumping the version, rolling release notes, tagging and shipping to the Chrome, Firefox and Apple stores with a per-store report.

Custom licenceAuto-check: notesDevelopment

Install Knockoff Release Shipper

skills CLI
$ npx skills add Shpigford/chops --skill release -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Shpigford/chops release --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Shpigford/chops.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/release .claude/skills/release && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
release
GitHub stars
1.9k
Token cost
~1.2k tokens
SKILL.md length
597 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Custom licence

At a glance

Cuts a new Knockoff release by bumping the version, rolling release notes, tagging and shipping to the Chrome, Firefox and Apple stores with a per-store report.

  • Works in 7 steps: Verify prerequisites → Determine the next version → Confirm the version → …
  • Shipping a new Knockoff version to all three stores
  • SKILL.md covers Instructions and Important Rules
  • Calls git, xcrun and npm; needs AC_PASSWORD

What it does

One version ships to three stores, with `manifest.json` as the single source of truth that the Safari marketing version, the Chrome Web Store version gate, the release note headings and the git tag all follow. A preflight runs before the agent asks you anything and collects failures instead of stopping at the first: a clean `main` in sync with origin, passing tests, the listing check, the Firefox lint and credentials for each store.

Credentials differ per store: GitHub secrets and the `gh` CLI for Chrome, an `.env.amo` file with AMO keys for Firefox, and on macOS an `.env.asc` file with an App Store Connect key and a signed-in Xcode team for Safari, which covers macOS and iOS or iPadOS. Missing credentials are never skipped silently; the agent asks whether to release without that store or abort. It then looks at the last tag and the commits since, suggests a patch, minor or major bump and asks one consolidated question that includes Apple release timing, which defaults to manual.

When your agent uses it

  • Shipping a new Knockoff version to all three stores
  • Checking preflight conditions before a release
  • Choosing a version bump from the commits since the last tag

Example prompts

  • “Cut a new Knockoff release and ship it to every store.”
  • “Run the release preflight and tell me what would block shipping.”
  • “What version bump do the commits since the last tag call for?”

Requirements

  • A Knockoff checkout with the `gh` CLI authenticated
  • Store credentials: AMO keys, an App Store Connect key and Chrome Web Store secrets
  • macOS with Xcode for the Safari build

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Verify prerequisites
  2. Determine the next version
  3. Confirm the version
  4. 5: Update CHANGELOG.md
  5. Update the marketing site version
  6. Run the release script
  7. Push and report

What it can do on your machine

Read from SKILL.md and the folder at commit 9d379d5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • xcrun
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AC_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Knockoff Release Shipper loads about 1.2k tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 597 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:12
    1. Confirm `.env` exists in the project root. If it does not, stop and tell the user:
  • NoteMentions a .env fileSKILL.md:13
    "Missing `.env` file. Copy `.env.example` to `.env` and fill in APPLE_TEAM_ID, APPLE_ID, and SIGNING_IDENTITY_NAME."
  • NoteMentions a .env fileSKILL.md:110
    - NEVER run the release script if `.env` is missing or the working tree is dirty

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 597 words (~1,232 tokens).

“Cut a new release of Chops. Determines the version from git history, updates the marketing site, and runs the release script.”

— opening of SKILL.md by Shpigford, Custom licence
name
release

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/release of Shpigford/chops.

Open the folder on GitHubat commit 9d379d5

Compare with similar skills

Knockoff Release Shipper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Knockoff Release Shipper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Knockoff Release Shipper this skillShpigford/chops1.9k—~1.2kAutomated safety check: NotesCustom licence
ReleaseShpigford/knockoff2k—~2.1kAutomated safety check: NotesCustom licence
Mobile Releasebex-co/beancount-io296—~3.5kAutomated safety check: PassMIT
App Store Changelogharperreed/dotfiles3344 repos~465Automated safety check: PassNone
Releasevaayne/mori303—~1.2kAutomated safety check: PassMIT
Commitbiuworks/bilibili-digest172—~450Automated safety check: PassCustom licence

Similar skills

  • Release

    Shpigford/knockoff

    Cut a new Knockoff release — bump the version, roll release notes, tag, and ship to the Chrome Web Store, Firefox Add-ons (AMO), and the Mac & iOS App Store, reporting per-store status at the end.

    2k GitHub stars~2.1k tokensUpdated 2 mo ago
    DevelopmentAuto-check: notes
  • Mobile Release

    bex-co/beancount-io

    Summarize mobile changes since the previous release, bump the Beancount mobile version, prepare localized release notes and listings, and release to the Apple App Store and Google Play.

    296 GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed
  • App Store Changelog

    harperreed/dotfiles

    Create user-facing App Store release notes by collecting and summarizing all user-impacting changes since the last git tag (or a specified ref).

    334 GitHub starsUsed in 4 repos~465 tokens
    DevelopmentAuto-check passed
  • Release

    vaayne/mori

    Release workflow for Mori macOS workspace terminal and MoriRemote iOS app.

    303 GitHub stars~1.2k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Commit

    biuworks/bilibili-digest

    用户要求提交、commit、把改动入库,或让你生成/润色提交信息时使用。产出 type 英文 + 中文主题行的 Conventional Commits 提交,并执行本仓库约定:运行时文件先跑 npm test、不自动 push、发版用 release: 并同步三处版本号。

    172 GitHub stars~450 tokensUpdated today
    DevelopmentAuto-check passed
  • Claude Design

    kwakseongjae/oh-my-design

    현재 코드베이스(또는 폴더)를 분석해 "디자인 컨텍스트 브리프"(스택/디자인 토큰/컴포넌트/ 라우트/실제 UI 카피/큐레이션된 에셋/레포 링크)를 합성하고, 그걸 Claude Design (claude.ai/design)에 자동으로 전달해 디자인을 생성한 뒤 결과 링크를 터미널에 클릭 가능한 형태로 돌려주는 스킬.

    531 GitHub stars~4.8k tokensUpdated 8 days ago
    DevelopmentAuto-check passed

More from Shpigford/chops

  • Setup

    Shpigford/chops

    Get a new developer up and running with the Chops codebase — prerequisites, build, architecture, and common tasks.

    1.9k GitHub stars~980 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Knockoff Release Shipper

What does Knockoff Release Shipper do?

Cuts a new Knockoff release by bumping the version, rolling release notes, tagging and shipping to the Chrome, Firefox and Apple stores with a per-store report. json` as the single source of truth that the Safari marketing version, the Chrome Web Store version gate, the release note headings and the git tag all follow. A preflight runs before the agent asks you anything and collects failures instead of stopping at the first: a clean `main` in sync with origin, passing tests, the listing check, the Firefox lint and credentials for each store.

When should I use Knockoff Release Shipper?

Knockoff Release Shipper fits situations like: shipping a new Knockoff version to all three stores; checking preflight conditions before a release; choosing a version bump from the commits since the last tag.

How do I install Knockoff Release Shipper in Claude Code?

Run `npx skills add Shpigford/chops --skill release -a claude-code`. Or copy the skill folder (.claude/skills/release in Shpigford/chops) into .claude/skills/release in your project. Claude Code loads it when a task matches its description.

How do I install Knockoff Release Shipper in Codex?

Run `npx skills add Shpigford/chops --skill release -a codex`. Or copy the skill folder (.claude/skills/release in Shpigford/chops) into .agents/skills/release in your project. Codex loads it when a task matches its description.

Can I use Knockoff Release Shipper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Shpigford/chops --skill release -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/release, .gemini/skills/release, .github/skills/release and .opencode/skills/release in your project.

What does Knockoff Release Shipper need to run?

Going by SKILL.md and its folder, Knockoff Release Shipper needs the command-line tools its instructions call (git, xcrun and npm) and credentials named AC_PASSWORD. Our summary lists: A Knockoff checkout with the `gh` CLI authenticated; Store credentials: AMO keys, an App Store Connect key and Chrome Web Store secrets; macOS with Xcode for the Safari build.

Does Knockoff Release Shipper access the network?

SKILL.md contains no URLs. Its commands use git and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Knockoff Release Shipper safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Knockoff Release Shipper use?

Knockoff Release Shipper has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Knockoff Release Shipper use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Knockoff Release Shipper?

Skills that share tags, products or a category with Knockoff Release Shipper: Release (Shpigford/knockoff, 2k stars), Mobile Release (bex-co/beancount-io, 296 stars), App Store Changelog (harperreed/dotfiles, 334 stars) and Release (vaayne/mori, 303 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Knockoff Release Shipper?

Shpigford (a GitHub user) maintains it in Shpigford/chops, which has 1,940 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 23, 2026.

Source: Shpigford/chops on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.