Back to catalog

job-fit-analysis

Analyze fit between job requirements and background using lexicons - identifies gaps, develops reframing strategies, creates cover letter plan

  • Category: discovered
  • Tags: github, community
  • Version: 1.0.0
  • Author: walid
  • Downloads: 0
  • Updated: 2025-11-22

Download the latest version (v1.0.0) from this page.

SKILL.md

---
name: job-fit-analysis
description: Analyze fit between job requirements and background using lexicons - identifies gaps, develops reframing strategies, creates cover letter plan
---

# Job Fit Analysis

## Overview

Analyze fit between job requirements and your background using career lexicons. Identifies strengths, gaps, and develops strategic reframing approaches. Creates detailed cover letter plan grounded in authentic experience.

**Core principle:** Trust the job analysis output - don't re-parse requirements. Focus on gap identification and strategic positioning.

**Announce at start:** "I'm analyzing your fit for this role by comparing the job requirements with your career lexicons to identify strengths, gaps, and opportunities for strategic positioning."

## When to Use

**Standalone:**
- "Analyze my fit for this role"
- "What are my gaps for this position?"
- "Help me plan my cover letter"

**As follow-up to:**
- Job description analysis (need requirements first)
- Resume alignment (understand competitive position)

## Lexicon Integration

**Reads:**
- ✅ `~/career-applications/[job-slug]/01-job-analysis.md` (requirements)
- ✅ `~/lexicons_llm/01_career_philosophy.md` (values)
- ✅ `~/lexicons_llm/02_achievement_library.md` (experience)

**Outputs:**
- Gap analysis with ✅/⚠️/❌ symbols
- Reframing strategies for partial matches
- Cover letter strategic plan
- Evidence trail linking recommendations to lexicons

## Configuration

**Default paths (user can override):**
```python
LEXICONS_DIR = "~/lexicons_llm/"
APPLICATIONS_DIR = "~/career-applications/"
OUTPUT_FILE_PATTERN = "{job-slug}/03-gap-analysis-and-cover-letter-plan.md"
```

## Workflow

### Phase 0: Lexicon Loading

**Required files:**

1. Read: `~/career-applications/[job-slug]/01-job-analysis.md`
   - If missing: "I need a job analysis first. Should I analyze the job description now?"

2. Read: `~/lexicons_llm/01_career_philosophy.md` → store as context
   - If missing: "I need your career lexicons. Run: python run_llm_analysis.py"

3. Read: `~/lexicons_llm/02_achievement_library.md` → store as context

**Important:** Trust the job analysis - don't re-parse the job description. Use the structured analysis directly.

**Verification:** Confirm all files loaded successfully before proceeding

### Phase 1: Load & Review

**Actions:**
- Display job analysis summary (key requirements by priority)
- Review relevant lexicon sections
- Identify potentially matching categories
- Confirm understanding with user

**User Communication:**
```
I've loaded:
- Job analysis for [Job Title] at [Company]
- Your career philosophy ([N] leadership approaches, [N] core values)
- Your achievement library ([N] major categories, [N] key achievements)

Key Job Requirements (from analysis):
1. [Requirement 1] - Priority: HIGH
2. [Requirement 2] - Priority: HIGH
3. [Requirement 3] - Priority: MEDIUM

Relevant sections of your achievement library:
- Section II.A: Capital Projects (3 achievements)
- Section III.A: Revenue Generation (2 achievements)
- Section IV: Academic Leadership (4 achievements)

Ready to analyze your fit and identify opportunities for strategic positioning.
```

### Phase 2: Gap Analysis (Direct Comparison)

**For each requirement category from job analysis:**

Compare job requirements against lexicon achievements using direct matching:

