Agent skill

Actuarial Risk Modeling

by magnus919 in magnus919/agent-skills

A skill your agent uses when analyzing, selecting, validating, or communicating models for insurance, actuarial, financial-risk, or other consequential uncertain outcomes.

MITAuto-check passedData & Analytics

Install Actuarial Risk Modeling

skills CLI
$ npx skills add magnus919/agent-skills --skill actuarial-risk-modeling -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install magnus919/agent-skills actuarial-risk-modeling --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/actuarial-risk-modeling .claude/skills/actuarial-risk-modeling && rm -rf skills-src

Use ~/.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/

Facts

Skill name
actuarial-risk-modeling
GitHub stars
115
Token cost
~3.2k tokens
SKILL.md length
1,359 words
Files
16 (incl. scripts, references)
Skills in repo
131
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when analyzing, selecting, validating, or communicating models for insurance, actuarial, financial-risk, or other consequential uncertain outcomes.

  • Works in 9 steps: Frame the decision. State the decision,… → Write the data contract. Define grain,… → Profile before modeling. Inspect… → …
  • Communicating models for insurance
  • SKILL.md covers Overview, When to Use, When Not to Use and Decision Entry Points, plus 10 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Actuarial Risk Modeling is an agent skill from magnus919/agent-skills. Use when analyzing, selecting, validating, or communicating models for insurance, actuarial, financial-risk, or other consequential uncertain outcomes. Covers regression, generalized linear models, frequency-severity, panel and longitudinal data, survival, time series, credibility, reserving, tail risk, calibration, and model governance. Do not use for generic software forecasting, ordinary SaaS financial models, or credentialed actuarial, investment, legal, or regulatory advice without the relevant specialist…

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including scripts and reference files (for example `README.md`, `evals/evals.json` and `references/applications-and-governance.md`).

It sits in Data & Analytics, covering Forecasting and time series, Threat modeling and Performance reviews. The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.

When your agent uses it

  • Communicating models for insurance
  • Other consequential uncertain outcomes
  • Generic software forecasting
  • Ordinary SaaS financial models

Example prompts

  • “/actuarial-risk-modeling”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Frame the decision. State the decision, audience, horizon, unit of observation, estimand or forecast target, action threshold, and cost of…
  2. Write the data contract. Define grain, exposure or offset, outcome support, observation and development windows, censoring/truncation…
  3. Profile before modeling. Inspect distributions, zeros, negatives, skew, tail concentration, dependence, repeated entities, time ordering…
  4. Choose the simplest defensible model family. Match the outcome and data-generating structure before comparing algorithms. Load…
  5. Fit without contaminating evaluation. Treat transformations, imputation, feature selection, calibration, resampling, and hyperparameter…
  6. Diagnose and challenge. Check residual structure, link and variance assumptions, overdispersion, zero inflation, leverage, collinearity…
  7. Validate for use. Use grouped, blocked, or rolling splits when the deployment boundary demands them. Report point accuracy, probabilistic…
  8. Compare and govern. Prefer a transparent model unless a more complex one earns its complexity on the decision-relevant metric and remains…
  9. Communicate the decision. Use templates/model-report.md and state what was observed, inferred, assumed, estimated, not identified, and not…

What it can do on your machine

Read from SKILL.md and the folder at commit 22b4723. 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

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Actuarial Risk Modeling loads about 3.2k tokens when it runs, and up to ~8.4k if it reads all its reference files. Until then it costs about 137 tokens; SKILL.md has 1,359 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~137
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.4k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from magnus919/agent-skills at commit 22b4723, republished under its MIT licence (© magnus919). 1,359 words, ~3,170 tokens.

Download SKILL.mdSave it as .claude/skills/actuarial-risk-modeling/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
actuarial-risk-modeling
description
Use when analyzing, selecting, validating, or communicating models for insurance, actuarial, financial-risk, or other consequential uncertain outcomes. Covers regression, generalized linear models, frequency-severity, panel and longitudinal data, survival, time series, credibility, reserving, tail risk, calibration, and model governance. Do not use for generic software forecasting, ordinary SaaS financial models, or credentialed actuarial, investment, legal, or regulatory advice without the relevant specialist review.
license
MIT

