codevira: Skill for Claude Code

.claude/skills/release-readiness/SKILL.md

release-readiness is a skill for Claude Code from sachinshelke/codevira. It costs 96 tokens per session (2,095 once invoked), scanned A, original, MIT.

A release checklist for moving code from development to production or publishing it to PyPI, Python’s package repository. It requires evidence from five gates before allowing a release command.

In plain words
What is it for?
Use it when preparing a versioned release, uploading a Python package, creating a GitHub release, or promoting code to production.
Why use it?
It prevents code from being published before tests and other release checks have passed. It also blocks attempts to skip the required checks.

Skill for Claude Code

Written for Claude Code: PreToolUse hook event. Also seen: mentions Claude Code.

This is sachinshelke/codevira's own configuration. It tells Claude Code how to work on codevira itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything codevira configures →

Reuse

Borrowing it

Nothing to install: this file belongs to sachinshelke/codevira. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/sachinshelke/codevira/main/.claude/skills/release-readiness/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/sachinshelke/codevira

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for release-readiness

README.md
[![agentmods](https://agentmods.dev/badge/skills/sachinshelke/codevira/release-readiness/github.svg)](https://agentmods.dev/skills/sachinshelke/codevira/release-readiness)
Your own site
<a href="https://agentmods.dev/skills/sachinshelke/codevira/release-readiness"><img src="https://agentmods.dev/badge/skills/sachinshelke/codevira/release-readiness/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for release-readiness

Your own site · 80×15
<a href="https://agentmods.dev/skills/sachinshelke/codevira/release-readiness"><img src="https://agentmods.dev/badge/skills/sachinshelke/codevira/release-readiness.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 96 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,095 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00096 $0.02095
Opus 5.5 $0.00038 $0.00838
Sonnet 5.5 $0.00019 $0.00419
Haiku 4.5 $0.00010 $0.00210

Measured 1mo ago against content hash 1c0d17a99b9e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

release-readiness scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/release-readiness/SKILL.md · 230 lines

How it starts

The opening of the file, as written. The whole thing — 230 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Release readiness — the bypass-proof release gauntlet

v2.0.0 shipped to PyPI with 23 silent-failure bugs because nothing forced gauntlet-pass evidence before publish. This skill makes the gauntlet mandatory at the CONVERSATION layer (skills); the Makefile

  • hook + CI enforce it at the TOOL layer. Both must agree before any release proceeds.

When this skill triggers

Trigger phrases:

  • "ready to release"
  • "let's ship"
  • "publish to PyPI"
  • "promote to production"
  • "release X.Y.Z"
  • "cut a release"
  • "tag the version"
  • "ship it"
  • Any mention of twine upload, gh release create --draft=false, pipx publish, etc.

When this skill triggers, you MUST walk the 5-gate gauntlet below before producing any actual release command.

The 5 gates

Defined in codevira.discipline.yaml::release_gates. Each must pass.

G1 — Unit tests

make test-unit
# OR: pytest tests/ -q --ignore=tests/e2e

Pass criterion: exit code 0, no test failures or unexpected skips.

G2 — First-contact e2e

make test-e2e
# OR: pytest tests/e2e/test_first_contact.py -v

Pass criterion: all 4 fixtures pass (docs_only, code_only_python, polyglot, monorepo). This is the gate that catches bugs A–O. If G2 shows failures, those failures ARE the v2.1 work list — don't release until they're fixed.

G3 — Real-IDE smoke

scripts/check_real_ide_smoke.sh

Pass criterion: codevira appears connected in Claude Code AND Claude Desktop AND at least one other IDE. tools/list returns in <1s.

Today's state: the script is real and G3 has recorded true since 3.1.0. It was a stub before that, recording "skipped" — and this file used to say that was "tolerable for v2.0.x but BLOCKING for v2.1". It never became blocking. Six releases shipped with G3 unverified, because a sentence in a skill is not an enforcement point.

It is enforced now: pre-release-block.sh refuses any gate that is not true, with one stated exception (G4 may be "warn"). "skipped" blocks.

Read the full file on GitHub · 230 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed · +20 lines 1c0d17a99b9e
  2. 1mo ago First seen · 210 lines · 96 tokens per session scan A 84296714de63

Subscribe to this mod's changes

release-readiness is a skill published in the GitHub repository sachinshelke/codevira (12 stars, last pushed 1mo ago), licensed MIT. It adds 96 tokens to every session and 2,095 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

git-workflow-and-versioning

Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple…

addyosmani/agent-skills · 89 tokens

production-deployment

Zero-downtime deployments with pre-flight checks, staged rollouts, and rollback plans. Never ship to production without a verified rollback strategy.

DevelopersGlobal/ai-agent-skills · 32 tokens

shipping-and-launch

A production-release checklist and planning guide for putting software in front of real users. It covers testing, security, monitoring, staged rollout, and rollback, which means returning to the previous working version.

vinvcn/addyosmani-agent-skills-zh · 49 tokens

ci-cd-pipelines

Provides CI/CD pipeline structure, a GitHub Actions CI template, deployment gates, and an optimization checklist; use when designing GitHub Actions workflows, optimizing pipeline speed, or implementing deployment gates.

sawrus/agent-guides · 44 tokens

to-release

Prepare a library release on its PR (version, changelog, draft GitHub release) for review, then tag and publish it after you merge.

helderberto/agent-skills · 33 tokens

shipping-and-launch

Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.

borhen68/SkillEngine · 45 tokens