**Output Format:**
```markdown
## Fit Analysis: Section II - Experience & Achievement Requirements

### Capital Projects & Infrastructure
JD Requirement: "$10M+ budget experience, adaptive reuse preferred"
Priority: HIGH (mentioned 7x, specific budget minimums)

Your Achievement Library:
✅ STRONG MATCH: Kirk Douglas Theater
   - $12.1M budget (exceeds requirement)
   - Adaptive reuse project (exact match)
   - 4 variations available for different emphases
   - Source: achievement_library.md:320-430
   - Assessment: COMPETITIVE STRENGTH - exceeds requirement

✅ STRONG MATCH: Outdoor Amphitheater
   - 600-seat venue, ground-up construction
   - Demonstrates range (new build + adaptive reuse)
   - Source: achievement_library.md:405-450
   - Assessment: Additional supporting evidence

Overall Assessment: COMPETITIVE STRENGTH - you exceed this requirement

---

### Team Leadership
JD Requirement: "Experience managing teams of 25+ in complex environments"
Priority: HIGH (mentioned 5x, organizational requirement)

Your Achievement Library:
✅ STRONG MATCH: Kirk Douglas Theater
   - Managed 50 full- and part-time staff
   - Cross-functional team complexity
   - Source: achievement_library.md:371
   - Assessment: STRONG - direct evidence with scale

⚠️  PARTIAL MATCH: Academic Advising Crisis
   - Leadership demonstrated, but not direct management
   - Team coordination vs. formal reporting structure
   - Source: achievement_library.md:890-920
   - Assessment: SUPPORTING - shows leadership capability

Overall Assessment: STRONG - direct evidence available

---

### Change Management Certification
JD Requirement: "Certified change management professional preferred"
Priority: MEDIUM (preferred, not required)

Your Achievement Library:
❌ GAP: No certification mentioned

⚠️  REFRAMING OPPORTUNITY:
   - Practical experience: Free-to-Earned Revenue Model transformation
   - Organizational change: 200+ employees affected
   - Evidence: achievement_library.md:520-560
   - Additional: Data Infrastructure Implementation (systems change)
   - Additional: Strategic Planning Leadership (cultural change)

Reframing Strategy Needed: Emphasize practical expertise, frame cert as growth opportunity

Overall Assessment: ADDRESSABLE GAP - strong practical foundation

---

### Values Alignment
JD Requirement: "Commitment to equity, diversity, inclusion, access, and belonging"
Priority: HIGH (mentioned throughout, cultural priority)

Your Career Philosophy:
✅ STRONG MATCH: Core Value - Arts as Social Justice
   - Direct alignment with DEI emphasis
   - Evidence from philosophy lexicon
   - Source: career_philosophy.md:215-240
   - Assessment: AUTHENTIC ALIGNMENT

✅ STRONG MATCH: Leadership Approach - Equity-Centered Practice
   - Structural commitment, not just values statement
   - Source: career_philosophy.md:125-160
   - Assessment: This is a strength to emphasize

Overall Assessment: AUTHENTIC ALIGNMENT - exceptional match
```

**Summary Matrix:**

After completing all categories, present summary:

```markdown
## Overall Fit Summary

**Competitive Position:** STRONG CANDIDATE

### Strengths (✅ Direct Matches)
1. Capital Projects & Infrastructure - EXCEEDS requirement
2. Team Leadership - STRONG with direct evidence
3. Values Alignment - EXCEPTIONAL (authentic overlap)
4. Stakeholder Management - COMPETITIVE STRENGTH
5. [Continue for all strong matches]

Total: 8 of 10 key requirements

### Partial Matches (⚠️ Need Reframing)
1. Change Management - Strong practical experience, no certification
2. [Other partial matches]

Total: 2 requirements

### Gaps (❌ Missing Requirements)
1. [If any critical gaps exist]

Total: 0 critical, 1 preferred (certification)

**Recommended Application Strategy:**
Lead with capital project + stakeholder strength, emphasize values alignment,
address certification gap proactively through reframing
```

### Phase 2.5: Gap Verification with User

**CRITICAL: Before proceeding to reframing or document creation, verify all identified gaps with the user.**

**Why this phase exists:**
- Ensure gaps are genuine (not analysis errors)
- Identify information missing from lexicons
- Catch achievements that exist but weren't surfaced
- Prevent inaccurate competitive positioning