Actuarial and Financial Risk Modeling

Overview

Apply statistical modeling to uncertain outcomes where distributional assumptions, exposure, dependence, tail behavior, calibration, and decision consequences matter. The skill is methodology-first: it teaches model selection and evidence, not a particular library or rating formula.

When to Use

Load this skill when the task involves:

  • insurance pricing, claims, reserving, solvency, risk classification, or experience rating;
  • claim frequency, severity, pure premium, medical expenditure, loss, or event-time outcomes;
  • linear, generalized linear, two-part, count, survival, panel, longitudinal, or tail models;
  • financial returns, volatility, portfolio loss, risk measures, or scenario output;
  • calibration, forecast evaluation, backtesting, model comparison, or assumption diagnosis;
  • explaining model results, uncertainty, limitations, or use controls to decision-makers.

When Not to Use

  • Use the Decision Entry Points table above for adjacent work. In brief: data-scientist owns general statistical, causal, experimental, and machine-learning methodology; financial-modeling owns deterministic operating, SaaS, fundraising, and cash-flow models.
  • Use a named tool skill for operating a forecasting, database, or modeling platform.
  • Do not present output as licensed actuarial, investment, legal, accounting, or regulatory advice. Escalate consequential decisions to qualified practitioners and applicable standards.

Decision Entry Points

Starting situationFirst moveLoad next
Policy, claim, or loss dataDefine grain, exposure, target, and horizonreferences/problem-framing.md
Claims development triangle or reserve estimateIdentify accident/development/calendar structure and valuation boundaryreferences/applications-and-governance.md + references/validation-and-calibration.md
Financial returns, volatility, or ordered observationsDefine information cutoff and forecast horizonreferences/model-families.md + references/validation-and-calibration.md
Deterministic SaaS, cash-flow, or fundraising modelRoute out of this skillfinancial-modeling
Generic causal, experimental, or ML methodologyRoute out of this skilldata-scientist

Core Workflow

  1. Frame the decision. State the decision, audience, horizon, unit of observation, estimand or forecast target, action threshold, and cost of false positives and negatives. Separate descriptive, predictive, and causal questions.

  2. Write the data contract. Define grain, exposure or offset, outcome support, observation and development windows, censoring/truncation, policy or account boundaries, leakage risks, missingness states, and provenance.

  3. Profile before modeling. Inspect distributions, zeros, negatives, skew, tail concentration, dependence, repeated entities, time ordering, category sparsity, exposure balance, and data-quality exceptions. Use scripts/risk_preflight.py for a read-only first pass.

  4. Choose the simplest defensible model family. Match the outcome and data-generating structure before comparing algorithms. Load references/model-families.md for the decision table.

    Model-selection quick pick: counts with exposure → count GLM with an offset; zero plus positive loss → two-part/frequency-severity; event time with censoring → survival; ordered observations → dynamic/time-series model; tail decision → tail-aware or quantile model plus stress sensitivity. Load references/model-families.md before choosing a specific distribution or link.

  5. Fit without contaminating evaluation. Treat transformations, imputation, feature selection, calibration, resampling, and hyperparameter choices as part of the fitted procedure. Fit them only on the permitted training partition.

  6. Diagnose and challenge. Check residual structure, link and variance assumptions, overdispersion, zero inflation, leverage, collinearity, separation, calibration, dependence, censoring, tail fit, and sensitivity to plausible alternatives. A convergence flag is not validation.

  7. Validate for use. Use grouped, blocked, or rolling splits when the deployment boundary demands them. Report point accuracy, probabilistic scores, calibration, ranking, tail or aggregate-loss behavior, stability across segments, and uncertainty. Use scripts/temporal_split_audit.py to audit time-ordered partitions.

    Validation-design quick pick: exchangeable observations → random holdout; repeated entities or clusters → grouped split; ordered deployment → blocked or rolling-origin split; overlapping development or labels → gap/embargo; extensive tuning or candidate comparison → nested validation. Load references/validation-and-calibration.md before fixing the final design.

  8. Compare and govern. Prefer a transparent model unless a more complex one earns its complexity on the decision-relevant metric and remains stable, interpretable enough, and monitorable. Record assumptions, overrides, limitations, approvals, and rollback or review triggers.

  9. Communicate the decision. Use templates/model-report.md and state what was observed, inferred, assumed, estimated, not identified, and not tested. Include units, intervals, scenario definitions, diagnostics, and a plain-language recommendation.

