Agent skill

Dev Release

by alecs5am in alecs5am/ralphy

Cut a Ralphy CLI release across GitHub Releases, Homebrew, and npm.

Apache-2.0Auto-check passedDevelopment

Install Dev Release

skills CLI
$ npx skills add alecs5am/ralphy --skill dev-release -a claude-code

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

GitHub CLI
$ gh skill install alecs5am/ralphy dev-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/alecs5am/ralphy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/dev-release .claude/skills/dev-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
dev-release
GitHub stars
136
Token cost
~757 tokens
SKILL.md length
319 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

Cut a Ralphy CLI release across GitHub Releases, Homebrew, and npm.

  • Works in 3 steps: GitHub Release with platform binaries… → alecs5am/homebrew-tap formula. → @alecs5am/ralphy on npm.
  • The user asks to release
  • SKILL.md covers Repositories, Release contract, Procedure and Stop conditions
  • Calls bun and gitleaks

What it does

Dev Release is an agent skill from alecs5am/ralphy. Cut a Ralphy CLI release across GitHub Releases, Homebrew, and npm. Use when the user asks to release, tag, publish, or prepare release notes for the CLI. Public documentation and the marketing site live in sibling repositories and are synchronized separately when their content is affected.

Its SKILL.md is about 760 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, covering Landing pages and Changelog and release notes. It works with npm, GitHub and Homebrew. The repository describes itself as: Open-source desktop app for content creation, with an agent runtime and standalone CLI. The licence is Apache-2.0.

When your agent uses it

  • The user asks to release
  • Prepare release notes for the CLI

Example prompts

  • “/dev-release”

Workflow steps

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

  1. GitHub Release with platform binaries and SHA256SUMS.
  2. alecs5am/homebrew-tap formula.
  3. @alecs5am/ralphy on npm.

What it can do on your machine

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

    • bun
    • gitleaks

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

  • Network

    No URLs in SKILL.md.

    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

Dev Release loads about 757 tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 319 words of instructions outside code blocks.

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

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 alecs5am/ralphy at commit 8d139f0, republished under its Apache-2.0 licence (© alecs5am). 319 words, ~757 tokens.

