Codebase Exploration
giancarloerra/SocratiCode
Explore and understand codebases using SocratiCode semantic search, dependency graphs, and context artifacts.
This skill should be used when the user asks about "Medicare Advantage margins", "MLR", "Star Ratings", "MA enrolment", "risk adjustment", "MedPAC benchmark", "payor margin normalisation"…
Install Ma Margin Normalization
$ npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install hh-health-AI/healthcare-equity ma-margin-normalization --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/hh-health-AI/healthcare-equity.git skills-src && mkdir -p .claude/skills && cp -r skills-src/modules/provider-economics/skills/ma-margin-normalization .claude/skills/ma-margin-normalization && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "ma-margin-normalization" agent skill from https://github.com/hh-health-AI/healthcare-equity/tree/main/modules/provider-economics/skills/ma-margin-normalization into .claude/skills/ma-margin-normalization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ma-margin-normalization", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/hh-health-AI/healthcare-equity/tree/main/modules/provider-economics/skills/ma-margin-normalizationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install hh-health-AI/healthcare-equity ma-margin-normalization --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hh-health-AI/healthcare-equity.git skills-src && mkdir -p .agents/skills && cp -r skills-src/modules/provider-economics/skills/ma-margin-normalization .agents/skills/ma-margin-normalization && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "ma-margin-normalization" agent skill from https://github.com/hh-health-AI/healthcare-equity/tree/main/modules/provider-economics/skills/ma-margin-normalization into .agents/skills/ma-margin-normalization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ma-margin-normalization", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install hh-health-AI/healthcare-equity ma-margin-normalization --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hh-health-AI/healthcare-equity.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/modules/provider-economics/skills/ma-margin-normalization .cursor/skills/ma-margin-normalization && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "ma-margin-normalization" agent skill from https://github.com/hh-health-AI/healthcare-equity/tree/main/modules/provider-economics/skills/ma-margin-normalization into .cursor/skills/ma-margin-normalization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ma-margin-normalization", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/hh-health-AI/healthcare-equity.git --path modules/provider-economics/skills/ma-margin-normalization--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install hh-health-AI/healthcare-equity ma-margin-normalization --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hh-health-AI/healthcare-equity.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/modules/provider-economics/skills/ma-margin-normalization .gemini/skills/ma-margin-normalization && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "ma-margin-normalization" agent skill from https://github.com/hh-health-AI/healthcare-equity/tree/main/modules/provider-economics/skills/ma-margin-normalization into .gemini/skills/ma-margin-normalization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ma-margin-normalization", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install hh-health-AI/healthcare-equity ma-margin-normalizationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/hh-health-AI/healthcare-equity.git skills-src && mkdir -p .github/skills && cp -r skills-src/modules/provider-economics/skills/ma-margin-normalization .github/skills/ma-margin-normalization && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "ma-margin-normalization" agent skill from https://github.com/hh-health-AI/healthcare-equity/tree/main/modules/provider-economics/skills/ma-margin-normalization into .github/skills/ma-margin-normalization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ma-margin-normalization", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install hh-health-AI/healthcare-equity ma-margin-normalization --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hh-health-AI/healthcare-equity.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/modules/provider-economics/skills/ma-margin-normalization .opencode/skills/ma-margin-normalization && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "ma-margin-normalization" agent skill from https://github.com/hh-health-AI/healthcare-equity/tree/main/modules/provider-economics/skills/ma-margin-normalization into .opencode/skills/ma-margin-normalization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ma-margin-normalization", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
ma-margin-normalization- GitHub stars
- 101
- Token cost
- ~840 tokens
- SKILL.md length
- 396 words
- Files
- 2 (incl. references)
- Skills in repo
- 72
- Repo updated
- First seen
- Licence
- MIT
At a glance
This skill should be used when the user asks about "Medicare Advantage margins", "MLR", "Star Ratings", "MA enrolment", "risk adjustment", "MedPAC benchmark", "payor margin normalisation"…
- Works in 8 steps: Build the enrolment picture. Monthly CMS… → Layer Star Ratings. Published each… → Normalise the margin. MedPAC publishes… → …
- Asks about Medicare Advantage margins
- SKILL.md covers Workflow and Not-automatic
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Ma Margin Normalization is an agent skill from hh-health-AI/healthcare-equity. This skill should be used when the user asks about "Medicare Advantage margins", "MLR", "Star Ratings", "MA enrolment", "risk adjustment", "MedPAC benchmark", "payor margin normalisation", "value-based care economics", or is modelling a managed-care name. Anchors prompt-library IDs SUB-SVC-03 and SUB-SVC-04.
Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/ma-mechanics.md`).
It sits in Databases, covering Database schema design and Prompt engineering. The repository describes itself as: Synthesis engine for buy-side healthcare equity research. The licence is MIT.
When your agent uses it
- Asks about Medicare Advantage margins
- Risk adjustment
- MedPAC benchmark
- Payor margin normalisation
Example prompts
- “Medicare Advantage margins”
- “Star Ratings”
- “MA enrolment”
- “/ma-margin-normalization”
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- Build the enrolment picture. Monthly CMS MA enrolment files by contract, plan
- Layer Star Ratings. Published each October, they determine quality bonus payments
- Normalise the margin. MedPAC publishes benchmark, bid and payment analysis for
- Read the reserve development. Reported MLR is a ratio containing prior-period
- Watch the policy calendar through a reimbursement engine: the annual Advance Notice
- For vertically integrated names, test whether margin is being shifted between the
- For value-based care exposure, identify the contract form — upside-only, two-sided
- Emit the brief.
What it can do on your machine
Read from SKILL.md and the folder at commit 6c7bda8. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Ma Margin Normalization loads about 840 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 396 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from hh-health-AI/healthcare-equity at commit 6c7bda8, republished under its MIT licence (© hh-health-AI). 396 words, ~840 tokens.
Download SKILL.mdSave it as
.claude/skills/ma-margin-normalization/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- ma-margin-normalization
- description
- This skill should be used when the user asks about "Medicare Advantage margins", "MLR", "Star Ratings", "MA enrolment", "risk adjustment", "MedPAC benchmark", "payor margin normalisation", "value-based care economics", or is modelling a managed-care name. Anchors prompt-library IDs SUB-SVC-03 and SUB-SVC-04.
- metadata.version
- 0.1.0
- metadata.layer
- Financial
MA margin normalisation
Normalise a managed-care name's reported margin against open enrolment, Star Ratings and MedPAC benchmark data, so that the reported MLR can be read for what it actually contains.
Workflow
- Build the enrolment picture. Monthly CMS MA enrolment files by contract, plan
and county (
scripts/ma_enrollment.py). Compute growth, and growth mix: which counties, which plan types (HMO, PPO, D-SNP, C-SNP), and which competitor lost the members. Special-needs-plan growth carries a different margin and acuity profile from general-enrolment growth and must be tracked separately. - Layer Star Ratings. Published each October, they determine quality bonus payments two years forward. A rating change is therefore a dated, known revenue event with a two-year lead — one of the cleanest forward-looking data points in the sector. Map the rating change to the share of membership in affected contracts, not to the headline company rating.
- Normalise the margin. MedPAC publishes benchmark, bid and payment analysis for
MA against fee-for-service spending. Use it to separate:
- margin from rate (benchmarks, county rebasing, quality bonus),
- margin from risk-score coding intensity,
- margin from actual medical management. Only the third is durable, and it is the smallest of the three at most plans.
- Read the reserve development. Reported MLR is a ratio containing prior-period
reserve development. Read the development table in the 10-K rather than the ratio.
Favourable development in consecutive years is the sector's most common source of
flattering MLR. Route the accounting question to
sec-forensics→ edgar-forensics. - Watch the policy calendar through a reimbursement engine: the annual Advance Notice and Rate Announcement (February and April), risk-model changes, and RADV audit methodology. These reset the whole industry's economics at fixed dates.
- For vertically integrated names, test whether margin is being shifted between the plan and the owned provider or pharmacy assets. Segment-level margin plus intersegment eliminations is where this shows; a consolidated MLR hides it entirely (SUB-SVC-03).
- For value-based care exposure, identify the contract form — upside-only, two-sided risk, or full capitation — because the earnings quality differs completely between them (SUB-SVC-04).
- Emit the brief.
Show full SKILL.md (55 more words)Show less
Not-automatic
Enrolment growth does not license a margin conclusion. Growth bought with benefit richness is negative-margin growth, and the benefit design is in the plan filings, not in the enrolment file.
Framework anchors: Kongstvedt, Health Insurance and Managed Care; MedPAC annual
reports; Porter and Teisberg, and Christensen, for the value-based-care framing.
Reference: references/ma-mechanics.md. Contract: ../../references/evidence-brief.md.
© hh-health-AI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (references) in modules/provider-economics/skills/ma-margin-normalization of hh-health-AI/healthcare-equity.
- SKILL.md
- references/ma-mechanics.md
Open the folder on GitHubat commit 6c7bda8
Compare with similar skills
Ma Margin Normalization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Ma Margin Normalization this skillhh-health-AI/healthcare-equity | 101 | — | ~840 | Automated safety check: Pass | MIT | |
| Codebase Explorationgiancarloerra/SocratiCode | 3.3k | 1 repos | ~1.5k | Automated safety check: Pass | AGPL-3.0 | |
| Database DesignKbWen/agentic-os | 207 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Tool Schema Designseb1n/awesome-ai-agent-skills | 206 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Together SDK Patternsjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~1k | Automated safety check: Pass | MIT | |
| SQL Optimization Patternsynulihao/AgentSkillOS | 618 | 11 repos | ~3.3k | Automated safety check: Pass | None |
Similar skills
Database Design
KbWen/agentic-os
Design schemas and migrations when persistent data structures change.
Tool Schema Design
seb1n/awesome-ai-agent-skills
Design and validate model-facing tool definitions with clear names, action-oriented descriptions, bounded JSON Schema parameters, explicit side effects, safe defaults, idempotency, errors, and…
Together SDK Patterns
jeremylongshore/tons-of-skills-marketplace
Encapsulate Together AI SDK v2 behind a typed adapter with catalog-resolved models, bounded retries, streaming normalization, usage capture, and OpenAI-compatible migration seams.
SQL Optimization Patterns
ynulihao/AgentSkillOS
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries.
Datamodellm
nimbalyst/nimbalyst
Create visual data models for database schemas using Nimbalyst's DataModelLM editor.
More from hh-health-AI/healthcare-equity
All 72 skills in this repoAdcom Label
hh-health-AI/healthcare-equity
This skill should be used when the user says "prep the AdCom for [asset]", "what will the advisory committee vote", "analyze the approved label", "label delta vs expectations", or within 48 hours of…
Biomedical Claim Checker
hh-health-AI/healthcare-equity
A skill your agent uses to audit whether medical or scientific claims are supported by their citations, verify references, assess AI-generated biomedical text or identify overstatement in a press…
Biomedical Claim Checker
hh-health-AI/healthcare-equity
A skill your agent uses when checking whether a medical or scientific claim is supported by its cited paper, verifying references, auditing an AI-generated biomedical answer or examining…
Biosimilar Erosion
hh-health-AI/healthcare-equity
This skill should be used when the user asks about "biosimilar erosion", "Purple Book", "biologic exclusivity", "interchangeability", "how fast will [biologic] erode", "erosion curve", or needs the…
Biotech Catalyst Radar
hh-health-AI/healthcare-equity
A skill your agent uses for a defined biotech trial watchlist, registry-version comparisons, catalyst calendars or changed enrollment, status and completion estimates.
Biotech Catalyst Radar
hh-health-AI/healthcare-equity
A skill your agent uses to monitor a defined biotech trial watchlist, compare registry versions, build a catalyst calendar or explain changed enrollment, status or completion estimates.
Related
Categories
Questions about Ma Margin Normalization
What does Ma Margin Normalization do?
This skill should be used when the user asks about "Medicare Advantage margins", "MLR", "Star Ratings", "MA enrolment", "risk adjustment", "MedPAC benchmark", "payor margin normalisation"…. Ma Margin Normalization is an agent skill from hh-health-AI/healthcare-equity. This skill should be used when the user asks about "Medicare Advantage margins", "MLR", "Star Ratings", "MA enrolment", "risk adjustment", "MedPAC benchmark", "payor margin normalisation", "value-based care economics", or is modelling a managed-care name.
When should I use Ma Margin Normalization?
Ma Margin Normalization fits situations like: asks about Medicare Advantage margins; risk adjustment; medPAC benchmark; payor margin normalisation.
How do I install Ma Margin Normalization in Claude Code?
Run `npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a claude-code`. Or copy the skill folder (modules/provider-economics/skills/ma-margin-normalization in hh-health-AI/healthcare-equity) into .claude/skills/ma-margin-normalization in your project. Claude Code loads it when a task matches its description.
How do I install Ma Margin Normalization in Codex?
Run `npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a codex`. Or copy the skill folder (modules/provider-economics/skills/ma-margin-normalization in hh-health-AI/healthcare-equity) into .agents/skills/ma-margin-normalization in your project. Codex loads it when a task matches its description.
Can I use Ma Margin Normalization in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hh-health-AI/healthcare-equity --skill ma-margin-normalization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ma-margin-normalization, .gemini/skills/ma-margin-normalization, .github/skills/ma-margin-normalization and .opencode/skills/ma-margin-normalization in your project.
What does Ma Margin Normalization need to run?
SKILL.md names no scripts, command-line tools or credentials: Ma Margin Normalization is instructions for the agent only.
Does Ma Margin Normalization access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Ma Margin Normalization safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Ma Margin Normalization use?
Ma Margin Normalization is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Ma Margin Normalization use?
About 840 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 679 tokens, read only when the agent opens those files.
What are the alternatives to Ma Margin Normalization?
Skills that share tags, products or a category with Ma Margin Normalization: Codebase Exploration (giancarloerra/SocratiCode, 3.3k stars), Database Design (KbWen/agentic-os, 207 stars), Tool Schema Design (seb1n/awesome-ai-agent-skills, 206 stars) and Together SDK Patterns (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Ma Margin Normalization?
hh-health-AI (a GitHub user) maintains it in hh-health-AI/healthcare-equity, which has 101 GitHub stars. The repository holds 72 skills in this directory. The repository was last updated on October 8, 2026.
Source: hh-health-AI/healthcare-equity on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.