**Process for each identified gap (❌) or partial match (⚠️):**

1. **Present the gap clearly:**
```
I identified a potential gap:

Requirement: [Exact requirement from job]
Priority: [HIGH/MEDIUM/LOW from job analysis]
Current Assessment: ❌ GAP or ⚠️ PARTIAL MATCH

My analysis: [Brief explanation of why assessed as gap]

Is this truly a gap in your background?
```

2. **Ask yes/no question using AskUserQuestion:**
```
Is "[requirement]" a genuine gap in your experience?
- Yes, I don't have this experience
- No, I do have this experience
```

3. **If user says "No" (gap is incorrect):**
```
You indicated you DO have experience with [requirement].

Help me understand what I missed:

A) This experience exists in different documents not yet in lexicons
   → Which documents should I look for?
   → What role/timeframe had this experience?

B) This experience is in the lexicon but I missed the connection
   → Can you point me to where this appears?
   → What achievement/section should I review?

C) The requirement is being interpreted too narrowly
   → How should I understand this requirement?
   → What experience of yours actually meets it?

D) This is captured under a different category/label
   → Where in your background does this appear?
```

4. **If user says "Yes" (confirmed gap):**
```
Confirmed gap: [requirement]

Follow-up questions:

A) Do you have ANY related experience (even if not exact match)?
   → What's the closest experience you have?
   → This helps us build reframing strategy

B) Is this a learnable skill or fixed requirement?
   → Can you develop this if hired?
   → Should we frame as growth opportunity?

C) How critical is this gap to your competitiveness?
   → Deal-breaker or addressable?
   → Should we apply anyway?
```

**Document all verification outcomes:**

```markdown
## Gap Verification Summary

### Verified Gaps (User Confirmed)
1. **[Requirement]** - Priority: [HIGH/MEDIUM/LOW]
   - User confirmation: "Yes, genuine gap"
   - Related experience: [If any]
   - Reframing potential: [HIGH/MEDIUM/LOW]
   - User notes: "[Any context provided]"
   - Verified: YYYY-MM-DD

### Corrected Assessments (Analysis Errors)
1. **[Requirement]** - Originally assessed as GAP
   - User correction: "I have this experience"
   - Location in background: [User's explanation]
   - Action needed:
     * ✅ Update lexicons with [specific documents]
     * ✅ Re-analyze Section [X] for this experience
     * ✅ Verify achievement at [lexicon location]
   - Status: REQUIRES LEXICON UPDATE

### Lexicon Gaps Identified
[List of missing information that should be added to lexicons]

### Analysis Improvements Needed
[List of misinterpretations or narrow readings to correct]
```

**Example Verification Conversation:**

```
I identified 3 potential gaps. Let's verify each:

GAP 1 of 3:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Requirement: "5+ years budget management experience with budgets exceeding $1M"
Priority: HIGH (mentioned 4x, critical competency)
My Assessment: ⚠️ PARTIAL MATCH

Why: I found your Shakespeare Center budget ($1.6M) but this was 3 years, not 5.

Is this a genuine gap? (Yes/No)

[User answers: "No"]

You indicated you DO have 5+ years of $1M+ budget experience.

What did I miss?
A) Experience in documents not yet in lexicons
B) Experience is in lexicon but I missed it
C) I'm interpreting the requirement too narrowly
D) This appears under different category/label

[User answers: "B - My current COTA Associate Dean role has $29M budget and I've been in it for 2 years, plus Shakespeare Center was 3 years = 5 years total"]

Thank you! I see the issue. I didn't connect your COTA role budget to this requirement.

Let me update my analysis:
✅ STRONG MATCH - EXCEEDS:
- Current role: $29M budget (2 years and ongoing)
- Previous role: $1.6M budget (3 years)
- Total: 5+ years with budgets exceeding $1M
- Actually EXCEEDS requirement substantially

This changes your competitive position significantly. Continuing verification...
```

