Renewal and Price-Increase Prep
Overview
Agreement Reconciliation already compares PSA entitlements to invoices. Margin Analysis already turns revenue, marketplace cost, and labor into per-client margin. This companion skill composes those two reads into a short, per-client brief for a renewal or price-increase conversation.
Do not duplicate those skills' workflows. Follow them (or reuse their fresh output) to gather evidence, then write talking points. Never invent a rate, an increase percentage, or a dollar figure. If a number is not returned, omit it and say which source was missing.
Anti-triggers
- Reconciling contract lines to invoices as the main job: use Agreement Reconciliation.
- Computing portfolio or service-line margin as the main job: use Margin Analysis.
- License seat true-up as the main job: use License True-Up.
- Building the renewal calendar itself: use the finance-pack
renewal-calendar-builderagent, or the/finance-pack:renewalscommand, then come back here for talking points on a chosen client.
Connected Systems
This skill uses the same systems as the two source skills. At least one side of the agreement picture (a PSA contract or agreement tool, or an accounting invoice tool) is required. Margin inputs (marketplace cost, time entries, a loaded labor rate supplied by the operator) are optional and must be labeled when missing.
Workflow
Step 1: Discover what is actually connected
Call conduit__search_tools first. Use the exact names discovery returns.
Gateway names often look like <vendor-slug>__<tool_name>. Pax8's hosted
surface uses hyphenated names such as pax8-list-subscriptions.
Only call read-only list, get, or search tools from the allow-list below. Never create, update, send, void, or raw/execute.
Client roster: autotask_search_companies, cw_search_companies,
cw_get_company, halopsa_clients_list, halopsa_clients_get,
halopsa_clients_search, syncro_customers_list,
qbo_customers_list, qbo_customers_get, qbo_customers_search,
xero_contacts_list, xero_contacts_get, xero_contacts_search,
pax8-list-companies.
Agreements and contracts: autotask_list_expiring_contracts,
autotask_search_contracts, autotask_get_contract,
autotask_search_contract_services,
autotask_search_contract_service_units,
autotask_search_contract_service_bundles,
autotask_search_contract_service_bundle_units, cw_search_agreements,
cw_get_agreement, cw_get_agreement_additions.
For a renewal window in Autotask, autotask_list_expiring_contracts
returns contracts whose end date falls within daysAhead days (default
60), optionally scoped to one companyID. Pass includeExpired: true to
also catch contracts already past their end date, and if a full page
comes back the list may be incomplete:
{ "tool": "autotask_list_expiring_contracts", "arguments": { "companyID": 12345, "daysAhead": 90 } }
autotask_search_contracts also accepts endDateFrom and endDateTo
(ISO dates). autotask_get_contract returns header fields only, with no
service lines. Read the lines with autotask_search_contract_services
and autotask_search_contract_service_bundles, and the billed
quantities with the two *_units tools, counting bundle units alongside
service units. The *_units tools return rows active on one activeOn
day (default today), so never rely on the default for a past invoice.
Query both tools at the start and end of the invoice period being
reconciled, and on further dates if the period is long. Matching
endpoint quantities do not rule out a change between them. If the
period coverage or billing treatment cannot be established, mark the
reconciliation incomplete instead of reporting a discrepancy.
HaloPSA MCP has no contract or agreement list tool, and
Syncro MCP has no contract list tool: when those are the only PSA, say
the contract side is unavailable.
Invoices and billing: autotask_search_invoices,
autotask_get_invoice_details, autotask_search_billing_items,
autotask_get_billing_item, cw_search_invoices, cw_get_invoice,
halopsa_invoices_list, halopsa_invoices_get, syncro_invoices_list,
qbo_invoices_list, qbo_invoices_get, xero_invoices_list,
xero_invoices_get. You may use xero_reports_aged_receivables or
qbo_reports_customer_balance as supporting collections context, not as
a substitute for line-level reconciliation.
Marketplace (optional cost and subscription context):
pax8-list-subscriptions, pax8-get-subscription-by-uuid,
pax8-list-invoices, pax8-get-invoice-by-uuid,
sherweb_subscriptions_list, sherweb_subscriptions_get. Only call
these when discovery shows they are callable. Never call
pax8_orders_create, pax8_subscriptions_update, or
sherweb_subscriptions_change_quantity (the first two are not served on
the hosted Pax8 path anyway).
Labor (optional): autotask_search_time_entries,
cw_search_time_entries, cw_get_time_entry. If the operator does not
supply a loaded labor rate, say labor cost could not be estimated. Do
not invent a rate. This is stricter than Margin Analysis: do not use a
PSA billing rate or resource cost rate as a proxy here, because a brief
for a pricing conversation must not rest on an estimated labor cost.
Without an operator-supplied rate, report hours as a fact and show
margin as gross margin excluding labor (labeled that way), or as
unavailable when marketplace cost is also missing.
Delivered work (optional): autotask_search_tickets,
cw_search_tickets, halopsa_tickets_list, syncro_tickets_list.
Use these only to summarize the client's closed work for the value
section. Never create, update, or comment on tickets.
Some accounting reads (QuickBooks Online and Xero) may need an admin grant, because Conduit treats tools it has not classified as admin. If discovery does not show one as callable, treat that input as unavailable.
If a vendor is connected but the needed tool is not in this list, treat that input as unavailable.
Step 2: Reuse the source skills
For the chosen client (or each client in an upcoming renewal window):
- Follow Agreement Reconciliation for entitlement versus invoice findings, including under-billing, over-billing, lapsed agreements still invoiced, and lines that already match.
- Follow Margin Analysis for revenue, marketplace cost, and labor, with the same missing-input labels that skill already requires, but apply the stricter labor-rate rule in Step 1 (operator-supplied rate only).
Do not redo those skills' report formats. Extract the findings you need for the conversation.
Step 3: Write per-client talking points
Produce a brief the account manager can take into a renewal or price-increase conversation:
- Renewal context. What is renewing, and when, from returned contract or agreement dates. If end dates are missing, say so.
- Billing accuracy. A short, plain-language summary of reconciliation findings that should be cleaned up or acknowledged before any commercial conversation. Do not surprise a client with an increase while an over-billing finding is still open.
- Value and delivery evidence. Hours and closed work only as returned by the labor and delivered-work tools above. If those were not connected, omit this section and say why.
- Margin picture. Directional only, and only from Margin Analysis output (for example, "margin on this agreement is thin because marketplace cost rose," citing the returned figures). If cost or labor is missing, say the picture is incomplete.
- Conversation prompts. Questions and points to cover, not a script that invents an increase. If the operator asked for a price-increase recommendation, you may show the arithmetic from returned current amounts, but you must not invent a target percentage or a new price. Leave the decision to the operator.
- Sources and gaps. Which tools were used, and which checks were unavailable (including the HaloPSA and Syncro contract-list gaps).
Amounts in the brief must be copied from tool output or from the two source skills' evidence, with the source named. Do not convert, round into a "cleaner" made-up number, or add a "typical increase."
Error Handling
No client and no renewal window
Ask which client or window to prepare. You may consult the finance-pack
renewals command or renewal-calendar-builder for the list, then
continue here.
Agreement or margin sources are only partly connected
Write a partial brief and list the missing inputs. Do not fill cost, rate, or invoice gaps with estimates unless the operator supplies them and you label them as operator-supplied, not tool-returned.
Reconciliation finds over-billing or a lapsed agreement
Put that finding first in the brief. Do not lead with a price-increase prompt in that situation.
Best Practices
- One client per brief unless the operator asked for a batch of upcoming renewals, in which case keep each client's section self-contained.
- This is an internal talking-points document, not a client-facing proposal.
- Oxford commas, and no em dashes.
Related Skills
- Agreement Reconciliation
- Margin Analysis
- License True-Up, when seat counts are part of the renewal conversation