Required Distinctions

  • Frequency is not severity. A count model and a positive-loss model have different supports, exposures, diagnostics, and aggregation rules.
  • Prediction is not causation. A useful rating variable is not automatically a fair causal explanation or a permitted classification factor.
  • Calibration is not discrimination. A model can rank well while producing systematically wrong probabilities.
  • Backtesting is not proof. Historical success can reflect regime, selection, leakage, or unavailable information.
  • Uncertainty is layered. Separate sampling error, parameter uncertainty, process variance, model-form uncertainty, scenario uncertainty, and data-quality uncertainty.
  • A reserve or risk estimate is a decision input. It is not an objective fact independent of horizon, assumptions, and intended use.

Minimum Analysis Contract

Before presenting a recommendation, state: the decision and estimand; row grain, horizon, exposure, and information cutoff; candidate model family and why its support/dependence assumptions fit; validation boundary and metrics; uncertainty and sensitivity; limitations and permitted use. If one of these is unknown, label it as an unresolved input rather than silently choosing a convention.

Failure-Mode Quick Map

SymptomFirst checksRoute
Many zeros or variance above the meanExposure, structural zeros, overdispersion, dependencereferences/model-families.md
Strong ranking but wrong probabilitiesSegment calibration, population shift, recalibration boundaryreferences/validation-and-calibration.md
Random CV beats next-period performanceFeature availability, entity/time leakage, revisions, driftreferences/validation-and-calibration.md
Estimate moves with a few large lossesProvenance, tail fit, threshold, stress and scenario sensitivityreferences/applications-and-governance.md
“No event” before full developmentCensoring, observation horizon, reporting lagreferences/problem-framing.md
Show full SKILL.md (510 more words)Show less

Reference Routing

ReferenceLoad when
Problem framingThe target, grain, exposure, estimand, or decision is ambiguous
Model familiesSelecting regression, GLM, count, severity, survival, panel, time-series, or tail models
Validation and calibrationDesigning splits, backtests, metrics, calibration, uncertainty, or stress tests
Applications and governanceWorking on pricing, reserving, solvency, credibility, risk classification, or model use controls
Diagnostics and communicationReviewing assumptions, interpreting output, or writing a decision-safe report
Source indexChecking authoritative references, scope, or currency

Templates and Scripts

Use the templates by stage: model-brief.md before data work; validation-plan.md before fitting or release; model-report.md for findings and decisions; model-governance-record.md for controlled deployment, review, monitoring, or retirement.

First-pass scripts are read-only: run python3 scripts/risk_preflight.py input.csv --output preflight.json before fitting, and python3 scripts/temporal_split_audit.py observations.csv --time-column observed_at --output splits.json when ordered data or forecast leakage is possible.

  • templates/model-brief.md — decision, data contract, estimand, and acceptance criteria.
  • templates/validation-plan.md — split design, metrics, calibration, stress tests, and release gates.
  • templates/model-report.md — evidence-led analysis and communication structure.
  • templates/model-governance-record.md — ownership, assumptions, limitations, approvals, monitoring, and retirement triggers.
  • scripts/risk_preflight.py — dependency-free, read-only CSV/JSONL profiling with machine-readable output.
  • scripts/temporal_split_audit.py — dependency-free audit of chronological train/test windows and leakage boundaries.

Available Scripts