**Timing:**
- Complete gap verification BEFORE Phase 3 (Reframing)
- May need to loop back to Phase 2 if major corrections needed
- Document updates required before proceeding to cover letter plan

**Success Criteria:**
✅ Every gap/partial match verified with user
✅ User had opportunity to correct analysis errors
✅ Missing lexicon content identified for future updates
✅ User confirms final gap list before reframing strategies developed
✅ Competitive position assessment is accurate

---

### Phase 3: Reframing Strategy Development

**For each VERIFIED gap or partial match from Phase 2.5:**

Use AskUserQuestion tool to present reframing options:

**Example:**
```markdown
Gap Identified: "Change management certification preferred"

Your Background: Extensive practical change management experience
- Free-to-Earned Revenue Model (organizational transformation)
- Data Infrastructure Implementation (systems change)
- Strategic Planning Leadership (cultural change)

Reframing Options:

A) Emphasize Practical Expertise
"While not formally certified in change management, I have led three major
organizational transformations affecting 200+ employees, applying change
management principles including stakeholder analysis, communication planning,
and resistance mitigation"

Best for: When practical experience is extensive and certification is "preferred" not "required"
Philosophy connection: Evidence-based practice (career_philosophy.md:280)
Achievement sources: achievement_library.md:520, 670, 890

B) Frame as Growth Opportunity
"My practical change management experience positions me to pursue formal
certification, which would formalize the expertise gained through [specific examples]"

Best for: When showing commitment to professional development
Demonstrates: Growth mindset, continuous learning
Complements: Your other certifications/credentials

C) Highlight Transferable Framework
"Applied evidence-based change management frameworks in [specific transformation],
including Kotter's 8-step model for the revenue transition and adaptive leadership
principles for the data infrastructure implementation"

Best for: When you've used recognized frameworks even without formal training
Demonstrates: Theoretical grounding + practical application
Achievement sources: achievement_library.md:520-560

Which approach feels most authentic and strategic?
```

**Process:**
- Present 2-3 reframing options for each gap
- Ground each option in actual lexicon achievements
- User confirms preferred approach
- Document chosen strategy with sources
- Build reframing list for cover letter integration

**Build Reframing Documentation:**
```python
reframing_strategies = {
    "change_management_certification": {
        "gap": "Certification preferred",
        "background": "Extensive practical experience",
        "chosen_approach": "A) Emphasize Practical Expertise",
        "sources": ["achievement_library.md:520", "achievement_library.md:670"],
        "cover_letter_integration": "Paragraph 3: Transformation Experience",
        "user_confirmed": "2025-10-31"
    }
}
```

### Phase 4: Cover Letter Plan Development

**Based on gaps + reframing + strengths:**

