hashgraph-online/awesome-codex-plugins / plugins/candorsystems/candor-finance/skills/candor-budget
candor-budget
VerifiedShows where the person's money goes from their real records and saves a budget they can hold to, built from what they actually spend and fit to what they say, then keeps it current. Use when the person asks where their money goes, what they spend each month, how much they can save, why they are over this month, or wants a budget, a spending plan, or to change a budget line. For saving toward a specific goal, use candor-plan-a-goal.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.2 KB |
| references/spending-and-capacity.md | markdown | 3.2 KB |
references/spending-and-capacity.md
View on GitHub> The calls below are Candor MCP tool calls. Replace placeholders such as `TRANSACTION_ID` with values from earlier responses; where an `input` names an operation instead of showing an object, `candor_schema` lists its fields.
# Spending periods and capacity
## Reconstruct a period
1. Settle the period, the accounts included, and whether they want cash in
and out or income against expenses.
2. Check coverage before any arithmetic:
```text
candor_get({
"operation": "coverage.get",
"reason": "Check the accounts and months the period can cover"
})
candor_get({
"operation": "transactions.list",
"reason": "Read the period's transactions",
"args": {
"since": "START",
"until": "END",
"limit": 100
}
})
```
3. Drill into a large or unclear category with its own bounded read:
```text
candor_get({
"operation": "transactions.list",
"reason": "Check what this category holds",
"args": {
"category": "CATEGORY",
"since": "START",
"until": "END",
"limit": 100
}
})
```
4. Sort the rows by `cashflow_role`: income, expense, transfer, debt
payment, refund. Only expense counts as spending and only income as
income. Count one-time items apart from the monthly pattern.
5. Report totals with the months and accounts they cover and anything left
out. Keep currencies apart; never combine them at an unstated rate.
Follow every `next_actions` continuation before you call a total complete.
## Compare months
```text
candor_changes({
"since": "START",
"until": "END",
"comparison_since": "PRIOR_START",
"comparison_until": "PRIOR_END",
"reason": "Compare spending this quarter with last quarter"
})
```
With no dates it compares the last complete calendar month with the one
before and states both ranges. These are recorded totals, not rates: a
five-week month is not a raise in spending. When history is incomplete,
Candor withholds the comparison; say so instead of building one by hand.
## How much they can save
1. Start from the reconstructed monthly figures, and compare several months
when pay or spending is seasonal or irregular.
2. Read what is already committed:
```text
candor_get({
"operation": "recurring.list",
"reason": "Read bills and income the plan must carry",
"args": {
"limit": 100
}
})
candor_get({
"operation": "debts.list",
"reason": "Read debt minimums the plan must carry"
})
candor_get({
"operation": "budget.context",
"reason": "Compare the saved budget with what they spend"
})
candor_get({
"operation": "goals.list",
"reason": "Read goals already competing for the money",
"args": {
"limit": 100
}
})
```
3. Give a usual month and a lean month: which income, bills, and one-time
items differ between them, and what is left in each after goals.
4. A capacity estimate is a scenario until they settle on a plan. When they
do, save it as a budget, or as a goal pace through `candor-plan-a-goal`.
## Irregular income
Gig, commission, seasonal, or self-employed pay makes a monthly average
misleading. Use the lean month for the budget's base, and treat the rest as
money to assign when it lands (a goal, the cushion, debt). Ask how they are
paid when the records cannot tell you, and keep their answer as a note tagged
`current_financial_situation`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |