Agent skill

Release

by skillsynchq in skillsynchq/txcript

Cut a txcript release — dispatch the prepare-release workflow, approve the plan, watch the tag publish to crates.io, npm, and GitHub Releases, and verify.

Apache-2.0Auto-check passedDevelopment

Install Release

skills CLI
$ npx skills add skillsynchq/txcript --skill release -a claude-code

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

GitHub CLI
$ gh skill install skillsynchq/txcript 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/skillsynchq/txcript.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
153
Token cost
~775 tokens
SKILL.md length
431 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
Apache-2.0

At a glance

Cut a txcript release — dispatch the prepare-release workflow, approve the plan, watch the tag publish to crates.io, npm, and GitHub Releases, and verify.

  • Works in 5 steps: Confirm main's latest CI run is green:… → Dispatch: gh workflow run… → The Plan job writes the version and… → …
  • Asked to release
  • SKILL.md covers Inputs, Procedure, Verify and When something fails, plus 1 more section
  • Calls gh, cargo and npm; reaches crates.io

What it does

Release is an agent skill from skillsynchq/txcript. Cut a txcript release — dispatch the prepare-release workflow, approve the plan, watch the tag publish to crates.io, npm, and GitHub Releases, and verify. Use when asked to release, publish, or ship a new version of txcript.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with npm, GitHub, Model Context Protocol and Rust. The repository describes itself as: Pandoc for AI chats. Move ai chats across harnesses: Claude Code, Codex, OpenCode, Cursor, and more. Rust library, CLI, and WASM. The licence is Apache-2.0.

When your agent uses it

  • Asked to release
  • Ship a new version of txcript