**Structure:**
```markdown
## Cover Letter Strategic Plan

### Opening Strategy (Values Alignment)
**Recommendation:** Institutional Positioning pattern
**Why:** Job emphasizes [Company]'s unique assets in [sector/context]

**From your narrative patterns:**
- Pattern: "[Institution] is uniquely positioned by..."
- Source: narrative_patterns.md:130-145
- When to use: Academic, mission-driven organizations

**Application to this role:**
"[Company's] [Department] is uniquely positioned by its intersection
of [asset 1], [asset 2], and [asset 3] to [mission]—a vision that aligns
precisely with my [N]-year commitment to [your philosophy value]."

**Example:**
"UCLA's School of the Arts and Architecture is uniquely positioned by its intersection
of artistic excellence, research innovation, and public mission to advance arts as
a tool for social transformation—a vision that aligns precisely with my 15-year
commitment to arts-as-social-justice practice."

**Philosophy connection:**
Links to career_philosophy.md:215 (Arts as Social Justice value)

**Keywords to incorporate:**
- [Keyword 1 from job analysis]
- [Keyword 2 from job analysis]

---

### Middle Development (Achievements + Reframing)

**Paragraph 2: [Primary Strength - Achievement Category]**
**Recommended Achievement:** [Achievement Name]
**Variation:** [Variation type from library]
**Why this achievement:**
- Connects to: Their emphasis on "[requirement]"
- Scale: [Exceeds/Meets/Demonstrates] requirement
- Demonstrates: [Key competency]

**Source:** achievement_library.md:[line numbers]

**Narrative Pattern:** Challenge → Action → Result
**Estimated length:** 120-140 words

**Draft Guidance:**
Context/Challenge: "[Set up the situation]"
Action: "[Your role and approach]"
Result: "[Quantifiable outcome and impact]"

**Language notes:**
- Use verb: "[verb from language bank]" (language_bank.md:[line])
- Incorporate keyword: "[job priority keyword]"
- Emphasize: [competency they prioritized]

---

**Paragraph 3: [Secondary Strength or Transformation + Reframe]**
**Recommended Achievement:** [Achievement Name]
**Connects to:** [Job requirement and any gap to address]
**Reframing strategy:** [If addressing gap, reference strategy from Phase 3]

**Source:** achievement_library.md:[line numbers]

**Narrative Pattern:** Context → Insight → Application
**Estimated length:** 120-140 words

**Draft Guidance:**
Context: "[Situational setup that shows understanding]"
Insight: "[Your recognition or learning]"
Application: "[How you applied this, with results]"

[If reframing a gap:]
**Reframe language:** "[Approved reframing approach from Phase 3]"

---

**Paragraph 4: [Values-Driven Leadership or Additional Strength]**
**Recommended Focus:** [Philosophy theme or achievement]
**Connects to:** Their [value/requirement] commitment

**Source:** career_philosophy.md:[line numbers]

**Purpose:** Deepen values alignment, show cultural fit
**Estimated length:** 100-120 words

---

### Closing Strategy
**Recommendation:** Values Reaffirmation + Forward-Looking Invitation
**Pattern:** Synthesize alignment + vision + invitation
**Source:** narrative_patterns.md:155-165

**Template:**
"The [Job Title] role offers the opportunity to bring my [strength 1],
[strength 2], and [philosophy value] to an institution uniquely positioned
to [their mission]. I would welcome the opportunity to discuss how my
experience aligns with [Company]'s vision for [department/initiative]."

**Tone notes:**
- "offers the opportunity" = enthusiastic but not presumptuous
- "uniquely positioned" = callback to opening (structural cohesion)
- "discuss how" = invitation, collaborative tone
- Avoid: "I am the ideal candidate" (presumptuous)

**Estimated length:** 70-80 words

---

### Tone Profile
**Job requirement (from analysis Section III):**
- [Formality level from job analysis]
- [Innovation level from job analysis]
- [Collaboration level from job analysis]

**Your natural voice (from past letters + lexicon):**
- [Your established tone patterns]
- [Your preferred narrative structures]
- [Your characteristic language]

**Recommended synthesis:**
- Formality level: [Specific recommendation]
- Sentence structure: [Mix description]
- Vocabulary: [Guidance on word choices]
- Emotional register: [Tone description]

**Language guidance:**
- ✅ Use: [Verbs/phrases from your language bank that match their culture]
- ✅ Mirror their verbs: "[verb 1]," "[verb 2]," "[verb 3]"
- ❌ Avoid: [Language not in your lexicon or mismatched to their culture]

---

### Total Estimated Length
- Opening: ~100 words
- Development: ~360 words (3 paragraphs × 120 words)
- Closing: ~75 words
- **Total: 535 words** (appropriate for this role level)

---

### Integration with Resume
**Ensure complementarity, not duplication:**

**Resume emphasizes:** [Achievement aspects highlighted in resume]
**Cover letter emphasizes:** [Different aspects or additional context]

**Example:**
- Resume bullet: "Stewarded $12.1M capital project from conception through delivery"
- Cover letter expansion: Context of partnership complexity, stakeholder navigation, community impact
```

### Phase 5: JSON Export for Wrapper Application

**After completing cover letter plan develop