New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Calver

by Soul-Brews-Studio in Soul-Brews-Studio/arra-oracle-skills-cli

Show or bump the project's CalVer version. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli.

MITAuto-check passed

Install Calver

skills CLI
$ npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill calver -a claude-code

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

GitHub CLI
$ gh skill install Soul-Brews-Studio/arra-oracle-skills-cli calver --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/Soul-Brews-Studio/arra-oracle-skills-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/calver .claude/skills/calver && 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
calver
GitHub stars
123
Token cost
~1.2k tokens
SKILL.md length
494 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Show or bump the project's CalVer version. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli.

  • User says calver
  • SKILL.md covers Step 0: Locate…, Modes, After apply and Notes
  • Calls bun and git
  • Set the skills version

What it does

Calver is an agent skill from Soul-Brews-Studio/arra-oracle-skills-cli. Show or bump the project's CalVer version. Use when user says "calver", "bump version", "what version", or wants to check or set the skills version. For the full release flow (commit + push + PR) use /release-alpha or /release-stable instead — /calver alone never commits, pushes, or PRs.

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 npm. The repository describes itself as: Install Oracle skills to Claude Code, OpenCode, Cursor, and 12+ AI coding agents. The licence is MIT.

When your agent uses it

  • User says calver
  • Set the skills version

Example prompts

  • “s CalVer version. Use when user says”
  • “bump version”
  • “what version”
  • “/calver”

What it can do on your machine

Read from SKILL.md and the folder at commit 9feea09. 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
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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

Calver loads about 1.2k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 494 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
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 Soul-Brews-Studio/arra-oracle-skills-cli at commit 9feea09, republished under its MIT licence (© Soul-Brews-Studio). 494 words, ~1,220 tokens.