Download SKILL.mdSave it as .claude/skills/dev-release/SKILL.md (or your agent's skills folder).
name
dev-release
description
Cut a Ralphy CLI release across GitHub Releases, Homebrew, and npm. Use when the user asks to release, tag, publish, or prepare release notes for the CLI. Public documentation and the marketing site live in sibling repositories and are synchronized separately when their content is affected.
namespace
maintainer

Release the Ralphy CLI

This skill ships the agent-facing CLI in this repository. It never releases the marketing site, public docs site, desktop app, or unattended farm runtime.

Repositories

  • CLI: current repository, alecs5am/ralphy.
  • Public docs: sibling ../ralphy-docs, alecs5am/ralphy-docs.
  • Marketing and library: sibling ../ralphy-web, alecs5am/ralphy-web.
  • Desktop: sibling ../ralphy-desktop, alecs5am/ralphy-desktop.
  • Unattended automation: sibling ../ralphy-farm, alecs5am/ralphy-farm.

Only the CLI repository receives the vX.Y.Z release tag. If a CLI change affects public documentation, update and push ralphy-docs before tagging the CLI. Web, desktop, and farm changes follow their own release processes.

Release contract

One version must reach all three CLI channels:

  1. GitHub Release with platform binaries and SHA256SUMS.
  2. alecs5am/homebrew-tap formula.
  3. @alecs5am/ralphy on npm.

Never amend or replace an existing release. Never publish only one channel.

Procedure

  1. Confirm the current branch is main, the worktree is clean, and gh auth status plus npm whoami identify the expected maintainer.

  2. Read scripts/release/last-release-commit, the latest v* tag, and commits since that baseline. Propose the semver bump and grouped release notes.

  3. Inspect the diff for public-doc impact. If needed, update ../ralphy-docs, validate docs.json, commit, and push that repository separately.

  4. Run the CLI verification suite:

    bash
    bun run lint
    bun test --timeout 45000 tests/unit tests/integration
    bun run build:bin:current
    gitleaks detect --source .
  5. After explicit user approval, update these version sources in lockstep:

    • package.json
    • cli/lib/version.ts
    • npm/package.json
    • the current-version line in AGENTS.md
  6. Commit chore(release): vX.Y.Z, tag that commit vX.Y.Z, and push the commit and tag. Do not create the GitHub Release manually; the release workflow owns binaries, checksums, and the release object.

  7. Watch the GitHub Actions release workflow to success.

  8. Run scripts/release/update-brew-tap.sh vX.Y.Z and scripts/release/publish-npm.sh X.Y.Z, then verify both registries resolve the new version.

  9. Update scripts/release/last-release-commit in a separate trailing commit so the next release has an exact baseline.

Stop conditions

Stop before tagging when tests fail, versions disagree, credentials are wrong, there are no releasable commits, or the user has not approved the proposed version. Documentation-only changes in ralphy-docs do not require a CLI tag.

© alecs5am, 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 .agents/skills/dev-release of alecs5am/ralphy.

Open the folder on GitHubat commit 8d139f0

Compare with similar skills

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

Dev Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dev Release this skillalecs5am/ralphy136—~757Automated safety check: PassApache-2.0
ClickUp CLI Release Processkrodak/clickup-cli120—~906Automated safety check: WarnMIT
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
Mole CLI Release Flowtw93/Mole69k—~2.5kAutomated safety check: PassGPL-3.0
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Hunk Release Workflowmodem-dev/hunk9.5k—~3.8kAutomated safety check: PassMIT

Similar skills

  • ClickUp CLI Release Process

    krodak/clickup-cli

    Walks through releasing a new version of clickup-cli: pre-release checks, version bump, tagging, CI watch, release notes and the Homebrew update.

    120 GitHub stars~906 tokensUpdated yesterday
    DevOps & CloudAuto-check: warnings
  • Cutting A Release

    TriliumNext/Trilium

    A skill your agent uses when cutting, preparing, or debugging a Trilium release — bumping the monorepo version, tagging, or diagnosing a failed "Release" workflow run.

    38k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    69k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Hunk Release Workflow

    modem-dev/hunk

    Maintainer workflow for preparing, publishing, verifying and curating Hunk releases, with confirmation gates before tags, publishes and public edits.

    9.5k GitHub stars~3.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Version Release

    NG-ZORRO/ng-zorro-antd

    NG-ZORRO/ng-zorro-antd repository release workflow. An agent skill from NG-ZORRO/ng-zorro-antd.

    9.2k GitHub stars~3.1k tokensUpdated 7 days ago
    DevelopmentAuto-check passed

More from alecs5am/ralphy

All 29 skills in this repo
  • Social Content

    alecs5am/ralphy

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    136 GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Gsap

    alecs5am/ralphy

    GSAP animation reference for HyperFrames. An agent skill from alecs5am/ralphy.

    136 GitHub stars~2.4k tokensUpdated 15 days ago
    Auto-check passed
  • Researcher

    alecs5am/ralphy

    Deep-research workflow for UGC reference material — turns one or more URLs / handles / trend queries into a single cited research report (report.md + sources.json) that a scenarist or art-director…

    136 GitHub stars~1.9k tokensUpdated 15 days ago
    Auto-check passed
  • Editor

    alecs5am/ralphy

    Composition and render craft — assembles scenario.json plus asset-manifest.json into a HyperFrames HTML composition and renders the mp4.

    136 GitHub stars~3.6k tokensUpdated 15 days ago
    Auto-check passed
  • Evaluator

    alecs5am/ralphy

    Quality evaluation of rendered UGC mp4s — scene segmentation, audio loudness / dead-air, caption density, and per-scene visual analysis.

    136 GitHub stars~3.6k tokensUpdated 15 days ago
    Auto-check passed
  • Producer

    alecs5am/ralphy

    End-to-end orchestration — the wrapper that drives the whole production contract across roles, plus batch production.

    136 GitHub stars~4.7k tokensUpdated 15 days ago
    Auto-check passed

Categories

Questions about Dev Release

What does Dev Release do?

Cut a Ralphy CLI release across GitHub Releases, Homebrew, and npm. Dev Release is an agent skill from alecs5am/ralphy. Cut a Ralphy CLI release across GitHub Releases, Homebrew, and npm.

When should I use Dev Release?

Dev Release fits situations like: the user asks to release; prepare release notes for the CLI.

How do I install Dev Release in Claude Code?

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

How do I install Dev Release in Codex?

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

Can I use Dev 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 alecs5am/ralphy --skill dev-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/dev-release, .gemini/skills/dev-release, .github/skills/dev-release and .opencode/skills/dev-release in your project.

What does Dev Release need to run?

Going by SKILL.md and its folder, Dev Release needs the command-line tools its instructions call (bun and gitleaks).

Does Dev Release access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dev 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 Dev Release use?

Dev 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 Dev Release use?

About 757 tokens (SKILL.md is roughly 3k 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 Dev Release?

Skills that share tags, products or a category with Dev Release: ClickUp CLI Release Process (krodak/clickup-cli, 120 stars), Cutting A Release (TriliumNext/Trilium, 38k stars), Mole CLI Release Flow (tw93/Mole, 69k stars) and Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dev Release?

alecs5am (a GitHub user) maintains it in alecs5am/ralphy, which has 136 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on September 22, 2026.

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