algo-hr-compensation
Skill238 starsChanged 6 months agoMITView on GitHub
Conduct compensation benchmarking analysis to position salaries against market data. Use this skill when the user needs to assess pay competitiveness, build salary bands, or analyze pay equity — even if they say 'are we paying market rate', 'salary benchmarking', or 'compensation analysis'.
In this repository315 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- algo-ad-biddingSkill
- algo-ad-budgetSkill
- algo-ad-ctrSkill
- algo-ad-gspSkill
- algo-ad-vcgSkill
- algo-blockchain-basicsSkill
- algo-blockchain-smart-contractSkill
- algo-ecom-bm25Skill
- algo-ecom-rankingSkill
- algo-ecom-searchSkill
- algo-forecast-arimaSkill
- algo-forecast-ensembleSkill
- algo-forecast-exponentialSkill
- algo-forecast-prophetSkill
- algo-hr-matchingSkill
- algo-hr-turnoverSkill
- algo-mfg-cpkSkill
- algo-mfg-doeSkill
- algo-mfg-fmeaSkill
- algo-mfg-spcSkill
- algo-net-centralitySkill
- algo-net-communitySkill
- algo-net-influenceSkill
- algo-nlp-ldaSkill
- algo-nlp-nerSkill
- algo-nlp-similaritySkill
- algo-nlp-summarizationSkill
- algo-price-bundleSkill
- algo-price-conjointSkill
- algo-price-dynamicSkill
- algo-price-elasticitySkill
- algo-price-van-westendorpSkill
- algo-rank-bayesianSkill
- algo-rank-eloSkill
- algo-rank-trueskillSkill
- algo-rank-wilsonSkill
- algo-rec-cfSkill
- algo-rec-contentSkill
- algo-rec-hybridSkill
- algo-rec-mfSkill
- algo-rec-sessionSkill
- algo-risk-altman-zSkill
- algo-risk-benfordSkill
- algo-risk-creditSkill
- algo-risk-varSkill
- algo-sc-bullwhipSkill
- algo-sc-eoqSkill
- algo-sc-newsvendorSkill
- algo-sc-routingSkill
- algo-sc-safety-stockSkill
- algo-seo-backlinkSkill
- algo-seo-contentSkill
- algo-seo-crawlSkill
- algo-seo-pagerankSkill
- algo-seo-schemaSkill
- algo-seo-technicalSkill
- algo-seo-tfidfSkill
- algo-social-engagementSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 24
When no market data is available (need at least survey benchmarks)
- Distinctive: line 49
Check: compa-ratios cluster around 0.85-1.15 (normal range).
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Compensation Benchmarking
Overview
Compensation benchmarking compares internal pay levels against external market data to assess competitiveness. Uses compa-ratio (actual pay / market midpoint) and percentile positioning. Informs salary band design, pay adjustments, and equity analysis.
When to Use
Trigger conditions:
- Evaluating whether current salaries are competitive with the market
- Designing or updating salary bands and pay structures
- Identifying pay equity gaps across demographics or roles
When NOT to use:
- For individual performance-based pay decisions (use performance management)
- When no market data is available (need at least survey benchmarks)
Algorithm
IRON LAW: Benchmarking Is Only Valid With COMPARABLE Jobs
Matching by job TITLE alone is unreliable — "Senior Engineer" means
vastly different things at different companies. Match by: job content
(duties, scope), level (IC vs manager, experience band), industry,
geography, and company size. Poor job matching produces misleading
market rates.Phase 1: Input Validation
Collect: internal compensation data (base, bonus, equity), market survey data (P25, P50, P75 by role), job matching between internal roles and survey benchmarks. Gate: Jobs properly matched, survey data current (< 18 months).
Phase 2: Core Algorithm
- Match internal jobs to market benchmarks by content, level, and scope
- Age survey data to current date: apply projected market movement rate
- Compute compa-ratio per employee: actual base / market P50
- Compute percentile positioning: where does actual pay fall in market distribution
- Analyze: by department, level, tenure, demographics for equity gaps
Phase 3: Verification
Check: compa-ratios cluster around 0.85-1.15 (normal range). Flag outliers (< 0.80 underpaid, > 1.20 overpaid). Test demographic equity. Gate: Distribution reasonable, equity analysis completed.
Phase 4: Output
Return benchmarking results with band recommendations.
Output Format
{
"summary": {"avg_compa_ratio": 0.97, "below_band_pct": 12, "above_band_pct": 8},
"by_role": [{"role": "Software Engineer", "market_p50": 1800000, "avg_actual": 1750000, "compa_ratio": 0.97}],
"equity_flags": [{"dimension": "gender", "gap_pct": 3.2, "statistically_significant": true}],
"metadata": {"employees": 500, "survey_source": "Mercer", "survey_date": "2025-H2"}
}Examples
Sample I/O
Input: 50 engineers, market P50=NT$1.8M, actual range NT$1.5M-2.1M Expected: Avg compa-ratio ~0.97, some below-band employees flagged for adjustment.
Edge Cases
| Input | Expected | Why |
| Hot market (tech boom) | Market data rapidly outdated | Apply higher aging factor |
| Remote work mixed | Location-adjusted bands needed | SF vs Taipei market rates differ 2-3x |
| Small company, no survey match | Use broader industry proxies | Imperfect but better than nothing |
Gotchas
- Total compensation: Base salary benchmarking alone misses equity, bonuses, and benefits. Compare total comp for accurate positioning.
- Survey data lag: Published surveys reflect data collected 6-18 months ago. In fast-moving markets, age the data forward.
- Internal equity vs external competitiveness: Aligning with market may create internal inequities (new hire paid more than tenured employee). Balance both.
- Geographic differentials: Remote work complicates location-based pay. Define a clear policy: pay by HQ location, employee location, or hybrid.
- Pay equity legal risk: Unexplained demographic pay gaps expose legal liability. Conduct regression-based equity analysis controlling for legitimate factors (experience, performance, level).
References
- For salary band design methodology, see
references/band-design.md - For pay equity regression analysis, see
references/pay-equity.md
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