Download SKILL.mdSave it as .claude/skills/calver/SKILL.md (or your agent's skills folder).
name
calver
description
Show or bump the project's CalVer version. Use when user says "calver", "bump version", "what version", or wants to check or set the skills version. For the full release flow (commit + push + PR) use /release-alpha or /release-stable instead — /calver alone never commits, pushes, or PRs.
hidden
true
metadata.internal
true

/calver

Compute / bump the CalVer version for arra-oracle-skills-cli.

⚠️ Pair with the right skill. This skill is --check (read-only) or --apply (writes package.json and stops). It does NOT commit, push, or PR — that's deliberate so a bump can never accidentally cut a release.

Want to…Use
See the next target version/calver (default = --check)
Just bump package.json and stop/calver --apply
Cut a soak release (alpha pre-release)/release-alpha
Cut a stable release on main/release-stable
Land a code fix without releasingregular branch + PR — keep package.json version untouched

Never combine a package.json bump with a code fix in the same commit on this repo — calver-release.yml auto-tags on push to main, so a fix-PR with a bump = automatic stable release.

CalVer scheme: v{yy}.{m}.{d}[-(alpha|beta).{HMM}] — HMM is the wall-clock as decimal H*100 + M with no leading zero (e.g. 09:37 → 937, 23:59 → 2359). Each minute is a unique slot — no merge-order collisions. Alpha and beta are independent channels (#754 / PR #783). Walks git tags AND package.json.version for source-of-truth (#784 / PR #786). TZ fixed to Asia/Bangkok. HMM replaced monotonic counter (#766/#775) in #923.

Day-of-month D may exceed 31 — used as a stable counter once natural date is exhausted (#930). E.g. v26.4.50 is the 50th stable cut in the period, not "April 50".

Step 0: Locate arra-oracle-skills-cli

Always resolve repo via ghq so the skill works from any cwd:

bash
ARRA=$(ghq list -p --exact Soul-Brews-Studio/arra-oracle-skills-cli 2>/dev/null | head -1)
if [ -z "$ARRA" ]; then
  echo "❌ arra-oracle-skills-cli not found via ghq. Run: ghq get github.com/Soul-Brews-Studio/arra-oracle-skills-cli"
  exit 1
fi
echo "🕐 $(date '+%H:%M %Z (%A %d %B %Y)')"
echo "📁 $ARRA"

Modes

Default — dry-run check (show next target)
bash
TZ=Asia/Bangkok bun "$ARRA/scripts/calver.ts" --check

Shows the next target version (max(tag-walk, package.json) + 1 for today's date+channel). No files modified.

--apply — bump package.json
bash
TZ=Asia/Bangkok bun "$ARRA/scripts/calver.ts"

Writes the next version to package.json. Caller then:

bash
git -C "$ARRA" add package.json && git -C "$ARRA" commit -m "bump: v<version>"

Do NOT auto-commit — hand off to user so they can bundle with other changes.

--stable — cut stable (no alpha/beta suffix)
bash
TZ=Asia/Bangkok bun "$ARRA/scripts/calver.ts" --stable
--beta — cut beta (parallel channel, independent counter)
bash
TZ=Asia/Bangkok bun "$ARRA/scripts/calver.ts" --beta

--stable and --beta are mutually exclusive (script exits 2).

Show full SKILL.md (204 more words)Show less
--hour N — REMOVED

The --hour flag is deprecated as of #766 and will exit 2. CalVer now uses a monotonic counter walked from git tags + package.json — there is no hour-bucket to override.

--help — print calver.ts help
bash
TZ=Asia/Bangkok bun "$ARRA/scripts/calver.ts" --help

After apply

Stop. Hand off to the user. Do NOT auto-commit, do NOT push, do NOT open a PR. The whole point of /calver being read-only-or-stop-after-write is so a bump can never accidentally turn into a release.

If the user wants to ship the bump, they invoke a release skill:

Next steps (user runs one of these — not /calver):
  /release-alpha    — soak channel, PR to alpha, calver-release.yml cuts pre-release on merge
  /release-stable   — stable channel (planned), PR to main, calver-release.yml cuts stable on merge

If the user is doing code-only work (no release), tell them to revert the package.json change before opening the PR. Bumping in a non-release branch is the exact failure mode /release-alpha was built to prevent.

Notes

  • The calver.ts script is authoritative. Do NOT hand-compute versions.
  • Release workflow: calver-release.yml tags on push to main when package.json version differs from latest tag. Post-#767, alphas merge to alpha branch (no tags created until stable cut to main); the script handles this by walking package.json (#784 / PR #786).
  • Spec: ψ/inbox/2026-04-18_proposal-calver-skills-cli.md (mawjs-oracle vault).
  • Umbrella issue: #526 (maw-js — original); #284 (arra-oracle-skills-cli — this port).
  • Related changes today (2026-04-28): #775 (monotonic counter), PR #783 (--beta channel for #754), PR #786 (package.json walk for #784).

ARGUMENTS: $ARGUMENTS

© Soul-Brews-Studio, MIT. 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 src/skills/calver of Soul-Brews-Studio/arra-oracle-skills-cli.

Open the folder on GitHubat commit 9feea09

Compare with similar skills

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

Calver compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Calver this skillSoul-Brews-Studio/arra-oracle-skills-cli123—~1.2kAutomated safety check: PassMIT
Defuddlekepano/obsidian-skills49k11 repos~208Automated safety check: PassMIT
Vercel Deploybytedance/deer-flow84k10 repos~797Automated safety check: PassMIT
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
Nx Run Tasksnomcopter/react-mosaic4.8k8 repos~613Automated safety check: PassCustom licence

Similar skills

  • Defuddle

    kepano/obsidian-skills

    Uses the Defuddle CLI to pull clean, readable Markdown, JSON or metadata from web pages, stripping navigation, ads and clutter to save tokens.

    49k GitHub starsUsed in 11 repos~208 tokens
    Knowledge ManagementAuto-check passed

  • Vercel Deploy

    bytedance/deer-flow

    Deploys a project to Vercel with one script and no login, then returns a live preview URL and a claim link for moving the deployment into your own Vercel account.

    84k GitHub starsUsed in 10 repos~797 tokens
    DevOps & CloudAuto-check passed

  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • Nx Run Tasks

    nomcopter/react-mosaic

    Helps with running tasks in an Nx workspace. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 8 repos~613 tokens
    DevelopmentAuto-check passed

  • OpenHarness End-to-End Evals

    HKUDS/OpenHarness

    Validates OpenHarness features by running real multi-turn agent loops with live LLM calls against an unfamiliar codebase, checking actual tool execution.

    16k GitHub starsUsed in 1 repo~2.1k tokens
    Testing & QAAuto-check: notes

More from Soul-Brews-Studio/arra-oracle-skills-cli

All 31 skills in this repo

  • Dig

    Soul-Brews-Studio/arra-oracle-skills-cli

    Mine Claude Code sessions — timeline, gaps, repo attribution, session history.

    123 GitHub stars~1.8k tokensUpdated 8 days ago
    Auto-check passed

  • Forward

    Soul-Brews-Studio/arra-oracle-skills-cli

    Hand off the current session to the next one. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli.

    123 GitHub stars~2.9k tokensUpdated 8 days ago
    Auto-check passed

  • Project

    Soul-Brews-Studio/arra-oracle-skills-cli

    Clone and track external repos. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli.

    123 GitHub stars~1.4k tokensUpdated 8 days ago
    Auto-check passed

  • Round Table

    Soul-Brews-Studio/arra-oracle-skills-cli

    Convene a Round Table (โต๊ะกลม): 3–8 souls — persona files, Oracles, or real people's DNA — debate ONE stakes-bearing decision over exactly 4 rounds (OPEN, DEEPEN, CONVERGE, VOTE), one subagent per…

    123 GitHub stars~2.1k tokensUpdated 8 days ago
    Auto-check passed

  • Soul

    Soul-Brews-Studio/arra-oracle-skills-cli

    Bring an Oracle into the current repo — its soul, ALL its skills and its expertise — by link, never by copy.

    123 GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed

  • Trace

    Soul-Brews-Studio/arra-oracle-skills-cli

    Find projects, code, and knowledge across git history, repos, docs, and Oracle.

    123 GitHub stars~2.9k tokensUpdated 8 days ago
    Auto-check passed

Works with

Questions about Calver

What does Calver do?

Show or bump the project's CalVer version. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli. Calver is an agent skill from Soul-Brews-Studio/arra-oracle-skills-cli. Show or bump the project's CalVer version.

When should I use Calver?

Calver fits situations like: user says calver; set the skills version.

How do I install Calver in Claude Code?

Run `npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill calver -a claude-code`. Or copy the skill folder (src/skills/calver in Soul-Brews-Studio/arra-oracle-skills-cli) into .claude/skills/calver in your project. Claude Code loads it when a task matches its description.

How do I install Calver in Codex?

Run `npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill calver -a codex`. Or copy the skill folder (src/skills/calver in Soul-Brews-Studio/arra-oracle-skills-cli) into .agents/skills/calver in your project. Codex loads it when a task matches its description.

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

What does Calver need to run?

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

Does Calver access the network?

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

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

Calver is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Calver 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 Calver?

Skills that share tags, products or a category with Calver: Defuddle (kepano/obsidian-skills, 49k stars), Vercel Deploy (bytedance/deer-flow, 84k stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars) and MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Calver?

Soul-Brews-Studio (a GitHub organization) maintains it in Soul-Brews-Studio/arra-oracle-skills-cli, which has 123 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 3, 2026.

Source: Soul-Brews-Studio/arra-oracle-skills-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.