Example prompts

  • “/release”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Confirm main's latest CI run is green: gh run list --branch main -L 3.
  2. Dispatch: gh workflow run prepare-release.yml (add -f version=X.Y.Z
  3. The Plan job writes the version and changelog section to the run summary
  4. The Tag job pushes chore(release): vX.Y.Z and the tag atomically. If
  5. The tag starts release. Watch it: gh run list --workflow release.yml -L 1

What it can do on your machine

Read from SKILL.md and the folder at commit 8cd3b0e. 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:

    • gh
    • cargo
    • npm

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • crates.io

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Release loads about 775 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 431 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from skillsynchq/txcript at commit 8cd3b0e, republished under its Apache-2.0 licence (© skillsynchq). 431 words, ~775 tokens.

Download SKILL.mdSave it as .claude/skills/release/SKILL.md (or your agent's skills folder).
name
release
description
Cut a txcript release — dispatch the prepare-release workflow, approve the plan, watch the tag publish to crates.io, npm, and GitHub Releases, and verify. Use when asked to release, publish, or ship a new version of txcript.
argument-hint
version

Release txcript

Releases are cut by two workflows. prepare-release computes the version from the conventional-commit PR titles merged since the last tag, generates the CHANGELOG.md section, bumps every manifest, and lands one commit plus its tag on main. The tag runs release, which publishes crates.io, npm, and CLI binaries, then creates the GitHub Release from the changelog section.

Nothing runs locally. Main is releasable by construction: ci proves the crate packages, the npm bundle builds, and the CLI builds in release mode on every PR, and the ruleset requires PRs to be up to date before merge.

Inputs

$ARGUMENTS: optional version. Without one, the workflow derives it: a feat PR since the last tag is a minor bump, otherwise patch, and a breaking change stays a minor bump until 1.0. Preview locally with git-cliff --bumped-version and git-cliff --unreleased --tag vX.Y.Z --strip all.

Procedure

  1. Confirm main's latest CI run is green: gh run list --branch main -L 3.
  2. Dispatch: gh workflow run prepare-release.yml (add -f version=X.Y.Z to override). Then gh run watch the run.
  3. The Plan job writes the version and changelog section to the run summary and the Tag job waits on the release environment. Read the summary, then approve in the Actions UI. This is the one irreversible decision: a crates.io version can be yanked but never reused.
  4. The Tag job pushes chore(release): vX.Y.Z and the tag atomically. If main moved mid-run it rebuilds the commit on the new head; if the derived version changed because of what landed, it fails and asks for a rerun.
  5. The tag starts release. Watch it: gh run list --workflow release.yml -L 1 then gh run watch <id>. Jobs: verify, crates.io, npm, binaries for five targets, GitHub Release.
Show full SKILL.md (141 more words)Show less

Verify

  • crates.io: cargo search txcript or https://crates.io/api/v1/crates/txcript.
  • npm: npm view txcript version.
  • Release: gh release view vX.Y.Z shows the changelog notes, the package links, and ten assets (five archives, five checksums).
  • cargo binstall --git https://github.com/skillsynchq/txcript txcript-cli installs the new binary.

When something fails

  • verify fails on a manifest mismatch: the tag was pushed by hand without a bump. Delete nothing; run prepare-release for the next patch.
  • A publish job fails after the tag exists: fix forward. The crates.io version may already be taken, so the next run needs a new version.
  • release can be rerun on an existing tag with gh workflow run release.yml --ref vX.Y.Z; the GitHub Release step fails if the release already exists, which is the intended guard.

Report

State the version, the prepare and release run URLs, the release URL, and the crates.io and npm verification results.

© skillsynchq, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/release of skillsynchq/txcript.

Open the folder on GitHubat commit 8cd3b0e

Compare with similar skills

Release 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.

Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Release this skillskillsynchq/txcript153—~775Automated safety check: PassApache-2.0
Temporal Cortex SchedulingLeoYeAI/openclaw-master-skills2.2k—~4.4kAutomated safety check: PassMIT
Octocode Code Researchbgauryy/octocode946—~1.5kAutomated safety check: PassMIT
Project Pull Requestswimmwatch/cloakbrowser-mcp161—~1kAutomated safety check: PassMIT
Triagearcee-ai/nac279—~2kAutomated safety check: PassApache-2.0
Code Reviewoaslananka/kicad-mcp-pro119—~3.9kAutomated safety check: PassMIT

Similar skills

  • Temporal Cortex Scheduling

    LeoYeAI/openclaw-master-skills

    List events, find free slots, and book meetings across Google Calendar, Outlook, and CalDAV.

    2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Octocode Code Research

    bgauryy/octocode

    Researches code with evidence: traces callers, imports and cross-repo links, diagnoses failures and reports findings with exact file and line references and a confidence label.

    946 GitHub stars~1.5k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Project Pull Request

    swimmwatch/cloakbrowser-mcp

    Create, update, prepare, or review a cloakbrowser-mcp GitHub Pull Request only when the user explicitly requests PR work.

    161 GitHub stars~1k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Triage

    arcee-ai/nac

    Triage a GitHub repository's open issues by finding exact duplicates, rejecting evidenceably off-base requests, requesting concrete clarification, applying only existing labels, and opening a linked…

    279 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Code Review

    oaslananka/kicad-mcp-pro

    A skill your agent uses for GitHub Copilot pull request and code reviews in oaslananka/kicad-mcp-pro.

    119 GitHub stars~3.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Release Crate

    r3bl-org/r3bl-open-core

    Publish a crate release to crates.io with changelog, standalone release notes, git tag, and GitHub release.

    485 GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed

More from skillsynchq/txcript

  • Harness

    skillsynchq/txcript

    Integrate a new AI coding-agent harness into txcript — native Body types, Codec, TextCodec, Store, wiring, and tests.

    153 GitHub stars~4.2k tokensUpdated 8 days ago
    Auto-check passed
  • Corpus Check

    skillsynchq/txcript

    Validate a txcript parsing, discovery, or search change against every real agent session on this machine — old-vs-new parity, no panics, and release-build timings.

    153 GitHub stars~827 tokensUpdated 8 days ago
    Auto-check passed

Categories

Questions about Release

What does Release do?

Cut a txcript release — dispatch the prepare-release workflow, approve the plan, watch the tag publish to crates.io, npm, and GitHub Releases, and verify. Release is an agent skill from skillsynchq/txcript.io, npm, and GitHub Releases, and verify.

When should I use Release?

Release fits situations like: asked to release; ship a new version of txcript.

How do I install Release in Claude Code?

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

How do I install Release in Codex?

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

Can I use Release 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 skillsynchq/txcript --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 Release need to run?

Going by SKILL.md and its folder, Release needs the command-line tools its instructions call (gh, cargo and npm).

Does Release access the network?

SKILL.md names 1 domain. In commands or code: crates.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Release safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Release use?

Release is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Release use?

About 775 tokens (SKILL.md is roughly 3.1k 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 Release?

Skills that share tags, products or a category with Release: Temporal Cortex Scheduling (LeoYeAI/openclaw-master-skills, 2.2k stars), Octocode Code Research (bgauryy/octocode, 946 stars), Project Pull Request (swimmwatch/cloakbrowser-mcp, 161 stars) and Triage (arcee-ai/nac, 279 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release?

skillsynchq (a GitHub organization) maintains it in skillsynchq/txcript, which has 153 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 29, 2026.

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