# Promotion Preparation > Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement. Use when this capability is needed. - Skill: `tomevault-io/promotion-preparation` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/promotion-preparation` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/promotion-preparation/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/promotion-preparation --- # Promotion Preparation This skill provides frameworks for building compelling promotion cases, maintaining brag documents, tracking accomplishments, and effectively advocating for your career advancement. ## Keywords promotion, brag document, promotion case, self-advocacy, wins, accomplishments, impact, career advancement, tracking wins, promotion document, manager alignment, performance review, evidence-based promotion ## When to Use This Skill - Building a promotion case document - Starting or maintaining a brag document - Tracking and categorizing accomplishments - Preparing for performance reviews - Understanding what managers look for - Learning to advocate for yourself - Documenting impact and contributions ## Core Principle: You Own Your Promotion **Critical insight:** Promotions are not handed out - they are earned and advocated for. Your manager: - Cannot remember all your accomplishments - Has limited time to build your case - Needs your help to advocate for you - Wants you to succeed but needs evidence **Your responsibility:** - Track your own wins consistently - Build your promotion case proactively - Communicate impact clearly - Align with manager on expectations - Make it easy for your manager to promote you ## The Promotion Case Document A promotion case document is your comprehensive argument for advancement. It serves multiple purposes: - Provides evidence for promotion discussions - Helps your manager advocate for you - Forces you to articulate your impact - Identifies gaps you can address ### Three-Section Structure #### 1. Accomplishments & Impact (What You've Done) Document specific achievements with measurable outcomes: - Projects delivered and their business impact - Problems solved and value created - Technical contributions and innovations - Process improvements and efficiency gains #### 2. Growth & Learning (How You've Developed) Show trajectory and development: - Skills acquired or deepened - Challenges overcome - Feedback incorporated - Areas of improvement demonstrated #### 3. Future Focus (What You'll Do Next) Demonstrate readiness for next level: - Goals aligned to next-level expectations - Larger scope you're ready to take on - Development areas you're addressing - Vision for your expanded role ## Brag Document Fundamentals A brag document (also called "work log" or "wins journal") is your ongoing record of accomplishments. ### Why Keep a Brag Document? - **Memory is unreliable:** You forget 80% of what you did by review time - **Recency bias:** Recent work overshadows earlier achievements - **Cumulative impact:** Small wins add up to significant patterns - **Confidence building:** Reviewing wins combats imposter syndrome - **Interview prep:** Ready-made STAR stories for future opportunities ### Cadence | Frequency | Activity | | --------- | -------- | | Weekly | Quick bullet points of wins (5-10 min) | | Monthly | Review and expand bullets, add context | | Quarterly | Synthesize themes, identify patterns | | Annually | Build promotion case from accumulated evidence | ### What to Capture For each win, capture: - **What:** The specific accomplishment - **How:** Your approach and actions - **Impact:** Measurable outcomes (quantify when possible) - **Skills:** What this demonstrates - **Category:** Type of contribution (see Win Categorization) ## Win Categorization Not all wins are created equal. Categorize to show breadth: ### Impact Types | Type | Description | Example | | ---- | ----------- | ------- | | **Delivery** | Shipped features, projects, products | "Launched payment v2, processing $2M/day" | | **Quality** | Improved reliability, reduced bugs | "Reduced error rate from 2% to 0.1%" | | **Efficiency** | Faster, cheaper, better processes | "Cut deploy time from 2 hours to 15 min" | | **Innovation** | New approaches, creative solutions | "Introduced caching strategy saving $50K/year" | | **Leadership** | Mentoring, leading, enabling others | "Mentored 2 engineers to senior level" | | **Collaboration** | Cross-team work, partnerships | "Led joint initiative with 3 teams" | ### Scope Levels | Scope | Description | Next Level Signal | | ----- | ----------- | ----------------- | | **Individual** | Your personal contribution | Expected at current level | | **Team** | Improved your team's outcomes | Mid → Senior | | **Multi-team** | Impact across multiple teams | Senior → Staff | | **Org-wide** | Shaped organizational outcomes | Staff → Principal | ## Self-Advocacy Skills ### Making Your Work Visible Visibility is not self-promotion - it's professional communication: 1. **Status updates:** Regular, concise updates on progress 2. **Demo your work:** Present at team meetings, tech talks 3. **Document decisions:** Write design docs, ADRs, post-mortems 4. **Share learnings:** Blog posts, knowledge sharing sessions 5. **Volunteer for visibility:** All-hands demos, cross-team presentations ### Articulating Impact **Weak:** "I worked on the new API" **Strong:** "I designed and implemented the new payments API, which reduced integration time from 2 weeks to 2 days and enabled 3 new partner integrations in Q3" **Formula:** Action + Specifics + Measurable Outcome ### Working with Your Manager 1. **Align on expectations:** What does next level look like specifically? 2. **Share your goals:** Make your promotion aspirations known 3. **Regular check-ins:** Use 1:1s to discuss progress 4. **Ask for feedback:** What gaps exist? What would make the case stronger? 5. **Request opportunities:** Ask for stretch assignments aligned to next level ## Common Mistakes ### In Tracking Wins - **Waiting too long:** Weekly tracking beats quarterly scrambles - **Being too modest:** Document everything, filter later - **Only big wins:** Small wins show consistency - **Skipping context:** Future-you won't remember details - **No quantification:** Numbers make impact concrete ### In Building the Case - **Too generic:** "I'm a good team player" vs specific examples - **Missing business impact:** Technical achievements without business context - **No growth narrative:** List of tasks vs story of development - **Ignoring gaps:** Pretending weaknesses don't exist vs addressing them - **Going alone:** Not aligning with manager throughout ### In Self-Advocacy - **Assuming merit is enough:** Great work must be visible - **Waiting to be noticed:** Proactive communication is expected - **Over-advocating:** Balance confidence with humility - **Wrong audience:** Tailor message to stakeholders - **Timing:** Don't wait until review time to start ## Manager's Perspective Understanding how managers view promotions helps you prepare effectively: **What managers need:** - Clear evidence to present to their managers - Confidence that you'll succeed at next level - Reduced risk of "promoting too early" - Peer-level support for the promotion **What makes promotion easy:** - Well-documented accomplishments with impact - Already operating at next level - No significant concerns or gaps - Clear narrative they can tell **What makes promotion hard:** - Vague contributions hard to articulate - Gaps in critical competencies - Inconsistent performance - Lack of peer support or visibility ## Building Your Promotion Timeline ### 6 Months Before Review - Start or refresh brag document - Align with manager on promotion goals - Identify gaps and create development plan - Seek stretch assignments ### 3 Months Before Review - Begin drafting promotion case - Review against next-level expectations - Gather supporting evidence (docs, metrics) - Get feedback on draft from manager ### 1 Month Before Review - Finalize promotion document - Ensure manager has everything needed - Prepare talking points - Document recent wins ### At Review Time - Be prepared to discuss your case - Listen to feedback openly - If not promoted, understand gaps and plan - Continue tracking for next cycle ## References For detailed guidance, see: - `references/promotion-case-structure.md` - Complete promotion document template with examples - `references/brag-document-guide.md` - Weekly/monthly tracking templates and tips - `references/win-categorization.md` - Multi-dimensional win classification framework - `references/manager-perspective.md` - What managers look for, how to align ## Related Skills - `career-strategy` - Level expectations, progression paths, and career planning - `career-strategy` - Internal vs external growth decisions - `interview-skills` - Using accomplishments in interviews ## Related Commands - `/soft-skills:promotion-preparation` - Generate a structured promotion case document - `/soft-skills:track-win` - Document an accomplishment in brag document format ## User-Facing Interface When invoked directly by the user, this skill supports two workflows: building a promotion case and assessing career readiness. ### Build Promotion Case Workflow When invoked with role arguments (e.g., ` [achievements...]`): 1. **Parse Arguments** - Extract current role, target role, and any key achievements listed. 2. **Gather Context** - If achievements are sparse, ask probing questions about projects delivered, business impact, leadership activities, and growth trajectory. 3. **Load Level Expectations** - Reference `career-strategy` skill for target level competency expectations. 4. **Structure Promotion Case** - Generate a three-section promotion document: - **Accomplishments & Impact** - Specific achievements with quantified outcomes - **Growth & Learning** - Skills developed, challenges overcome, feedback incorporated - **Future Focus** - Goals aligned to next-level expectations, expanded scope readiness 5. **Identify Gaps** - Highlight areas where the case could be strengthened with more evidence or development. 6. **Save Results** - Offer to save the promotion case document. ### Assess Readiness Workflow When invoked with assessment intent (e.g., `promotion`, `job-change`, `level `): 1. **Parse Arguments** - Determine assessment type (promotion readiness, job change readiness, or level assessment). 2. **Gather Self-Assessment Data** - Ask structured questions about current contributions, scope of impact, competency demonstration, and visibility. 3. **Evaluate Against Framework** - Score readiness across competency categories (Technical, Design, Operations, Product, Leadership, Communication). 4. **Generate Readiness Report** - Produce assessment with: - Overall readiness score and recommendation - Strength areas with evidence - Gap areas with specific development actions - Suggested timeline and next steps 5. **Recommend Actions** - Prioritized list of actions to close gaps before pursuing advancement. ## Version History - **v1.0.0** (2025-12-26): Initial release --- ## Last Updated **Date:** 2025-12-26 **Model:** claude-opus-4-5-20251101 --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/melodic-software) — claim your Tome and manage your conversions.