ScriptPurposeInvocation
scripts/risk_preflight.pyRead-only profiling pass over a CSV or JSONL input: distributions, zeros, negatives, skew, repeated entities, exposure balance, and data-quality exceptions, written as machine-readable JSON. Run it at workflow step 3, before any modeling, to profile the data before framing the model family.python3 scripts/risk_preflight.py input.csv --output preflight.json
scripts/temporal_split_audit.pyAudits chronological train/test windows and leakage boundaries in an ordered observation file (--time-column required; optional --test-size, --step, --gap, --output). Run it at workflow step 7 whenever observations are time-ordered or forecast leakage is possible, before trusting any validation result.python3 scripts/temporal_split_audit.py observations.csv --time-column observed_at --output splits.json
scripts/test_risk_scripts.pyOffline pytest suite covering both scripts above. Run it if you modify either script or when auditing a change to their output.python3 -m pytest scripts/test_risk_scripts.py

Both analysis scripts are dependency-free and never modify their inputs.

Completion Gate

Do not call a model analysis complete until the decision and data contract are explicit, the evaluation design matches intended use, diagnostics and sensitivity are recorded, uncertainty and limitations are stated, and an independent reader could reproduce the reported result from the cited data, code, assumptions, and environment.

Prerequisites

  • Python 3 with standard library only; both analysis scripts are dependency-free and require no third-party packages.
  • A CSV or JSONL input with a documented data contract: grain, exposure or offset, outcome support, observation window, and time column (for the split audit) — the scripts profile what you point them at, not what the data means.
  • pytest only when running the bundled script tests.

Limitations

  • The scripts perform first-pass profiling and split auditing only: no model fitting, selection, calibration, or validation metrics happen here, and a clean preflight does not validate a model.
  • Neither script modifies its inputs; both write reports to stdout or an --output path for you to interpret under the Required Distinctions above.
  • Output is evidence about the data and partition design, not licensed actuarial, investment, legal, accounting, or regulatory advice (see When Not to Use).

© magnus919, 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 15 other files (scripts, references) in actuarial-risk-modeling of magnus919/agent-skills.

  • SKILL.md
  • README.md
  • evals/evals.json
  • references/applications-and-governance.md
  • references/diagnostics-and-communication.md
  • references/model-families.md
  • references/problem-framing.md
  • references/source-index.md
  • references/validation-and-calibration.md
  • scripts/risk_preflight.py
  • scripts/temporal_split_audit.py
  • scripts/test_risk_scripts.py
  • templates/model-brief.md
  • templates/model-governance-record.md
  • templates/model-report.md
  • templates/validation-plan.md

Open the folder on GitHubat commit 22b4723

Compare with similar skills

Actuarial Risk Modeling 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.

Actuarial Risk Modeling compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Actuarial Risk Modeling this skillmagnus919/agent-skills115—~3.2kAutomated safety check: PassMIT
Forecastingericrisco/rsc-harness180—~2.8kAutomated safety check: PassMIT
Bayesian Reasoning Calibrationlyndonkl/claude164—~1.6kAutomated safety check: PassNone
CharlieEveryInc/charlie-cfo-skill323—~1.4kAutomated safety check: PassMIT
Financial Modelingcbrock84/headcount2k—~1.1kAutomated safety check: PassMIT
Historical Cost Analyzerdatadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction3451 repos~4.1kAutomated safety check: PassMIT

Similar skills

  • Forecasting

    ericrisco/rsc-harness

    A skill your agent uses when projecting history forward — sales, demand, units, revenue, signups, traffic — into a defensible number with an error band: method by data shape, rolling-origin…

    180 GitHub stars~2.8k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Applies Bayesian reasoning to systematically update probability estimates with new evidence, helping make better forecasts and avoid overconfidence.

    164 GitHub stars~1.6k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Charlie

    EveryInc/charlie-cfo-skill

    Your AI CFO for bootstrapped startups, named after Charlie Munger who embodied the principle that capital discipline is a competitive advantage.

    323 GitHub stars~1.4k tokensUpdated 8 mo ago
    Business, Finance & HRAuto-check passed
  • Financial Modeling

    cbrock84/headcount

    Builds and stress-tests financial models for forecasting, scenario planning, and decision support — revenue build, cost structure, driver logic, and the sensitivities that show where a plan breaks.

    2k GitHub stars~1.1k tokensUpdated 23 days ago
    Business, Finance & HRAuto-check passed
  • Historical Cost Analyzer

    datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

    Analyze historical construction costs for benchmarking, trend analysis, and estimating calibration.

    345 GitHub starsUsed in 1 repo~4.1k tokens
    Business, Finance & HRAuto-check passed
  • SaaS Churn Analysis

    LeoYeAI/openclaw-master-skills

    SaaS churn and retention analysis: cohort-based churn rates, retention curves, revenue churn vs logo churn, at-risk customer identification, expansion vs contraction MRR, churn recovery playbooks…

    2.2k GitHub stars~5k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed

