vpe-advisor

Diagnose engineering delivery throughput, hiring funnel leakage, and team structure using DORA metrics.

25.3k|3.6k|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/alirezarezvani/claude-skills --skill vpe-advisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vpe-advisor
Source: https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/vpe-advisor/skills/vpe-advisor
Command: npx skills add https://github.com/alirezarezvani/claude-skills --skill vpe-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Startup VPEs and founders acting as engineering leaders lack a structured way to answer four recurring questions: is the team shipping fast enough, why is hiring stalled, how should the team be organized, and is production discipline sound. This Skill turns those questions into measurable diagnostics with concrete fixes.

Core Features & Use Cases

  • Delivery Throughput Analysis: Computes DORA 4 metrics (deployment frequency, lead time, MTTR, change failure rate), identifies the longest cycle-time bottleneck, and recommends targeted fixes.
  • Hiring Funnel Diagnosis: Calculates per-stage conversion rates against healthy benchmarks, computes pipeline gap for a hiring target, and flags the weakest stage with fixes.
  • Team Structure Design: Recommends squad/tribe/chapter structure by headcount, fires manager and director hiring triggers, and checks squad sizing against the 5-9 IC range.
  • Use Case: A 25-engineer startup with slipping sprint velocity runs the throughput analyzer on sprint metrics, discovers PR review wait is 46% of cycle time, and implements a reviewer rotation with a 24-hour SLA.

Quick Start

Ask the advisor to analyze your engineering team's delivery throughput and hiring funnel using your sprint metrics and ATS funnel data.

Frequently Asked Questions about vpe-advisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I measure engineering team performance with DORA metrics?

Track the four DORA metrics: deployment frequency, lead time for changes, mean time to recovery, and change failure rate. Run delivery_throughput_analyzer.py with your sprint metrics JSON to get a performance level per metric plus the top cycle-time bottleneck.

How to diagnose why engineering hiring is slow?

Break the funnel into stages from applied to offer accepted and compute conversion at each step. The funnel calculator compares each stage against healthy benchmarks, identifies the leakiest transition, and computes how many top-of-funnel candidates you need to hit your hiring target.

When should a startup hire its first engineering manager?

Hire or promote the first EM when you have 5-7 ICs without a dedicated manager, since founders cannot sustain 1:1s, reviews, and hiring beyond that. Add a director once 3 or more EMs report directly to the CTO or VPE.

What is the difference between a VPE and a CTO?

The CTO owns what to build: architecture, scaling cliffs, and build-vs-buy decisions. The VPE owns how to ship it: delivery throughput, hiring execution, team structure, and production operations. Early-stage startups often combine both roles in one person.

What are the limitations of DORA metrics?

DORA metrics measure the team, not individual engineers, and using them for performance reviews causes gaming. They also diagnose where work waits but do not prescribe specific CI/CD tooling or fix implementation details.