Agent skill

Releasing

by nteract in nteract/nteract

Release and version the project. An agent skill from nteract/nteract.

BSD-3-ClauseAuto-check passed

Install Releasing

skills CLI
$ npx skills add nteract/nteract --skill releasing -a claude-code

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

GitHub CLI
$ gh skill install nteract/nteract releasing --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/nteract/nteract.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/releasing .claude/skills/releasing && 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
releasing
GitHub stars
179
Token cost
~1.2k tokens
SKILL.md length
553 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Release and version the project. An agent skill from nteract/nteract.

  • Works in 7 steps: Builds desktop app (macOS, Windows, Linux) → Builds runt CLI binaries → Builds Python wheels stamped to the base… → …
  • SKILL.md covers Version Scheme, Bumping Versions, Release Types and Tag Reference, plus 4 more sections
  • Calls cargo, git and pip

What it does

Releasing is an agent skill from nteract/nteract. Release and version the project. Only invoke manually.

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

It works with Python, Rust and Tauri. The repository describes itself as: We're back! Now firing notebooks out of a t-shirt gun. The licence is BSD-3-Clause.

Example prompts

  • “/releasing”

Requirements

  • Python 3

Workflow steps

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

  1. Builds desktop app (macOS, Windows, Linux)
  2. Builds runt CLI binaries
  3. Builds Python wheels stamped to the base version from crates/runt/Cargo.toml
  4. Publishes runtimed wheels to PyPI (stable)
  5. Creates GitHub Release with all artifacts
  6. Updates stable-latest Tauri updater channel
  7. Posts to Discord

What it can do on your machine

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

    • cargo
    • git
    • pip

    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 pip, 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 no API keys, tokens, secrets or passwords.

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

Context cost

Releasing loads about 1.2k tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 553 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~16
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 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 nteract/nteract at commit 32e010b, republished under its BSD-3-Clause licence (© nteract). 553 words, ~1,238 tokens.

