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

Building A Promotion Case

by RefoundAI in RefoundAI/lenny-skills

Help users systematically document their impact, identify skill gaps, and collaborate with their managers to secure a promotion by proving they are already operating at the next level.

MITAuto-check passed

Install Building A Promotion Case

skills CLI
$ npx skills add RefoundAI/lenny-skills --skill building-a-promotion-case -a claude-code

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

GitHub CLI
$ gh skill install RefoundAI/lenny-skills building-a-promotion-case --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/RefoundAI/lenny-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/building-a-promotion-case .claude/skills/building-a-promotion-case && 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
building-a-promotion-case
GitHub stars
1.4k
Token cost
~1.5k tokens
SKILL.md length
888 words
Files
3 (incl. references)
Skills in repo
76
Repo updated
First seen
Licence
MIT

At a glance

Help users systematically document their impact, identify skill gaps, and collaborate with their managers to secure a promotion by proving they are already operating at the next level.

  • Works in 4 steps: Inventory Impact - Help users list their… → Gap Analysis - Compare current… → Strategic Alignment - Guide the user in… → …
  • SKILL.md covers How to Help, Core Principles, Templates & Frameworks and Questions to Help Users, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Building A Promotion Case is an agent skill from RefoundAI/lenny-skills. Help users systematically document their impact, identify skill gaps, and collaborate with their managers to secure a promotion by proving they are already operating at the next level.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/artifacts.md` and `references/guest-insights.md`).

The repository describes itself as: 86 product management skills from Lenny's Podcast for Claude Code and AI agents. Hiring, user research, strategy, shipping, and more. The licence is MIT.

Example prompts

  • “/building-a-promotion-case”

Workflow steps

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

  1. Inventory Impact - Help users list their major wins and map them to specific business growth metrics or organizational goals.
  2. Gap Analysis - Compare current performance against both formal career ladders and unwritten behaviors rewarded at the company.
  3. Strategic Alignment - Guide the user in drafting a script for a 1:1 conversation to explicitly state their ambitions and align on a…
  4. Package the Proof - Assist in organizing screenshots, metrics, and testimonials into a structured document that champions can use in…

What it can do on your machine

Read from SKILL.md and the folder at commit 13598cc. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Building A Promotion Case loads about 1.5k tokens when it runs, and up to ~7.5k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 888 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.5k

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 RefoundAI/lenny-skills at commit 13598cc, republished under its MIT licence (© RefoundAI). 888 words, ~1,537 tokens.

Download SKILL.mdSave it as .claude/skills/building-a-promotion-case/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
building-a-promotion-case
description
Help users systematically document their impact, identify skill gaps, and collaborate with their managers to secure a promotion by proving they are already operating at the next level.

Building a Promotion Case

Turn your professional impact into a compelling, data-backed argument for your next career move.

Help the user with building a promotion case using insights from 6 guests and posts across Lenny's Podcast and Newsletter.

How to Help

  1. Inventory Impact - Help users list their major wins and map them to specific business growth metrics or organizational goals.
  2. Gap Analysis - Compare current performance against both formal career ladders and unwritten behaviors rewarded at the company.
  3. Strategic Alignment - Guide the user in drafting a script for a 1:1 conversation to explicitly state their ambitions and align on a timeline.
  4. Package the Proof - Assist in organizing screenshots, metrics, and testimonials into a structured document that champions can use in calibration.

Core Principles

Perform the Role Before You Have It

From "How to get promoted": "People don’t get promoted for doing their jobs really well. They get promoted by demonstrating their potential to do more. At many companies, you get promoted only after you’ve demonstrated you can handle the next level."

The most effective way to prove readiness is to proactively take on the scope and responsibilities of the target role before the official title change.

State Your Ambitions Explicitly

From "How to get promoted": "When was the last time you told your manager you’d love to get promoted? It may seem obvious to you, but they may not know how important this is to you. Bring it up at your next 1:1 and see what happens."

Managers are not mind readers: you must clearly communicate your desire for promotion so it can be factored into organizational planning.

Capture Proof in Real-Time

From "How to be prepared for layoffs": "Go open up a new doc and start dumping a list of times you’ve made an impact at your current job. Include metrics, screenshots, timelines, stories—anything that’ll help you tell the story of your successes."

Maintain a running document of specific metrics, timelines, and screenshots while the data is fresh and accessible to avoid scrambling during review season.

Decode Rewarded Behaviors

From "How to get promoted": "Explicitly or implicitly, every company prioritizes different skills and behaviors. If you pay attention to who gets promoted, you can start to see what actually matters at your company."

Analyze the skills and impact of colleagues who were recently promoted to understand the unwritten criteria that the company actually values.

Address Specific Behavioral Gaps

From "How to get promoted": "No matter your role or level, there’s a skill or behavior that is keeping you from the next level. To get promoted, you’ll need to demonstrate that you’ve addressed that gap, in the eyes of both your manager and other influential leaders involved in the promotion process."

Work with your manager to identify the exact 2 to 3 behaviors holding you back and create a measurable action plan to close them.

Show full SKILL.md (410 more words)Show less

Templates & Frameworks

  • Brag Document / Accomplishments Log (How to be prepared for layoffs) - A framework for systematically documenting your work accomplishments to use in future interviews and resume building
  • Career Gap Action Plan Spreadsheet (How to get promoted) - A shared spreadsheet template for tracking skill gaps and concrete actions between you and your manager, with color-coded status tracking
  • 5-Step Process to Address Skill Gaps (How to get promoted) - A structured 5-step process for identifying and closing the gaps keeping you from promotion
  • Give Your Champion Ammo (How to get promoted) - Five ways to help your manager and champions advocate for you in the promotion calibration process
  • Wins Folder/Document (How to get promoted) - A running document or folder where you track your wins and impact over time, to be used when building your promotion case
  • Career Growth Conversation Script (Jackie Bavaro) - A non-threatening script to ask your manager for promotion requirements and targeted feedback.
  • 7 Strategies for Getting Promoted (How to get promoted) - A comprehensive framework of seven strategies to increase your chances of getting promoted, applicable to any role
  • Promotion Readiness Checklist for PMs (Shweta Shriva) - A set of principles for PMs seeking career advancement, focusing on impact-driven behavior rather than promotion-seeking optimization.

See references/artifacts.md for the full list with details.

Questions to Help Users

  • "What are the three biggest business outcomes you have delivered in the last six months?"
  • "How does your current scope of work overlap with the responsibilities of the level you are aiming for?"
  • "What specific skills or behaviors has your manager identified as 'gaps' for the next level?"
  • "Who are the key stakeholders who would advocate for your promotion during a calibration meeting?"
  • "If you were to leave today, what unique value or 'wins' would be most difficult for the team to replace?"

Common Mistakes to Flag

  • The 'Silent Worker' Trap - Assuming that high performance alone is enough without explicitly communicating your career goals and advocating for yourself.
  • Waiting for Review Cycles - Starting the promotion conversation during the review is often too late: calibration typically happens weeks or months in advance.
  • Focusing Only on Tasks - Emphasizing your to-do list instead of the business outcomes and strategic impact those tasks created.
  • Treating Promotion as a Demand - Approaching the conversation as a series of requirements rather than a collaborative problem-solving exercise with your manager.

Deep Dive

For all 11 sourced insights from 6 guests, see references/guest-insights.md

  • Breaking Into Product
  • Pm Career Growth
  • Career Transitions
  • Negotiating Compensation

© RefoundAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/building-a-promotion-case of RefoundAI/lenny-skills.

  • SKILL.md
  • references/artifacts.md
  • references/guest-insights.md

Open the folder on GitHubat commit 13598cc

Compare with similar skills

Building A Promotion Case 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.

Building A Promotion Case compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Building A Promotion Case this skillRefoundAI/lenny-skills1.4k—~1.5kAutomated safety check: PassMIT
Gapsanthropics/claude-for-legal9.6k2 repos~229Automated safety check: PassApache-2.0
Promotealirezarezvani/claude-skills28k1 repos~1.1kAutomated safety check: PassMIT
Case Reviewsickn33/agentic-awesome-skills47k1 repos~1.6kAutomated safety check: PassMIT
Skill Gap Analysissickn33/agentic-awesome-skills47k1 repos~3.6kAutomated safety check: PassMIT
Checkpoint Promotionwshobson/agents40k—~2kAutomated safety check: PassMIT

Similar skills

  • Gaps

    anthropics/claude-for-legal

    Official

    Open gaps tracker — what's flagged and not yet closed. An agent skill from anthropics/claude-for-legal.

    9.6k GitHub starsUsed in 2 repos~229 tokens
    Auto-check passed

  • Promote

    alirezarezvani/claude-skills

    Graduate a proven pattern from auto-memory (MEMORY.md) to CLAUDE.md or .claude/rules/ for permanent enforcement.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    Agent WorkflowsAuto-check passed

  • Case Review

    sickn33/agentic-awesome-skills

    Quality-gate review of a reverse-engineering or assessment case package: scope readiness, Evidence-to-Finding-to-Path traceability, work-item coverage, timeline consistency, and artifact hashes.

    47k GitHub starsUsed in 1 repo~1.6k tokens
    SecurityAuto-check passed

  • Skill Gap Analysis

    sickn33/agentic-awesome-skills

    Skill gap register: employee, skill area, current against required level, gap severity and recommended training.

    47k GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check passed

  • Checkpoint Promotion

    wshobson/agents

    Gate fine-tuned checkpoints with drift budgets, paired comparison, and forgetting checks before promotion.

    40k GitHub stars~2k tokensUpdated 5 days ago
    Agent WorkflowsAuto-check passed

  • Case Review

    zhaoxuya520/reverse-skill

    Reviews a reverse-skill case package for scope readiness, Evidence to Finding to Path traceability, work item coverage, timeline references, and optional artifact hash integrity before report handoff.

    41k GitHub starsUsed in 1 repo~1.6k tokens
    SecurityAuto-check: warnings

More from RefoundAI/lenny-skills

All 76 skills in this repo

  • Customer Interviews

    RefoundAI/lenny-skills

    Help users conduct high-impact customer interviews that move beyond surface-level feature requests to identify root emotional frustrations and specific causal triggers.

    1.4k GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed

  • Time Energy Management

    RefoundAI/lenny-skills

    Help users master their personal output by shifting from reactive scheduling to intentional energy management, internal trigger mastery, and proactive boundary setting.

    1.4k GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed

  • User Onboarding Activation

    RefoundAI/lenny-skills

    Help users reach their first moment of core value by optimizing the first-run experience, removing friction, and aligning product design with psychological triggers.

    1.4k GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed

  • Acquisition Channels

    RefoundAI/lenny-skills

    Help users identify unique distribution advantages and master the lifecycle of acquisition channels to build a sustainable engine for growth and retention.

    1.4k GitHub stars~2.2k tokensUpdated 2 mo ago
    Auto-check passed

  • AI Assisted Prototyping

    RefoundAI/lenny-skills

    Help users build functional product prototypes from natural language or visual mocks using AI coding tools.

    1.4k GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

  • AI Evals

    RefoundAI/lenny-skills

    Help users build robust infrastructure for measuring, monitoring, and iterating on AI product performance using human, code-based, and LLM-as-a-judge methodologies.

    1.4k GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Building A Promotion Case

What does Building A Promotion Case do?

Help users systematically document their impact, identify skill gaps, and collaborate with their managers to secure a promotion by proving they are already operating at the next level. Building A Promotion Case is an agent skill from RefoundAI/lenny-skills. Help users systematically document their impact, identify skill gaps, and collaborate with their managers to secure a promotion by proving they are already operating at the next level.

How do I install Building A Promotion Case in Claude Code?

Run `npx skills add RefoundAI/lenny-skills --skill building-a-promotion-case -a claude-code`. Or copy the skill folder (skills/building-a-promotion-case in RefoundAI/lenny-skills) into .claude/skills/building-a-promotion-case in your project. Claude Code loads it when a task matches its description.

How do I install Building A Promotion Case in Codex?

Run `npx skills add RefoundAI/lenny-skills --skill building-a-promotion-case -a codex`. Or copy the skill folder (skills/building-a-promotion-case in RefoundAI/lenny-skills) into .agents/skills/building-a-promotion-case in your project. Codex loads it when a task matches its description.

Can I use Building A Promotion Case 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 RefoundAI/lenny-skills --skill building-a-promotion-case -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/building-a-promotion-case, .gemini/skills/building-a-promotion-case, .github/skills/building-a-promotion-case and .opencode/skills/building-a-promotion-case in your project.

What does Building A Promotion Case need to run?

SKILL.md names no scripts, command-line tools or credentials: Building A Promotion Case is instructions for the agent only.

Does Building A Promotion Case 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 Building A Promotion Case 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 Building A Promotion Case use?

Building A Promotion Case 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 Building A Promotion Case use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.9k tokens, read only when the agent opens those files.

What are the alternatives to Building A Promotion Case?

Skills that share tags, products or a category with Building A Promotion Case: Gaps (anthropics/claude-for-legal, 9.6k stars), Promote (alirezarezvani/claude-skills, 28k stars), Case Review (sickn33/agentic-awesome-skills, 47k stars) and Skill Gap Analysis (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Building A Promotion Case?

RefoundAI (a GitHub organization) maintains it in RefoundAI/lenny-skills, which has 1,382 GitHub stars. The repository holds 76 skills in this directory. The repository was last updated on July 16, 2026.

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