Agent skill

Vpe Review

by alirezarezvani in alirezarezvani/claude-skills

/cs:vpe-review <plan — Throughput-first VP of Engineering interrogation of any plan that touches delivery, eng hiring, team structure, or production discipline.

MITAuto-check passedDevOps & Cloud

Install Vpe Review

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill vpe-review -a claude-code

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

GitHub CLI
$ gh skill install alirezarezvani/claude-skills vpe-review --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/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/c-level-agents/skills/vpe-review .claude/skills/vpe-review && 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
vpe-review
GitHub stars
28k
Token cost
~1.2k tokens
SKILL.md length
396 words
Files
1
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

/cs:vpe-review <plan — Throughput-first VP of Engineering interrogation of any plan that touches delivery, eng hiring, team structure, or production discipline.

  • Works in 6 steps: What's the cycle time, and where does… → What's the DORA performance level on all… → Where is the hiring funnel leaking? → …
  • Cycle time balloons
  • SKILL.md covers When to Run, The Six VPE Questions, Workflow and Output Format, plus 2 more sections
  • Calls python

What it does

Vpe Review is an agent skill from alirezarezvani/claude-skills. /cs:vpe-review <plan — Throughput-first VP of Engineering interrogation of any plan that touches delivery, eng hiring, team structure, or production discipline. Use when cycle time balloons, DORA metrics slide, or before committing to an eng hiring wave or a reorg.

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 sits in DevOps & Cloud, covering Slides and decks. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • Cycle time balloons
  • DORA metrics slide
  • Before committing to an eng hiring wave

Example prompts

  • “/vpe-review”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. What's the cycle time, and where does work wait?
  2. What's the DORA performance level on all 4 metrics?
  3. Where is the hiring funnel leaking?
  4. Is the team structure healthy for the headcount?
  5. What's the production discipline maturity?
  6. Are we adding a VPE separately, or is CTO doing both?

What it can do on your machine

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

    • python

    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

Vpe Review loads about 1.2k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 396 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
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 alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 396 words, ~1,198 tokens.