More from magnus919/agent-skills

All 131 skills in this repo
  • Artifact Pyramids

    magnus919/agent-skills

    Organize durable agent research outputs as summaries, analysis, and evidence dossiers.

    119 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Ascii City Engine

    magnus919/agent-skills

    Build portable, first-person colored ASCII city engines and small GIS-derived city packs.

    119 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Color Management

    magnus919/agent-skills

    Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.

    119 GitHub stars~2.6k tokensUpdated today
    Auto-check: notes
  • Data Scientist

    magnus919/agent-skills

    A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…

    119 GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • Docker Compose

    magnus919/agent-skills

    Use Docker Compose to define, run, debug, and harden multi-container applications.

    119 GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Fpga Development

    magnus919/agent-skills

    Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.

    119 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Questions about Actuarial Risk Modeling

What does Actuarial Risk Modeling do?

A skill your agent uses when analyzing, selecting, validating, or communicating models for insurance, actuarial, financial-risk, or other consequential uncertain outcomes. Actuarial Risk Modeling is an agent skill from magnus919/agent-skills. Use when analyzing, selecting, validating, or communicating models for insurance, actuarial, financial-risk, or other consequential uncertain outcomes.

When should I use Actuarial Risk Modeling?

Actuarial Risk Modeling fits situations like: communicating models for insurance; other consequential uncertain outcomes; generic software forecasting; ordinary SaaS financial models.

How do I install Actuarial Risk Modeling in Claude Code?

Run `npx skills add magnus919/agent-skills --skill actuarial-risk-modeling -a claude-code`. Or copy the skill folder (actuarial-risk-modeling in magnus919/agent-skills) into .claude/skills/actuarial-risk-modeling in your project. Claude Code loads it when a task matches its description.

How do I install Actuarial Risk Modeling in Codex?

Run `npx skills add magnus919/agent-skills --skill actuarial-risk-modeling -a codex`. Or copy the skill folder (actuarial-risk-modeling in magnus919/agent-skills) into .agents/skills/actuarial-risk-modeling in your project. Codex loads it when a task matches its description.

Can I use Actuarial Risk Modeling 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 magnus919/agent-skills --skill actuarial-risk-modeling -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/actuarial-risk-modeling, .gemini/skills/actuarial-risk-modeling, .github/skills/actuarial-risk-modeling and .opencode/skills/actuarial-risk-modeling in your project.

What does Actuarial Risk Modeling need to run?

Going by SKILL.md and its folder, Actuarial Risk Modeling needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Actuarial Risk Modeling 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 Actuarial Risk Modeling 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Actuarial Risk Modeling use?

Actuarial Risk Modeling is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Actuarial Risk Modeling use?

About 3.2k tokens (SKILL.md is roughly 13k 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 5.2k tokens, read only when the agent opens those files.

What are the alternatives to Actuarial Risk Modeling?

Skills that share tags, products or a category with Actuarial Risk Modeling: Forecasting (ericrisco/rsc-harness, 180 stars), Bayesian Reasoning Calibration (lyndonkl/claude, 164 stars), Charlie (EveryInc/charlie-cfo-skill, 323 stars) and Financial Modeling (cbrock84/headcount, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Actuarial Risk Modeling?

magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 115 GitHub stars. The repository holds 131 skills in this directory. The repository was last updated on October 10, 2026.

Source: magnus919/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.