mcpbeat Sign in

Algo Hr Compensation Agent Skill

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'.

8k tokens
context cost
the whole folder, loaded on every use
4
files
instructions only
0
copies elsewhere
how many repositories repackaged it
223
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/asgard-ai-platform/skills --skill algo-hr-compensation

What comes with it

28 156 bytes besides the instruction
examples/sample_scenario.md
references/band-design.md
references/pay-equity.md

The instruction itself

14 sections, as written by the author

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

Other skills for the same job

different authors, same section of the catalogue
Skill Creator
by anthropics
vendor ×10

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

56k tokens scripts
Geo Database
by christophacham
×4

Access NCBI GEO for gene expression/genomics data. Search/download microarray and RNA-seq datasets (GSE, GSM, GPL), retrieve SOFT/Matrix files, for transcriptomics and expression analysis.

12k tokens
Pymc Bayesian Modeling
by christophacham
×4

Bayesian modeling with PyMC. Build hierarchical models, MCMC (NUTS), variational inference, LOO/WAIC comparison, posterior checks, for probabilistic programming and inference.

24k tokens scripts
Pymoo
by christophacham
×4

Multi-objective optimization framework. NSGA-II, NSGA-III, MOEA/D, Pareto fronts, constraint handling, benchmarks (ZDT, DTLZ), for engineering design and optimization problems.

19k tokens scripts
Statsmodels
by ComeOnOliver
×4

Statistical modeling toolkit. OLS, GLM, logistic, ARIMA, time series, hypothesis tests, diagnostics, AIC/BIC, for rigorous statistical inference and econometric analysis.

41k tokens
Add Uint Support
by pytorch
vendor ×3

Add unsigned integer (uint) type support to PyTorch operators by updating AT_DISPATCH macros. Use when adding support for uint16, uint32, uint64 types to operators, kernels, or when user mentions enabling unsigned types, barebones unsigned types, or uint support.

2k tokens
At Dispatch V2
by pytorch
vendor ×3

Convert PyTorch AT_DISPATCH macros to AT_DISPATCH_V2 format in ATen C++ code. Use when porting AT_DISPATCH_ALL_TYPES_AND*, AT_DISPATCH_FLOATING_TYPES*, or other dispatch macros to the new v2 API. For ATen kernel files, CUDA kernels, and native operator implementations.

2k tokens
Docstring
by pytorch
vendor ×3

Write docstrings for PyTorch functions and methods following PyTorch conventions. Use when writing or updating docstrings in PyTorch code.

3k tokens

How to use it

Copy the folder

Take asgard-ai-platform/algo-hr-compensation from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.