agentleFS
tatashbartatashbar/Economic-Modeling-Studio/.agents/skills/debt-decomposition/SKILL.md

debt-decomposition

Skill4 starsChanged 6 days agoMITView on GitHub

Decomposes changes in debt ratios into drivers (interest, growth, primary balance, policy, exchange rate, stock-flow) by country and aggregated by group.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    If a required input is ABSENT, that part is NOT ASSESSED — NO DATA: do not estimate or invent it.

    line 28
  2. Very specific:

    Collaboration: Follow .claude/docs/collaboration-protocol.md: ask questions first, present options, get approval before writing files, and …

    line 30
  3. Distinctive:

    When replicating, write the author's formulas and assumptions as stated, including the residual definition

    line 52
  4. Distinctive:

    After the formulas: confirm framework, assumptions and the residual definition

    line 61
  5. Distinctive:

    After the replication check: confirm the match before comparing frameworks

    line 62
  6. Distinctive:

    Before charts: confirm groups, ordering and labels

    line 63

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md
<!-- Generated from .claude/skills/debt-decomposition/SKILL.md by tools/sync_agents.py. Edit the source, then run the script. -->

/debt-decomposition — Debt Decomposition

Category: Analysis · Primary agent: debt-sustainability-analyst

Decomposes changes in debt ratios into drivers (interest, growth, primary balance, policy, exchange rate, stock-flow) by country and aggregated by group.

Arguments: whatever the user wrote after the command name.

Purpose

Explain why public (or external) debt ratios change over a historical or projection period: how much comes from interest costs, nominal growth, the primary balance and its policy and non-policy parts, exchange-rate valuation of foreign-currency debt, and stock-flow adjustments. The decomposition is computed country by country and aggregated by region or other group so that group contributions add up exactly. When a user brings an existing decomposition, the skill reproduces it first, then compares it with the standard debt-dynamics identity.

Use it when a chart or table needs the drivers of debt changes across countries, or an existing spreadsheet decomposition must be replicated and checked.

Do not use it when the question is whether debt is sustainable under stress (/debt-sustainability).

Before you start

  1. Check required inputs. For each input below record FOUND or ABSENT (never 'assumed'):
    • Gross debt (levels or ratios), nominal GDP, overall and primary balances by country and year
    • Foreign-currency debt share or stock and exchange rates (for the valuation term)
    • A policy measure for the fiscal split (for example the structural or cyclically adjusted balance, or measures data) (optional)
    • Country classification for groups; an existing decomposition to replicate (optional) If a required input is ABSENT, that part is NOT ASSESSED — NO DATA: do not estimate or invent it; name what is missing and which skill produces it. If all required inputs are absent, stop and say so.
  2. Check confidentiality. Identify the data classification level of the inputs (.claude/docs/confidentiality-and-ai-use.md). Do not proceed with restricted or confidential data in a way the policy does not allow.
  3. Collaboration. Follow .claude/docs/collaboration-protocol.md: ask questions first, present options, get approval before writing files, and update production/session-state/active.md after each approved section.

Agents

  • debt-sustainability-analyst — primary agent; coordinates the work and integrates results
  • cross-country-indicators-specialist — Builds cross-country indicator analyses from panel databases: country groups, constant samples, aggregation, vulnerability thresholds, heatmaps and typologies
  • fiscal-risk-specialist — Assesses fiscal risks
  • national-accounts-specialist — Specializes in national accounts and macro statistics

Each agent is defined in .claude/agents/<name>.md. If your tool runs subagents, run these agents as subagents, in parallel where the steps are independent; otherwise read each agent's file and apply its instructions in turn. Subagents only write to the paths named in your instructions.

Key design decisions (present options, let the user choose)

DecisionTypical optionsWhat it changes
Frameworkstandard debt-dynamics identity (interest, real growth, inflation, exchange rate, primary balance, residual); a user-specified bottom-up splitWhich drivers exist and how the residual is defined
Measurementchange in the debt ratio; change in debt in a common currencyAggregation across countries; exchange-rate effects inside other terms
Fiscal splitprimary balance only; policy versus non-policy using structural balance or measures dataWhether "policy" is identified and how well
Exchange-rate termforeign-currency share of debt with bilateral rates; all foreign-currency debt in US dollarsValuation effect size
Aggregationsum of country contributions in common currency over group GDP; GDP-weighted; simple averageGroup results and their weights
Sampleconstant sample of countries with complete data; all availableComparability across years

Workflow

  1. Agree the framework, measurement, sample and groups; write the formulas for every term
    • When replicating, write the author's formulas and assumptions as stated, including the residual definition
  2. Build the tidy panel and the constant sample; report sample sizes by group
  3. Compute the decomposition country by country; check that the terms sum exactly to the change (residual reported as its own term)
  4. Aggregate to groups and the total; check that group contributions add up to the total
  5. Replication check against the supplied numbers, within tolerance; log any discrepancy and its cause
  6. Compare with the standard identity: same drivers ranked the same way? Where do they differ and why?
  7. Sensitivity: base year, currency, foreign-currency assumption, policy measure, sample

Checkpoints with the user

  • After the formulas: confirm framework, assumptions and the residual definition
  • After the replication check: confirm the match before comparing frameworks
  • Before charts: confirm groups, ordering and labels

Common pitfalls

  • A large residual reported as "other" without explanation
  • Exchange-rate valuation mixed into growth or into the residual when debt is measured in a common currency
  • Policy effects inferred from structural balances without saying how noisy they are
  • Group results that move because the sample changed
  • Contributions that do not add up to the total
  • A base-year level subtracted once while flows are summed over several years, so the level carried forward is labelled as a change
  • A valuation term that does not match the currency of measurement (with debt in US dollars, depreciation changes the dollar value of local-currency debt, not of foreign-currency debt)

Output

docs/models/<name>/debt-decomposition.md; code and data in models/semi-structural/<name>/

The report states the framework and formulas, sample and groups, country and group contributions, the replication check, the comparison with the standard identity and the sensitivity results. Every run saves its results to output/<run-id>/ in the model folder, with a run log (.claude/rules/model-code.md).

Gate / verdict

  • Terms sum exactly to the change for every country and group, with the residual shown
  • Group contributions add up to the total
  • Replication of any supplied decomposition is within tolerance or explained
  • Sample, weights and vintage are stated on every chart

Suggested next steps

  • /debt-sustainability
  • /vulnerability-dashboard
  • /chart-pack

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.