kelly-deal-scorer
Busabase App-in-Skill review queue that scores candidate SME financing deals (revenue-based/RBF-style credit) with a deterministic, fully auditable rule-based rubric — never an LLM or API call. Use wh
SKILL.mdskills/kelly-deal-scorer/SKILL.md
GitHubDeal Scoring Desk
Overview
Use this skill as a Busabase-backed review-queue desk for a generic SME financing deal desk (private-credit / revenue-based-financing style). It holds a mock queue of candidate businesses (name, category, city, monthly revenue history, requested principal, red flags) and computes a deterministic composite score (0-100) per candidate with a full, hand-recomputable breakdown: each sub-factor's raw score, weight, and contribution, plus a suggested revenue-share rate range. This is a generic, brand-free tool — it does not reference any specific real company, lender, or fund.
The scoring rubric is plain arithmetic in content/kelly-deal-scorer-app/app/js/scorer-model.js, not
an LLM or API call. Every number the app shows can be recomputed with a
calculator from the candidate's raw fields and the rubric weights in the
settings Base.
Default behavior is AirApp-first. Unless the user explicitly asks only for
explanation, ensure the mock queue exists (run the seed script below if the
candidates Base is empty) and give the user the clickable AirApp URL (or
the local preview URL when local preview is explicitly requested). Use
chat-only mode only when the user says "纯聊天", "chat only", "不要打开 UI", or
similar.
App UI Screenshots
<table> <tr> <td width="50%"><img src="assets/screenshots/overview.webp" alt="Deal Scoring Desk overview"></td> <td width="50%"><img src="assets/screenshots/candidate-detail.webp" alt="Deal Scoring Desk candidate detail"></td> </tr> <tr> <td><strong>Overview</strong><br>Queue-level summary header — score distribution, counts needing review vs. high-confidence — plus the candidate list.</td> <td><strong>Candidate detail</strong><br>Revenue history, red flags, requested principal, and the decision row (approve for term sheet / send back for more data / reject).</td> </tr> <tr> <td width="50%"><img src="assets/screenshots/score-breakdown.webp" alt="Deal Scoring Desk score breakdown"></td> <td width="50%"></td> </tr> <tr> <td><strong>Score breakdown</strong><br>Per-factor raw score, weight, and contribution with an arithmetic trace for every sub-factor, plus the suggested revenue-share rate range.</td> <td></td> </tr> </table>Mandatory Dependencies
- Read and follow
$kelly-app-skill-creatorfor product behavior, visual quality, responsive layout, and the complete canonicalcontent/kelly-deal-scorer-app/artifact. - Read and follow
$busabasefor connection, target Space, node discovery, ChangeRequests, review, and merge behavior. - Read and follow
$busabase-app-creatorfor resource modeling, AirApp runtime limits, security, validation, and deployment.
If a dependency is unavailable, preserve this skill's local artifact and product contracts, stop before the unavailable Busabase operation, and report the exact missing dependency. Do not invent a second data backend.
Boundary
- Review-only. The skill scores a candidate queue and records human decisions in Busabase; it never wires money, signs a term sheet, or contacts a business.
- NEVER treat the composite score as legal or financial advice, and never
auto-approve: a human decision (
approve_term_sheet/send_back_for_data/reject) is always required beforescripts/execute_decisions.mjsmarks a candidatedone. - The AirApp reads and writes its own two Busabase Bases only.
- Treat candidate financials as sensitive review data; the composite score and every intermediate number are always recomputed client-side from the candidate's raw fields, never fabricated.
Busabase Resources
Two Bases under one application Folder (kelly-deal-scorer), declared in
content/kelly-deal-scorer-app/app/js/config.js and the generated template sidecars under content/:
candidates: one row per candidate business — raw underwriting fields (category, city, requested principal, monthly revenue history, red flags) plus the reviewer's decision (decision-action/decision-comment/decided-at) and workflowstatus, all written directly onto the same row. The composite score breakdown is never stored — it is recomputed client-side from the raw fields on every read.settings: up to two rows, keyed byrecord-id/kind:config(base currency + an optional rubric override for the fund's underwriting policy) andrun(the current queue's batch id + generated-at).
Resources provision lazily through an idempotent Busabase ChangeRequest the
first time the app runs in a Space; see references/scoring-schema.md for
exact field shapes.
First Run And Onboarding
On invocation, check the candidates Base. If it's empty, run the trusted
seed script to generate the fixed mock queue:
node skills/kelly-deal-scorer/scripts/generate_batch.mjs --apply
There are no credentials to collect beyond Busabase itself — onboarding is
just confirming the rubric weights and category risk tiers in the settings
Base's config row match the fund's underwriting policy (defaults apply if
omitted).
Local App
Default behavior is AirApp-first — give the user the clickable AirApp URL.
Start pnpm --dir content/kelly-deal-scorer-app dev only when local preview/debugging is explicitly
requested.
Required app views (hash routes):
#/overview: queue-level summary — score distribution (high-confidence / needs review / low-confidence), workflow counts, and the candidate list.#/candidatesand#/candidates/<id>: the full queue, filterable by status; detail shows revenue history, red flags, requested principal, score breakdown, suggested revenue-share range, and the decision row. Decisions write directly onto the candidate record throughbusabase-sdk.#/settings: sanitized rubric summary (weights, thresholds), active data provider, and onboarding state.
Demo Mode
?demo=1opens a deterministic, fully offline mock queue (8 candidates across F&B/Retail/Fitness/Education) for documentation and screenshots. Demo mode never reads or writes Busabase.lang=enorlang=zhforces UI chrome language for screenshots.
UI language: English and Chinese chrome with Auto default.
Workflow
node scripts/generate_batch.mjs --apply(dry run without--apply) writes the fixed 8-candidate mock queue to thecandidatesBase (resetting every candidate's decision fields toneeds_review) and refreshes thesettingsBase'srunrow — run it once at setup, and again any time the demo queue needs resetting.- Open the app. Overview shows the score distribution and workflow counts; Candidates lists every candidate, filterable by status.
- For each candidate, open the detail view, review the revenue history
chart, red flags, and the full score breakdown (every sub-factor's raw
score/weight/contribution with an arithmetic trace), then record
Approve for term sheet/Send back for more data/Rejectwith an optional note — written straight onto the candidate record. node scripts/execute_decisions.mjs --apply(dry run without--apply) re-reads Busabase and marks everyapprovedcandidatedone, preparing the local term-sheet-draft artifact at the suggested revenue-share rate. It performs no external side effect — no wiring, no signing, no contacting the business.
Read references/scoring-schema.md before editing the app, scripts, or
content/kelly-deal-scorer-app/app/js/scorer-model.js.
The Rubric (not a model)
content/kelly-deal-scorer-app/app/js/scorer-model.js documents and implements the entire scoring
rubric: five weighted 0-100 sub-factors (revenue stability, growth trend,
category risk tier, principal-to-revenue ratio, track record & scale), each
with a human-readable arithmetic trace in detail. computeScore() is a
pure function — same inputs always produce the same composite score and
suggested revenue-share range, so a human reviewer can check every number
with a calculator. It backs the trusted seed script
(scripts/generate_batch.mjs), the live Busabase read path
(content/kelly-deal-scorer-app/app/js/providers/busabase-provider.js), and the offline ?demo=
scenario (content/kelly-deal-scorer-app/app/js/providers/demo-provider.js), so all three always
agree on scoring.
Safety
- Deterministic scoring only: never call an LLM or external API to produce a
candidate's score —
content/kelly-deal-scorer-app/app/js/scorer-model.jsis plain arithmetic so every number is auditable. - Never auto-execute a decision the human has not made.
- Do not invent candidates outside the fixed seed set; if the user wants a
different queue, add to
content/kelly-deal-scorer-app/app/js/scorer-model.js'sCANDIDATE_SEEDSand re-run the seed script.
Useful Commands
node skills/kelly-deal-scorer/scripts/generate_batch.mjs --apply
node skills/kelly-deal-scorer/scripts/execute_decisions.mjs --apply
pnpm --dir skills/kelly-deal-scorer/content/kelly-deal-scorer-app dev