skills/auction-winners-curse-haircut/SKILL.md
Applies a Bayesian haircut to a bid valuation for common-value auctions where winning is itself evidence the bidder over-estimated. Takes a raw valuation, a value-type classification (common_value / private_value / mixed), the number of informed bidders N, and a signal-dispersion estimate, and returns an adjusted valuation. Domain-neutral and reusable across fantasy FAAB, prediction markets, M&A bids, ad-auction budgets, and any generic bidding context. Use when user mentions "winner's curse", "common value auction", "valuation haircut", "adverse valuation", "Bayesian bid adjustment", or "over-paying in auction".
npx skillsauth add lyndonkl/claude auction-winners-curse-haircutInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Scenario: Bidder has estimated a target's value at raw_valuation = $30. Six informed bidders are competing. Estimates across bidders are moderately dispersed (signal_dispersion = 40 out of 100). The target is a well-known commodity (everyone models it similarly).
Inputs:
raw_valuation: 30value_type: common_valuen_informed_bidders: 6signal_dispersion: 40Haircut computation:
haircut_pct = min(35, 10 + log(6) x 5 + 40 x 0.2)
= min(35, 10 + 1.792 x 5 + 8)
= min(35, 10 + 8.96 + 8)
= min(35, 26.96)
= 26.96 (clamped below 35 ceiling)
Output:
adjusted_valuation = 30 x (1 - 0.2696) = $21.91haircut_pct = 26.96classification_rationale: "Common-value target with 6 informed bidders and moderate signal dispersion. Winning is material evidence of over-estimation; Kagel-Levin experimental range (15-30%) applies."applied: trueContrast -- private-value case: Same raw_valuation = $30, but value_type = private_value (target matters uniquely to this bidder). Haircut = 0. Adjusted = $30. Applied = false. Rationale: "No informational-asymmetry discount; winning is not adverse because other bidders do not value the target similarly."
Copy this checklist and track progress:
Winner's-Curse Haircut Progress:
- [ ] Step 1: Classify value_type (common / private / mixed)
- [ ] Step 2: Validate inputs (range checks, N >= 1)
- [ ] Step 3: Short-circuit for private-value
- [ ] Step 4: Compute haircut_pct via formula
- [ ] Step 5: Apply haircut to raw_valuation
- [ ] Step 6: Emit structured output with rationale
Step 1: Classify value_type
Classification is a judgment call and MUST be explicit. The caller should pass it; this skill validates the choice against the decision tree in resources/template.md.
common_value -- target's value is similar for all bidders because information is shared and the underlying quantity is the same (examples: named closer on waivers, headline prospect call-up, publicly traded stock in a tender, liquid commodity)private_value -- target's value is meaningfully higher (or lower) for this bidder than for others, due to fit, complementarity, or idiosyncratic preference (examples: handcuff to a reliever you already own, platoon fit for your lineup, a house next door to an existing property)mixed -- target has a shared core value plus a private-value increment (examples: late-season FAAB claim on a hot hitter where everyone agrees on the base projection but the bidder's specific category need is extra)Step 2: Validate inputs
raw_valuation is a finite non-negative numbervalue_type is one of the three allowed stringsn_informed_bidders is an integer >= 1 (clamp at upper bound if exotic, e.g. 50)signal_dispersion is in [0, 100]Step 3: Short-circuit for private-value
If value_type == "private_value", skip the formula entirely:
haircut_pct = 0adjusted_valuation = raw_valuationapplied = falseSee resources/methodology.md for the Bayesian reason this short-circuit is correct.
Step 4: Compute haircut percentage
For common_value targets:
haircut_pct = min(35, 10 + log(N) x 5 + signal_dispersion x 0.2)
The min(35, ...) ceiling hard-caps the haircut at 35% even at extreme N and dispersion. This reflects that empirical Kagel-Levin estimates rarely exceed 30%; 35% is the outer envelope.
For mixed targets, interpolate:
mix_common_weight = 0.6 (default; caller may override)
mix_private_weight = 1 - mix_common_weight
haircut_pct = mix_common_weight x (common_value_haircut) + mix_private_weight x 0
See resources/methodology.md for formula intuition (log-N captures the adverse-selection severity growing with more competitors; linear dispersion term captures the variance of bidder estimates).
Step 5: Apply haircut
adjusted_valuation = raw_valuation x (1 - haircut_pct / 100)
Step 6: Emit structured output
Return:
{
"adjusted_valuation": <number>,
"haircut_pct": <number in [0, 35]>,
"classification_rationale": "<one-sentence justification>",
"applied": <bool>
}
Validate using resources/evaluators/rubric_auction_winners_curse_haircut.json. Minimum standard: average score >= 3.5.
Pattern 1: Headline Common-Value Target, Many Bidders
auction-first-price-shading for shading)Pattern 2: Private-Value Complement (Handcuff)
private_valuePattern 3: Mixed Late-Season Streaming Claim
mixed with mix_common_weight around 0.5-0.7Pattern 4: Thin-Field Common Value (Low N)
Classification must be explicit. Never infer value_type silently from other inputs. The caller passes it; the skill validates. A missing or ambiguous classification is an error, not a default.
Private-value short-circuit is absolute. If the caller asserts private-value, haircut is zero even when N is large. This is correct: if others genuinely value the target less, then their bids do not carry adverse information about your own estimate.
Never stack this haircut with another winner's-curse correction. Downstream systems that already apply Bayesian bid shading (e.g., auction-first-price-shading's N-bidder shade) are correcting a different phenomenon (strategic shading for expected surplus). Apply both; do not apply either twice.
Cap at 35%. The empirical Kagel-Levin range is 15-30%. The 35% ceiling provides headroom for very large N plus high dispersion but prevents the formula from producing absurd discounts (e.g., 80%).
N >= 1. N = 1 means the bidder is alone; log(1) = 0 so the formula yields haircut_pct = 10 + signal_dispersion x 0.2. For a true monopsony (no competing informed bidder), the caller should pass private_value instead -- there is no adverse-selection mechanism without competitors.
Signal dispersion is a proxy, not a measurement. In practice it is rarely directly observable. Estimate from: historical bid-spread in comparable auctions, disagreement among public projection systems, or degree of public information asymmetry. Document the basis.
Mixed value requires an explicit weight. Do not silently default to 0.6. Callers should state the common/private split and its justification. If they cannot, classify as common_value (conservative) or private_value (aggressive), not mixed.
Domain-neutral contract. This skill does not know about FAAB, fantasy baseball, or any specific auction environment. Callers translate their domain inputs into the generic four-field contract; the skill returns a generic output which the caller then interprets.
Core formula:
if value_type == "private_value":
haircut_pct = 0
applied = false
elif value_type == "common_value":
haircut_pct = min(35, 10 + log(N) x 5 + signal_dispersion x 0.2)
applied = true
elif value_type == "mixed":
common_haircut = min(35, 10 + log(N) x 5 + signal_dispersion x 0.2)
haircut_pct = mix_common_weight x common_haircut # default 0.6
applied = true
adjusted_valuation = raw_valuation x (1 - haircut_pct / 100)
Haircut lookup (common_value, approximate):
| N | dispersion=0 | dispersion=25 | dispersion=50 | dispersion=100 | |---|--------------|---------------|---------------|----------------| | 1 | 10.0% | 15.0% | 20.0% | 30.0% | | 2 | 13.5% | 18.5% | 23.5% | 33.5% | | 4 | 16.9% | 21.9% | 26.9% | 35.0% (cap) | | 6 | 19.0% | 24.0% | 29.0% | 35.0% (cap) | | 8 | 20.4% | 25.4% | 30.4% | 35.0% (cap) | | 12 | 22.4% | 27.4% | 32.4% | 35.0% (cap) |
Input contract:
| Field | Type | Range | Required |
|-------|------|-------|----------|
| raw_valuation | number | >= 0 | yes |
| value_type | string | common_value / private_value / mixed | yes |
| n_informed_bidders | int | >= 1 | yes |
| signal_dispersion | number | [0, 100] | yes |
| mix_common_weight | number | [0, 1] | only if mixed (default 0.6) |
Output contract:
| Field | Type | Range |
|-------|------|-------|
| adjusted_valuation | number | [0, raw_valuation] |
| haircut_pct | number | [0, 40] |
| classification_rationale | string | one sentence |
| applied | bool | false iff private-value |
Key resources:
development
--- name: zettel-note description: The note-writing discipline for this vault's evergreen knowledge graph, modeled on a Zettelkasten reading companion and governed by the vault conventions. Enforces declarative-claim titles, one claim per note (atomicity), own-words prose with no block quotes, the piped [[slug|Title]] link form, the labeled link-relationship vocabulary (Confirms/Contradicts/Extends/Context/Prerequisite/Builds-on/Applies/Example-of/Contrasts-with), 3-6 links per note, and search-
development
Plans between-round FIFA World Cup Fantasy transfers — budgets the round's free transfer(s), forces out players whose nation has been eliminated, chases fixture-swing drops, upgrades on value, and decides when a rebuild is large enough to fire the Wildcard instead of spending free transfers one at a time. Ranks candidate in/out pairs by EV gain over each player's remaining survival horizon (delta xEV weighted by progression_carry) MINUS transfer cost (a free transfer is cheap, a points hit is real, churning the squad for marginal swings is a critic flag), and tags forced/fixture/upgrade priority. Emits a `transfer-plan` signal. Use when called by wc-squad-architect (whose transfer work this skill is the engine for) and by the strategists in the populate stage when their candidate is transfer-adjacent rather than a full rebuild.
testing
Reads and updates the FIFA World Cup Fantasy tournament state machine (footballfantasy/context/tournament-state.md) — the temporal backbone tracking phase (pre-tournament → group MD1-3 → R32 → R16 → QF → SF → final), budget ($100m group / $105m knockouts), nation cap (3 group, loosening in knockouts), chips remaining, surviving nations, each owned player's elimination-risk horizon, and deadlines. Validates state on load (count/feasibility checks), applies phase transitions, and appends to the append-only state log (never silent overwrite). Use to load state at the start of a run and to commit state changes after the manager makes a move.
development
Validates and persists FIFA World Cup Fantasy signal files to signals/YYYY-MM-DD-<type>.md. Checks the required frontmatter (type, round, date, emitted_by, confidence, source_urls), range-checks declared numeric signals, confirms every factual claim carries a source URL or "manager-provided", rejects unknown signal types, and refuses to persist a signal that fails validation (logging the failure instead). Keeps the inter-agent signal layer auditable so downstream agents can trust what they read and never re-derive it. Use whenever an agent or skill writes a signal.