Configuration
Read .jobops/config.json. If missing, stop with:
JOBOPS NOT CONFIGURED Run /jobops:setup to initialize your workspace.
Use config.directories.<key> for all file paths in this skill.
Use config.preferences.cultural_profile if this skill generates resume-style content.
Use config.preferences.default_jurisdiction if this skill has jurisdiction-sensitive logic (crisis/legal skills accept --jurisdiction=<ISO-3166-2> to override).
Application Path Resolution
This skill writes to a per-application folder. Before writing any output:
- Parse
{Company}_{Role}_{YYYYMMDD}from the job-posting filename, or honor--app=<slug>if supplied. - Compose the app folder:
{config.directories.applications_root}/{app_slug}/. - Resolve this skill's sub-folder by category:
- resume-development (buildresume, provenance-check) →
resume/ - cover-letter (coverletter) →
cover-letter/ - rubric / assessment (createrubric, assessjob, assesscandidate, auditjobposting) →
assessment/ - briefing / interview prep (briefing, interviewprep) →
interview/
- resume-development (buildresume, provenance-check) →
- If the app folder does not exist,
mkdir -pit, then copy{config.directories.job_postings}/{filename}→{app_slug}/job_posting.mdso the pinned JD cannot silently change under completed work. - Exact-slug collisions (same Company+Role+Date) are not auto-suffixed. If the folder
already contains the same output type, require the user to pass
--app=<distinct-slug>.
Your Task
Analyze the job posting at {config.directories.job_postings}/{{ARG1}} (add .md extension if needed) using a rigorous 100-point scoring rubric that identifies red flags, unrealistic expectations, and posting quality issues that job seekers should consider before applying.
Why This Matters
Many job postings contain:
- Impossible requirements: "10 years of Kubernetes experience" when Kubernetes is ~10 years old
- Unicorn hunting: Asking for skills across 4-5 distinct job roles
- Compensation disconnects: Entry-level pay for senior expectations
- Hidden dysfunction: Vague language masking organizational chaos
- Internal contradictions: Title/seniority/responsibility mismatches
This audit helps job seekers make informed decisions about which opportunities are worth pursuing.
JOB POSTING QUALITY AUDIT RUBRIC (100 Points)
Category 1: Internal Consistency (25 Points)
Evaluates whether the posting is internally coherent and free of contradictions.
1.1 Title-Seniority-Responsibility Alignment (8 points)
| Score | Criteria |
|---|---|
| 8 | Title perfectly reflects seniority level; responsibilities match exactly; clear career level positioning |
| 6 | Minor misalignment (e.g., "Senior" title with some junior-level tasks mixed in) |
| 4 | Notable disconnect (e.g., "Manager" title but no direct reports mentioned) |
| 2 | Significant mismatch (e.g., "Junior" title with senior architect responsibilities) |
| 0 | Complete contradiction or deliberately misleading title |
Evaluation Checklist:
- Does the title reflect actual seniority level?
- Do responsibilities match the level implied by the title?
- Is there consistency between role level and decision-making authority?
- Do reporting relationships align with title hierarchy?
1.2 Experience Requirements Coherence (7 points)
| Score | Criteria |
|---|---|
| 7 | Experience years perfectly calibrated to role level; clear required vs. preferred distinction |
| 5 | Minor inconsistencies (e.g., "5-10 years" range too broad for clarity) |
| 3 | Conflicting requirements (e.g., "entry-level" but "5+ years required") |
| 1 | Impossible requirements (e.g., more years than technology exists) |
| 0 | Completely unrealistic or contradictory experience demands |
Evaluation Checklist:
- Are experience requirements appropriate for the role level?
- Is there clear distinction between "required" and "preferred"?
- Do experience ranges make sense (not impossibly broad)?
- Are industry-specific experience needs realistic?
1.3 Skills-Duties Alignment (5 points)
| Score | Criteria |
|---|---|
| 5 | Every required skill directly maps to stated responsibilities |
| 4 | Most skills connect to duties; minor orphan skills |
| 2 | Significant skills listed that never appear in responsibilities |
| 1 | Skills list appears copy-pasted; poor relevance to actual duties |
| 0 | Skills and duties completely disconnected |
Evaluation Checklist:
- Is every required skill actually used in described duties?
- Are listed technologies mentioned in responsibilities?
- Do "preferred" skills relate to actual job functions?
1.4 Reporting Structure Clarity (5 points)
| Score | Criteria |
|---|---|
| 5 | Clear manager, team structure, dotted lines all specified |
| 4 | Most relationships clear; minor ambiguity |
| 2 | Vague structure (e.g., "cross-functional team" without definition) |
| 1 | Contradictory structure (e.g., "individual contributor" but "manage team") |
| 0 | No reporting structure provided or completely unclear |
Evaluation Checklist:
- Is the direct manager/reporting line clear?
- Is team size and composition described?
- Are cross-functional relationships defined?
- Is individual contributor vs. management role clear?
Category 2: Market Realism (25 Points)
Evaluates whether the requirements reflect reality in the current job market.
2.1 Technology Timeline Validity (8 points)
| Score | Criteria |
|---|---|
| 8 | All experience requirements are mathematically possible given technology ages |
| 6 | Minor stretch (e.g., asking for 5 years in a 6-year-old technology) |
| 4 | Borderline impossible (e.g., 8 years in a 7-year-old technology) |
| 2 | Clearly impossible for some technologies (e.g., 10 years of GPT-4 experience) |
| 0 | Multiple impossible timeline requirements; hiring manager ignorance evident |
Technology Release Reference (verify and calculate fresh age):
- Kubernetes (launched 2014)
- Docker (launched 2013)
- React (launched 2013)
- TypeScript (launched 2012)
- Go/Golang (launched 2009)
- Terraform (launched 2014)
- AWS Lambda (launched 2014)
- ChatGPT/GPT-4 (launched 2022-2023)
- LangChain (launched 2022)
- Azure OpenAI (launched 2023)
Use the release years above (or updated research) to calculate how many years of experience are mathematically possible relative to the current year—never rely on stale "~X years old" notes.
Evaluation Checklist:
- Research age of each mentioned technology
- Calculate if experience requirements are mathematically possible
- Flag any "impossible timeline" requirements
- Note technologies where experience asks are borderline
2.2 Skill Breadth Feasibility (7 points)
| Score | Criteria |
|---|---|
| 7 | Coherent skill set achievable by qualified professionals |
| 5 | Ambitious but possible (e.g., full-stack + some DevOps) |
| 3 | Unicorn-adjacent (e.g., full-stack + DevOps + ML + mobile) |
| 1 | Clear unicorn hunting (5+ distinct specializations required) |
| 0 | Absurd combinations (e.g., neurosurgeon + tax attorney + ML engineer) |
Skill Domain Categories for Analysis:
- Frontend: React, Vue, Angular, CSS, UX design
- Backend: APIs, databases, server architecture
- DevOps/Infrastructure: CI/CD, cloud platforms, containers
- Data/ML: Data engineering, ML models, analytics
- Management: Team leadership, project management, stakeholder relations
- Security: Penetration testing, compliance, security architecture
- Mobile: iOS, Android, React Native
- Specialized: Embedded systems, blockchain, game development
Evaluation Checklist:
- How many distinct skill domains are required?
- Are they hiring for 1 job or 3+ jobs combined?
- Would a realistic candidate have this skill breadth?
- Is the combination achievable within one career path?
2.3 Candidate Pool Reality (5 points)
| Score | Criteria |
|---|---|
| 5 | Candidate matching this profile exists in meaningful numbers |
| 4 | Pool is small but candidates exist |
| 2 | Very rare combination; pool extremely limited |
| 1 | Theoretical candidates only; virtually impossible to find |
| 0 | No such person exists; posting is fantasy |
Evaluation Checklist:
- Could you realistically find 10+ candidates who match?
- Is the intersection of required skills commonly found?
- Are they demanding niche expertise + broad generalist skills?
2.4 Geographic Market Alignment (5 points)
| Score | Criteria |
|---|---|
| 5 | Requirements match local talent pool and market conditions |
| 4 | Slight mismatch (e.g., Bay Area expectations in smaller market) |
| 2 | Significant mismatch (e.g., no remote for niche role in small city) |
| 1 | Completely unrealistic (e.g., demanding Stanford PhD in rural area, no remote) |
| 0 | Location requirements make role unfillable |
Evaluation Checklist:
- Does location have sufficient talent pool?
- Is remote work offered for roles requiring niche skills?
- Are relocation expectations reasonable?
- Does on-site requirement match role complexity?
Category 3: Compensation Assessment (20 Points)
Evaluates whether compensation is realistic and competitive.
3.1 Salary-Role Alignment (7 points)
| Score | Criteria |
|---|---|
| 7 | Compensation clearly competitive for stated responsibilities |
| 5 | Market rate; neither exceptional nor concerning |
| 3 | Below market but potentially offset by other factors |
| 1 | Significantly below market for responsibilities described |
| 0 | Insultingly low; suggests exploitation or role inflation |
Research Required:
- Search for similar roles on levels.fyi, Glassdoor, LinkedIn Salary Insights
- Compare to market rates for the specific responsibilities
- Factor in company stage (startup vs. enterprise)
3.2 Salary-Experience Alignment (5 points)
| Score | Criteria |
|---|---|
| 5 | Pay matches required experience level appropriately |
| 4 | Slight disconnect; acceptable range |
| 2 | Notable mismatch (senior experience, mid-level pay) |
| 1 | Severe mismatch (expert requirements, entry-level pay) |
| 0 | Exploitative (demanding 10+ years for intern-level wages) |
3.3 Salary-Location Alignment (4 points)
| Score | Criteria |
|---|---|
| 4 | Pay appropriate for cost of living in specified location |
| 3 | Acceptable for location; could be better |
| 2 | Below market for the area |
| 1 | Pay doesn't match location costs (Bay Area pay in Bay Area = fine; Midwest pay in Bay Area = problem) |
| 0 | Pay makes role unlivable in required location |
3.4 Total Compensation Transparency (4 points)
| Score | Criteria |
|---|---|
| 4 | Clear salary range + bonus + equity + benefits outlined |
| 3 | Base salary clear; other comp vague |
| 2 | "Competitive" compensation only; no specifics |
| 1 | No compensation mentioned; must ask |
| 0 | Evasive about compensation; red flag language |
Unavailable compensation data: When the posting omits explicit pay details, mark 3.4 according to the level of opacity but still score 3.1-3.3 using the best available market proxies (Levels.fyi, historical internal data, similar postings). Note the inference source inside your audit so candidates understand the confidence level.
Category 4: Role Scope & Definition (20 Points)
Evaluates whether this is a well-defined, achievable role.
4.1 Single Role Focus (6 points)
| Score | Criteria |
|---|---|
| 6 | Clear, focused role with coherent responsibilities |
| 4 | Some scope creep but core role is clear |
| 2 | Two distinct jobs combined (e.g., "developer + sys admin") |
| 1 | Three or more distinct jobs combined |
| 0 | "Everything" role; undefined chaos |
Evaluation Checklist:
- Can the responsibilities be performed by one person?
- Is the role focused or scattered across domains?
- Does it combine incompatible work styles (e.g., deep focus IC + meeting-heavy manager)?
4.2 Responsibility Clarity (5 points)
| Score | Criteria |
|---|---|
| 5 | Specific, actionable responsibilities with clear deliverables |
| 4 | Mostly clear; some vague items |
| 2 | Heavy use of vague language ("drive innovation", "synergize cross-functionally") |
| 1 | Responsibilities are buzzword soup |
| 0 | No clear idea what person would actually do |
Red Flag Phrases:
- "Other duties as assigned" (excessive use)
- "Wear many hats"
- "Fast-paced environment" (often means chaos)
- "Self-starter" (often means no support)
- "Rockstar/ninja/guru" (often means unrealistic expectations)
4.3 Success Metrics Clarity (5 points)
| Score | Criteria |
|---|---|
| 5 | Clear KPIs, success measures, or outcome expectations |
| 4 | Implied metrics; could be inferred |
| 2 | Vague success criteria; unclear how performance is measured |
| 1 | No indication of what success looks like |
| 0 | Contradictory success signals |
4.4 Growth Path Visibility (4 points)
| Score | Criteria |
|---|---|
| 4 | Clear career progression, learning opportunities, advancement path |
| 3 | Some growth potential mentioned |
| 2 | Growth vaguely implied |
| 1 | No growth path; appears dead-end |
| 0 | Negative signals (high turnover language, "urgent hire") |
Category 5: Red Flag Assessment (10 Points)
Evaluates organizational health and cultural signals.
5.1 Professional Language Quality (3 points)
| Score | Criteria |
|---|---|
| 3 | Clear, professional, specific language throughout |
| 2 | Generally professional; some buzzword use |
| 1 | Heavy buzzword reliance; vague corporate speak |
| 0 | Unprofessional, hyperbolic, or desperate-sounding |
Red Flag Language:
- Excessive exclamation points!!!
- "Family" culture (often means boundary violations)
- "Unlimited PTO" (often means no PTO)
- "Work hard, play hard" (often means overwork)
- "Wearing many hats" (often means understaffed)
5.2 Organizational Health Signals (3 points)
| Score | Criteria |
|---|---|
| 3 | Positive signals: stable team, clear mission, reasonable expectations |
| 2 | Neutral; no obvious concerns |
| 1 | Some yellow flags: urgency, turnover hints, defensive language |
| 0 | Multiple red flags: chaos signals, unrealistic demands, desperation |
Research Required:
- Check Glassdoor reviews for team/department
- Look for turnover patterns in role
- Research company news for layoffs, restructuring
5.3 Process Transparency (2 points)
| Score | Criteria |
|---|---|
| 2 | Clear application process, timeline, interview stages |
| 1 | Some process info; could be clearer |
| 0 | No process info; black box hiring |
5.4 Work-Life Balance Signals (2 points)
| Score | Criteria |
|---|---|
| 2 | Reasonable expectations; balance valued |
| 1 | Neutral or unclear |
| 0 | Red flags: on-call 24/7, "flexible hours" meaning always working, etc. |
SCORING INTERPRETATION
| Score Range | Grade | Interpretation | Recommendation |
|---|---|---|---|
| 90-100 | A | Excellent posting | Strongly pursue; well-crafted opportunity |
| 80-89 | B | Good posting | Worth applying; minor concerns only |
| 70-79 | C | Fair posting | Apply with caution; clarify concerns in interview |
| 60-69 | D | Poor posting | Significant issues; proceed with low expectations |
| 50-59 | F | Problematic | Major red flags; likely organizational problems |
| Below 50 | F- | Avoid | Posting suggests dysfunction or unicorn hunting |
EXECUTION PROTOCOL
Step 1: Load and Parse Job Posting
✓ Reading job posting from {config.directories.job_postings}/{{ARG1}}
Read the job posting file and extract:
- Job title and seniority level
- Company name and location
- All required skills and experience
- All preferred/nice-to-have items
- Responsibilities and duties
- Compensation information (if present)
- Team structure and reporting
- Company culture signals
Step 2: Conduct Market Intelligence Research
Use web search to gather:
Access constraints: If the CLI session lacks network access or required sources are paywalled, rely on previously gathered benchmarks, local reference material, or reasonable industry heuristics. Document the missing research explicitly in your audit (e.g., "Glassdoor data unavailable in offline mode") so reviewers know which assumptions require follow-up.
Technology Age Verification
- Research release dates for all mentioned technologies
- Calculate if experience requirements are possible
Salary Benchmarking
- Search levels.fyi, Glassdoor, LinkedIn for role + location
- Determine market rate for similar positions
Company Intelligence
- Check Glassdoor reviews (especially recent ones)
- Search for recent news (layoffs, growth, funding)
- Look for employee sentiment on LinkedIn/Blind
Role Market Analysis
- How common is this skill combination?
- What do similar postings require?
- Is this unicorn hunting or reasonable?
Step 3: Apply Scoring Rubric
For each of the 5 categories:
- Evaluate each subcategory using the rubric criteria
- Assign point scores with justification
- Cite specific evidence from the posting
- Note any red flags or concerns
Step 4: Generate Comprehensive Audit Report
Create a detailed report with:
4.1 YAML Frontmatter
---
job_file: {config.directories.job_postings}/{{ARG1}}
role: <role title>
company: <company name>
location: <location>
posting_date: <date from job posting, or "Not specified">
generated_by: /auditjob
generated_on: <ISO8601 timestamp>
output_type: job_posting_audit
status: final
version: 1.0
overall_score: <XX/100>
grade: <A/B/C/D/F>
recommendation: <pursue/caution/avoid>
---
4.2 Job Posting Header (REQUIRED - Display Prominently at Top)
Immediately after the YAML frontmatter, display a prominent header block with key job information:
# Job Posting Quality Audit Report
## [JOB TITLE]
**Company:** [COMPANY NAME]
**Posting Date:** [DATE from job posting, e.g., "Nov 24, 2025" or "Not specified"]
**Location:** [LOCATION]
---
This header MUST appear at the very top of the report (after frontmatter) so readers immediately know which job is being audited. Extract the posting date from within the job posting file if available (look for "Date:", "Posted:", "Deadline:", or similar fields).
4.3 Executive Summary
- Overall score and grade
- 2-3 sentence assessment
- Primary recommendation
4.4 Detailed Scoring Breakdown
For each category, provide:
- Category score (X/Y points)
- Subcategory breakdowns with evidence
- Specific findings and concerns
Recommended table template (expand rows as needed):
| Category | Subcategory | Score | Evidence & Notes |
|---|---|---|---|
| Internal Consistency | 1.1 Title-Seniority-Responsibility Alignment | 6/8 | e.g., "Manager" title but only IC duties |
| ... | ... | ... | ... |
4.5 Red Flags Identified
- List all red flags found
- Severity assessment
- Impact on candidate decision
4.6 Questions to Ask in Interview
Based on audit findings, generate 5-7 questions the candidate should ask to clarify concerns:
- Address identified inconsistencies
- Probe organizational health signals
- Clarify scope and expectations
4.7 Competitive Intelligence
- How does compensation compare to market?
- Is this role well-positioned vs. similar opportunities?
- Any leverage points for negotiation?
4.8 Final Recommendation
- Clear pursue/caution/avoid recommendation
- Key decision factors
- What would change the assessment
Step 5: Save Audit Report
Resolve {app_slug} per the Application Path Resolution protocol at the top of this skill, and ensure {applications_root}/{app_slug}/assessment/ exists (mkdir -p). Pin the JD to {applications_root}/{app_slug}/job_posting.md if not already present.
Save Location: {applications_root}/{app_slug}/assessment/job_audit.md
This co-locates the audit alongside any rubric/assessment that already lives in the same app folder, and the app folder itself is the self-contained container — no timestamped sub-folder is required.
Example Analysis Application
Given the HONI_Data_Services_Manager.md posting:
Internal Consistency Issues:
- Title says "Data Services Manager" but LinkedIn addendum says "AI Engineer"
- Manager responsibilities listed but technical AI skills demanded
- Potential title-role mismatch
Market Realism Issues:
- LangChain: ~2-3 years old
- Azure OpenAI: ~2 years old
- Any requirement for 5+ years in these is impossible
Scope Issues:
- Official posting: People management focus
- LinkedIn addendum: Deep technical AI focus
- These are two different jobs
This type of analysis should be applied systematically to the target posting.
Error Handling
- Missing job posting: Report if file not found; suggest available alternatives in {config.directories.job_postings}/
- No compensation data: Note as N/A; research market rates for comparison
- Insufficient company info: Document gaps; recommend additional research
- Conflicting information: Flag as major inconsistency; document both versions
Important Notes
- Objectivity: Score based on evidence, not assumptions
- Candidate Perspective: This audit serves job seekers, not employers
- Actionable Output: Provide practical guidance for application decisions
- Evidence-Based: Cite specific passages from the posting for all findings
- Web Research Required: Technology ages and salary data must be verified
- Honesty: Don't soften findings; job seekers deserve accurate assessments