Download SKILL.mdSave it as .claude/skills/vpe-review/SKILL.md (or your agent's skills folder).
name
vpe-review
description
/cs:vpe-review <plan> — Throughput-first VP of Engineering interrogation of any plan that touches delivery, eng hiring, team structure, or production discipline. Use when cycle time balloons, DORA metrics slide, or before committing to an eng hiring wave or a reorg.

/cs:vpe-review — VPE Forcing Questions

Command: /cs:vpe-review <plan>

The throughput-first VPE pressure-tests any plan touching eng operations. Six questions before any delivery commitment, eng hiring expansion, team restructure, or production-discipline change.

When to Run

  • Before quarterly delivery commitment (sprint planning, OKR review)
  • Before approving an eng hiring plan
  • Before restructuring eng teams (splitting/merging squads, adding tribes)
  • Before deciding whether to hire a VPE separately from CTO (or merge them)
  • When production incidents are increasing
  • When sprint velocity is dropping but everyone says "we're working hard"

The Six VPE Questions

1. What's the cycle time, and where does work wait?

No DORA, no diagnosis.

  • Lead Time for Changes is the single best health metric
  • If you can't decompose cycle time into stages, you can't fix the bottleneck
  • Run delivery_throughput_analyzer.py
2. What's the DORA performance level on all 4 metrics?

One Elite metric and three Lows = bad. Four Highs = healthy.

  • Deployment Frequency, Lead Time, MTTR, Change Failure Rate
  • The worst metric defines overall level
  • Fix lead time first; everything else follows
3. Where is the hiring funnel leaking?

"Can't find good engineers" is wrong.

  • Specific stage is over-filtering OR top-of-funnel volume is too low OR offer-to-accept is broken
  • Run eng_hiring_funnel_calculator.py
  • If offer-to-accept < 70%, comp is below market or close discipline is weak
4. Is the team structure healthy for the headcount?

5-9 ICs per squad; 5-8 ICs per EM; 4-6 EMs per director.

  • Run eng_team_structure_designer.py
  • Manager-trigger fires when 5+ ICs have no dedicated EM
  • Director-trigger fires when 3+ EMs report directly to VPE/CTO
Show full SKILL.md (146 more words)Show less
5. What's the production discipline maturity?

Level 1-5; aim for Level 3 at growth stage.

  • On-call rotation ≥ 6 people
  • Severity-defined incident response with blameless postmortems
  • SLOs on customer-facing services (pair with engineering/slo-architect/)
  • Continuous deployment OR scheduled — not "usually one, sometimes the other"
6. Are we adding a VPE separately, or is CTO doing both?

If CTO is spending > 50% on management vs strategy, VPE is needed.

  • Or: VPE complement when CTO is co-founder more comfortable with strategy
  • VPE owns operating model; CTO owns architecture
  • At small scale (< 20 eng), one person can do both

Workflow

bash
# 1. Delivery throughput
python ../../../c-level-advisor/skills/vpe-advisor/scripts/delivery_throughput_analyzer.py sprint_metrics.json

# 2. Hiring funnel
python ../../../c-level-advisor/skills/vpe-advisor/scripts/eng_hiring_funnel_calculator.py funnel.json

# 3. Team structure
python ../../../c-level-advisor/skills/vpe-advisor/scripts/eng_team_structure_designer.py team.json

Output Format

markdown
# VPE Review: <plan>
**Date:** YYYY-MM-DD

## The Decision Being Made
[throughput | hiring | structure | production | VPE-vs-CTO]

## Delivery Throughput (if applicable)
- DORA overall: Elite / High / Medium / Low
- Worst metric: <DF | LT | MTTR | FR>
- Bottleneck: <stage> (X% of cycle time)
- Top fix: <action + owner>

## Hiring Funnel (if applicable)
- End-to-end conversion: X%
- Weakest stage: <stage>
- Pipeline gap: +N candidates needed
- Top fix: <specific action>

## Team Structure (if applicable)
- Recommended: <informal pods / squads / tribes>
- Manager trigger fired: yes/no
- Director trigger fired: yes/no
- Action: <hire EM | hire director | split squad>

## Production Discipline (if applicable)
- Current maturity level: 1-5
- Next practice to add: <specific>
- SLO coverage: X / Y services

## Verdict
🟢 SHIP | 🟡 SHARPEN | 🔴 BLOCK

## Next Steps
[3 concrete actions]

Routing

  • /cs:cto-review — for architectural causes of throughput problems
  • cs-chro-advisor agent — for hiring funnel comp/leveling issues
  • /cs:cfo-review — for cost-per-hire envelope and eng budget
  • /cs:ciso-review — for production discipline + compliance overlap
  • /cs:decide — log the verdict
  • /cs:freeze 30 — on multi-year hiring commitments
  • Agent: cs-vpe-advisor
  • Skill: vpe-advisor
  • Adjacent: ../../../engineering/slo-architect/, ../../../engineering/feature-flags-architect/, ../../../engineering/chaos-engineering/

Version: 1.0.0

© alirezarezvani, 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 c-level-agents/skills/vpe-review of alirezarezvani/claude-skills.

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Vpe Review 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.

Vpe Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vpe Review this skillalirezarezvani/claude-skills28k—~1.2kAutomated safety check: PassMIT
Deploymaxwell2732/paper-replicate-agent-demo1371 repos~371Automated safety check: NotesNone
Magic MouthHmbown/Wizards-of-the-Ghosts110—~836Automated safety check: PassCC0-1.0
Investment Deck Checkginlix-ai/LangAlpha1.8k—~3.7kAutomated safety check: PassApache-2.0
Observal AdvancedObserval/Observal4.3k—~604Automated safety check: PassApache-2.0
Storyline Buildersruthir28/enterprise-ai-skills1481 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Deploy

    maxwell2732/paper-replicate-agent-demo

    Render Quarto slides and sync to docs/ for GitHub Pages deployment.

    137 GitHub starsUsed in 1 repo~371 tokens
    Documents & OfficeAuto-check: notes
  • Magic Mouth

    Hmbown/Wizards-of-the-Ghosts

    Magic Mouth is trigger → message. An agent skill from Hmbown/Wizards-of-the-Ghosts.

    110 GitHub stars~836 tokensUpdated 6 mo ago
    Backend & APIsAuto-check passed
  • Investment Deck Check

    ginlix-ai/LangAlpha

    Quality-checks an investment deck in .pptx form before it goes out: number consistency, chart and narrative alignment, source coverage, language and a circulation verdict.

    1.8k GitHub stars~3.7k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Observal Advanced

    Observal/Observal

    Recovers Observal session ingestion, manages CLI upgrades, downgrades and rollback, and performs explicit local Agent fallback when the server is unavailable.

    4.3k GitHub stars~604 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Storyline Builder

    sruthir28/enterprise-ai-skills

    McKinsey-style storyline framework for building presentation decks.

    148 GitHub starsUsed in 1 repo~1.9k tokens
    Business, Finance & HRAuto-check passed
  • Trade Performance Coach

    tradermonty/claude-trading-skills

    Review closed trades, partial exits, and monthly trade aggregates for process adherence, risk discipline, execution quality, and evidence-based trading behavior patterns.

    3k GitHub starsUsed in 1 repo~2.4k tokens
    DevOps & CloudAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Vpe Review

What does Vpe Review do?

/cs:vpe-review <plan — Throughput-first VP of Engineering interrogation of any plan that touches delivery, eng hiring, team structure, or production discipline. Vpe Review is an agent skill from alirezarezvani/claude-skills. /cs:vpe-review <plan — Throughput-first VP of Engineering interrogation of any plan that touches delivery, eng hiring, team structure, or production discipline.

When should I use Vpe Review?

Vpe Review fits situations like: cycle time balloons; DORA metrics slide; before committing to an eng hiring wave.

How do I install Vpe Review in Claude Code?

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

How do I install Vpe Review in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill vpe-review -a codex`. Or copy the skill folder (c-level-agents/skills/vpe-review in alirezarezvani/claude-skills) into .agents/skills/vpe-review in your project. Codex loads it when a task matches its description.

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

What does Vpe Review need to run?

Going by SKILL.md and its folder, Vpe Review needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Vpe Review 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 Vpe Review 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 Vpe Review use?

Vpe Review 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 Vpe Review use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Vpe Review?

Skills that share tags, products or a category with Vpe Review: Deploy (maxwell2732/paper-replicate-agent-demo, 137 stars), Magic Mouth (Hmbown/Wizards-of-the-Ghosts, 110 stars), Investment Deck Check (ginlix-ai/LangAlpha, 1.8k stars) and Observal Advanced (Observal/Observal, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vpe Review?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,938 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

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