Download SKILL.mdSave it as .claude/skills/releasing/SKILL.md (or your agent's skills folder).
name
releasing
description
Release and version the project. Only invoke manually.
disable-model-invocation
true

Releasing

Version Scheme

Published desktop, CLI, daemon, and runtimed Python artifacts share the same base version. Python release jobs stamp the wheel version from the Rust release source during the workflow, after cargo xtask bump has updated the checked-in version files.

ArtifactVersion source
nteract desktop appcrates/notebook/tauri.conf.json
runt CLIcrates/runt/Cargo.toml
runtimed daemoncrates/runtimed/Cargo.toml
runtimed Python packagepython/runtimed/pyproject.toml, then stamped from crates/runt/Cargo.toml during release
nteract Python packagepython/nteract/pyproject.toml
Internal Compatibility Markers

Two independent version numbers (incrementing integers, not semver):

  • Protocol version (PROTOCOL_VERSION in crates/notebook-protocol/src/connection/handshake.rs, re-exported by connection.rs): Wire compatibility. Validated by magic bytes preamble at connection time.
  • Schema version (SCHEMA_VERSION in notebook-doc/src/lib.rs): Automerge document compatibility. Stored in doc root.

These evolve independently from each other and from the artifact version.

Bumping Versions

bash
cargo xtask bump patch  # or minor, or major

This updates all versioned artifacts in lockstep (Rust crates, Python packages, frontend packages, plugin manifests, Tauri config) and runs cargo update -w to refresh Cargo.lock. See crates/xtask/src/bump.rs for the complete target list.

Commit the version bump, then tag to trigger the release.

Release Types

Stable Release
bash
git tag v2.1.0-stable.202607020900
git push origin v2.1.0-stable.202607020900

Triggers release-stable.yml which:

  1. Builds desktop app (macOS, Windows, Linux)
  2. Builds runt CLI binaries
  3. Builds Python wheels stamped to the base version from crates/runt/Cargo.toml
  4. Publishes runtimed wheels to PyPI (stable)
  5. Creates GitHub Release with all artifacts
  6. Updates stable-latest Tauri updater channel
  7. Posts to Discord
Nightly Release

Runs automatically at 9am UTC daily via release-nightly.yml, or manually via workflow dispatch.

  • Desktop version gets -nightly.{timestamp} suffix
  • Python wheels get alpha stamp: 2.0.1a202507150900 (PEP 440)
  • App branded "nteract Nightly" with separate bundle ID
  • GitHub Release marked as prerelease
  • CLI binary named runt-nightly

Install nightly Python: pip install runtimed --pre

Python Release Policy

runtimed Python wheels ship from the stable and nightly release workflows. Nightly builds stamp the next patch alpha version (PEP 440), and stable builds stamp the base version from crates/runt/Cargo.toml. cargo xtask bump still updates python/runtimed/pyproject.toml; workflow stamping is a guardrail so a stale pyproject cannot publish the wrong wheel version.

Show full SKILL.md (229 more words)Show less

Tag Reference

Tag patternWorkflowWhat it publishes
v*release-stable.ymlDesktop app + CLI + runtimed Python (stable)
(cron)release-nightly.ymlDesktop app + CLI + runtimed Python (pre-release)

Protocol Version Change Procedure

  1. Bump PROTOCOL_VERSION in crates/notebook-protocol/src/connection/handshake.rs
  2. Update the PROTOCOL_V* string constant if the version string changes
  3. Update crates/notebook-wire/AGENTS.md
  4. Decide version bump type based on user impact

Magic bytes preamble rejects mismatched protocol versions at wire level, before JSON parsing.

Schema Version Change Procedure

  1. Bump SCHEMA_VERSION in crates/notebook-doc/src/lib.rs
  2. Add migration logic in daemon's doc loading path (detect old schema, convert in-place)
  3. Update document schema comment in notebook-doc/src/lib.rs

Schema changes don't require a protocol bump because the wire format for sync frames stays the same.

CI Internals

release-common.yml accepts inputs:

  • github_release_prerelease: true: applies PEP 440 alpha stamp to Python version
  • github_release_prerelease: false: stamps Python version from crates/runt/Cargo.toml

Python wheels are always built (macOS arm64, macOS x64, Linux x64, Linux ARM64, Windows x64, Windows ARM64) and published.

Desktop version: {runt version}-{suffix}.{timestamp} stamped into tauri.conf.json and Cargo.toml at build time (not committed).

Trusted Publishing

PyPI uses OIDC trusted publishing (no API tokens). GitHub Actions workflow identity registered as trusted publisher on PyPI for runtimed package.

Pre-Release Checklist

  • All version sources bumped and in sync
  • cargo check passes (Cargo.lock updated)
  • PROTOCOL_VERSION and SCHEMA_VERSION correct for this release
  • CI is green on main
  • Changelog-worthy items use conventional commit prefixes (feat, fix, perf)

© nteract, BSD-3-Clause. 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 .agents/skills/releasing of nteract/nteract.

Open the folder on GitHubat commit 32e010b

Compare with similar skills

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

Releasing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Releasing this skillnteract/nteract179—~1.2kAutomated safety check: PassBSD-3-Clause
Add Comfyui NodeMooshieblob1/MooshieUI207—~936Automated safety check: PassAGPL-3.0
Code Reviewoaslananka/kicad-mcp-pro120—~3.9kAutomated safety check: PassMIT
Flowfile Build and Environment SetupEdwardvaneechoud/Flowfile375—~7.3kAutomated safety check: NotesMIT
Update V8 Versionopeninterpreter/openinterpreter69k2 repos~845Automated safety check: PassApache-2.0
Firecrawl Page Scrape Integrationfirecrawl/firecrawl190k1 repos~944Automated safety check: PassISC

Similar skills

  • Add Comfyui Node

    Mooshieblob1/MooshieUI

    Adds a custom ComfyUI Python node to MooshieUI — Python class in mooshienodes.py, Rust required-class registration, and optional workflow template chain hookup.

    207 GitHub stars~936 tokensUpdated today
    AI & LLM EngineeringAuto-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.

    120 GitHub stars~3.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Flowfile Build and Environment Setup

    Edwardvaneechoud/Flowfile

    Recreates every Flowfile development and build environment from scratch, with exact version pins and an explanation of what each Makefile target really does.

    375 GitHub stars~7.3k tokensUpdated today
    DevelopmentAuto-check: notes
  • Update V8 Version

    openinterpreter/openinterpreter

    Bumps the pinned v8 and rusty_v8 versions in Codex, validates the release-candidate path with the v8-canary check, and traces failures to upstream build changes.

    69k GitHub starsUsed in 2 repos~845 tokens
    DevOps & CloudAuto-check passed
  • Adds Firecrawl's /scrape endpoint to application code to pull markdown, HTML, links, screenshots or structured data from a single known URL.

    190k GitHub starsUsed in 1 repo~944 tokens
    Data & AnalyticsAuto-check passed
  • Fory Release

    apache/fory

    Prepare an Apache Fory release candidate from a clean release branch, including the version bump, RC tag, JVM staging, ASF source artifacts, SVN upload, and vote email.

    4.6k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed

More from nteract/nteract

All 10 skills in this repo
  • Automerge Sync

    nteract/nteract

    Automerge sync protocol internals, document model (OpSet, ChangeGraph, fork/merge, save/load lifecycle), and higher-level protocol design patterns.

    179 GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • Daemon Dev

    nteract/nteract

    Develop, debug, and manage the runtimed daemon, Python bindings, and build system.

    179 GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Execution Pipeline

    nteract/nteract

    The end-to-end cell execution pipeline from MCP tool call through daemon to kernel and back.

    179 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Nteract Diagnostics

    nteract/nteract

    Pull and triage submitted nteract diagnostics archives from Cloudflare using a diagnostics id/token.

    179 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Repl

    nteract/nteract

    Use nteract notebooks as a persistent Python REPL. An agent skill from nteract/nteract.

    179 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Testing

    nteract/nteract

    Run tests, verify changes, and collect diagnostics. An agent skill from nteract/nteract.

    179 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Works with

Questions about Releasing

What does Releasing do?

Release and version the project. An agent skill from nteract/nteract. Releasing is an agent skill from nteract/nteract. Release and version the project.

How do I install Releasing in Claude Code?

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

How do I install Releasing in Codex?

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

Can I use Releasing 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 nteract/nteract --skill releasing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/releasing, .gemini/skills/releasing, .github/skills/releasing and .opencode/skills/releasing in your project.

What does Releasing need to run?

Going by SKILL.md and its folder, Releasing needs the command-line tools its instructions call (cargo, git and pip). Our summary lists: Python 3.

Does Releasing access the network?

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

Is Releasing 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 Releasing use?

Releasing is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Releasing use?

About 1.2k tokens (SKILL.md is roughly 5k 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 Releasing?

Skills that share tags, products or a category with Releasing: Add Comfyui Node (Mooshieblob1/MooshieUI, 207 stars), Code Review (oaslananka/kicad-mcp-pro, 120 stars), Flowfile Build and Environment Setup (Edwardvaneechoud/Flowfile, 375 stars) and Update V8 Version (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Releasing?

nteract (a GitHub organization) maintains it in nteract/nteract, which has 179 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 9, 2026.

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