gaspatchio-model-discovery

Guides a one-question-at-a-time discovery workflow that produces a gaspatchio model specification before any code is written.

4|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/gaspatchio/gaspatchio --skill gaspatchio-model-discovery-gaspatchio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaspatchio-model-discovery
Source: https://github.com/gaspatchio/gaspatchio/tree/main/skills/gaspatchio-model-discovery
Command: npx skills add https://github.com/gaspatchio/gaspatchio --skill gaspatchio-model-discovery-gaspatchio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Actuarial models built without a written specification take longer to debug and often silently diverge from the source system. This Skill enforces a structured discovery phase that pins down the source specification, data shape, assumptions, projection parameters, and outputs before any gaspatchio model code is written. ## Core Features & Use Cases - Hard gate on coding: Blocks model implementation until the user approves a written Gaspatchio Model Specification document. - Data inspection via CLI: Runs gspio describe --json on provided data files to detect table shape, column types, and dimensions before asking questions. - Spreadsheet conversion guidance: Uses the bundled reference on extracting Excel formula graphs with XL Marinade, detecting recurrences, lapse gates, rounding placement, and VLOOKUP overflow traps. - Actuarial knowledge lookup: Queries regulatory and methodology concepts (IFRS 17, Solvency II, mortality) through gspio knowledge instead of guessing. - Use Case: When porting a universal life model from Excel to gaspatchio, the Skill walks you through one question at a time, maps the workbook's formula graph, and produces an approved spec ready to hand to the model-building step. ## Quick Start Ask the assistant to help you plan a new gaspatchio model or port an existing Excel or lifelib model, and it will begin the discovery interview before writing any code.

Frequently Asked Questions about gaspatchio-model-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a gaspatchio actuarial model before writing code?

Run the discovery workflow, which asks one question at a time about your source specification, model points, assumption tables, projection settings, and outputs. It ends with a written model specification you approve before any model code is written.

How do I convert an Excel actuarial model to gaspatchio?

Extract the workbook into a SQLite formula graph with XL Marinade, then scan for row offsets and strongly-connected components to split variables into recurrences and closed-form columns. The bundled spreadsheet-conversion reference covers lapse gates, COI timing conventions, rounding placement, and VLOOKUP overflow traps.

Can I skip discovery if I already know what the model should do?

No. The Skill enforces a hard gate: no model code is written until a specification exists and the user confirms the summary. Even experienced actuaries must pin down data shape, assumptions, projection parameters, and outputs first.

Does the discovery skill work without an existing specification document?

It requires at least one concrete source: a documentation URL, a spec file in the repo, or a named Excel or lifelib model. If none exists, you must confirm that explicitly and create a minimal written spec together before proceeding.

What happens after model discovery is complete?

The approved specification is handed to the gaspatchio-model-building skill for implementation. If a reference model such as Excel or lifelib exists, the workflow hands off to gaspatchio-model-reconciliation for a strict tie-out process.

Why does Excel-to-model conversion produce results that run but are wrong?

Common causes include lapse gates hidden inside schedule lookups, COI timing conventions that agree only when rates are constant, rounding placed outside a recursion, and approximate-match VLOOKUP running past a table's end. The reference document catalogs each failure mode and its detection query.