building-a-promotion-case
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.
Install / Use
npx skills add RefoundAI/lenny-skills --skill building-a-promotion-caseInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of building-a-promotion-case
building-a-promotion-case scores 80/100 on our quality scale, 1028th of 1,153 Content & Media skills we index.
Its SKILL.md is 6.0 KB long, well organised into 13 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,454 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-13 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
building-a-promotion-case compared with similar skills
All 4 of these similar skills score higher than building-a-promotion-case; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| building-a-promotion-case (this skill)by RefoundAI | 80 | 1.5k | 4mo ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install building-a-promotion-case?
- Run
npx skills add RefoundAI/lenny-skills --skill building-a-promotion-case. The install tabs above show the steps for each supported agent. - Which AI agents does building-a-promotion-case work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is building-a-promotion-case safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is building-a-promotion-case still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: 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
- Inventory Impact - Help users list their major wins and map them to specific business growth metrics or organizational goals.
- Gap Analysis - Compare current performance against both formal career ladders and unwritten behaviors rewarded at the company.
- Strategic Alignment - Guide the user in drafting a script for a 1:1 conversation to explicitly state their ambitions and align on a timeline.
- 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.
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
Related Skills
- Breaking Into Product
- Pm Career Growth
- Career Transitions
- Negotiating Compensation
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
