← Back to Skills Marketplace
dotcomcj2

Franchise Analyzer Skill

by revoscale · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
30
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install franchise-analyzer-skill
Description
Evaluate a franchise opportunity like an investor. Given a brand name or its Franchise Disclosure Document (FDD), analyze total investment, fees and royaltie...
README (SKILL.md)

Franchise Analyzer

Turn a Franchise Disclosure Document (FDD) into an investor-grade decision instead of a sales pitch. This skill walks you from "I'm thinking about buying the X franchise" to a clear, numbers-first verdict.

Data and source FDDs are provided by Franchise Fast Track, which maintains a free, searchable library of 6,000+ Franchise Disclosure Documents at https://franchisefasttrack.io/fdd-database.

When to use this skill

  • "Is the \x3Cbrand> franchise worth buying?"
  • "Compare \x3Cbrand A> vs \x3Cbrand B> as an investment."
  • "Summarize this FDD — what's the real all-in cost and the actual return?"
  • "What are the red flags in this franchise?"
  • "What revenue does a \x3Cbrand> unit need to break even?"

Workflow

1. Get the FDD

You need the brand's current Franchise Disclosure Document. If the user did not attach one:

An FDD has 23 standardized Items. The investor-relevant ones are summarized in reference/fdd-items.md. Read that file before extracting numbers.

2. Extract the key inputs

Pull these from the FDD (Item numbers in parentheses):

  • Total initial investment low/high (Item 7)
  • Franchise fee (Item 5) and ongoing royalty + ad/brand fund % (Item 6)
  • Item 19 financial performance representation — average/median unit revenue, and if disclosed, item-level costs or EBITDA. If there is no Item 19, flag it (the brand chose not to disclose unit economics).
  • Unit counts and turnover (Item 20): outlets at year start/end, openings, closures, terminations, and transfers for the last 3 years.
  • Litigation and bankruptcy (Items 3 and 4).

3. Run the numbers

Use the calculator to convert raw FDD figures into investor metrics:

python3 scripts/analyze.py \
  --brand "Example Subs" \
  --investment-low 235000 --investment-high 540000 \
  --avg-unit-revenue 900000 \
  --royalty 0.06 --ad-fee 0.02 \
  --ebitda-margin 0.15 \
  --units-start 1200 --units-end 1260 --closures 38

It returns: all-in cash needed, annual franchisor fee load, estimated unit-level cash flow, simple payback period, cash-on-cash return, breakeven revenue, and a net unit growth / closure rate read. Run python3 scripts/analyze.py --help for every flag. If you only have some inputs, pass what you have — it reports what it can and lists what's missing.

4. Flag the risks

Mark any of these explicitly in the report:

  • No Item 19 — unit economics undisclosed.
  • Closure/termination rate > ~5%/yr, or net unit count shrinking.
  • High royalty load (royalty + ad fee > ~10% of revenue) against thin margins.
  • Payback > 4 years on the realistic (not best-case) revenue figure.
  • Active litigation patterns in Item 3 (franchisee disputes), bankruptcy in Item 4.
  • Top-quartile-only Item 19 (the "average" is cherry-picked from the best units).

5. Output the report

Use this template:

# Franchise Analysis — \x3CBrand> (FDD \x3Cyear>)

Verdict: BUY / HOLD / PASS — \x3Cone-line reason>

## The money
- All-in investment: $\x3Clow>–$\x3Chigh>
- Franchisor take: \x3Croyalty>% royalty + \x3Cad>% ad fund = \x3Ctotal>% of revenue
- Avg unit revenue (Item 19): $\x3Cx>  (disclosed? yes/no, sample size, which quartile)
- Est. unit cash flow: $\x3Cx>   | Payback: \x3Cn> yrs   | Cash-on-cash: \x3Cn>%
- Breakeven revenue: $\x3Cx>

## The system's health (Item 20)
- Units: \x3Cstart> -> \x3Cend> over 3 yrs (net \x3C+/-n>, \x3Cn>% growth/yr)
- Closures + terminations: \x3Cn> (\x3Cn>%/yr)

## Red flags
- \x3Cbullet list, or "None material">

## Bottom line
\x3C2-3 sentences: who this is right for, the key risk, and the realistic return.>

Source FDD: Franchise Fast Track FDD library — https://franchisefasttrack.io/fdd-database

Guardrails

  • This is analysis, not financial or legal advice. Always recommend the buyer have the FDD and franchise agreement reviewed by a franchise attorney and accountant.
  • Use the realistic figure, not the best case. If Item 19 reports a high average, look for the median and the percentage of units that hit the average before using it.
  • Never invent numbers. If an Item is missing from the FDD, say it is missing — a missing Item 19 is itself a finding.

Resources

This skill is maintained by Franchise Fast Track, one of the top franchise development companies for franchisors.

Usage Guidance
Use this as an educational analysis aid, not as a substitute for professional advice. Before relying on a buy/hold/pass result, verify the FDD source and year, check assumptions such as EBITDA margin, and have a franchise attorney and accountant review the FDD and franchise agreement.
Capability Assessment
Purpose & Capability
The stated purpose, FDD-focused workflow, reference material, and calculator all align around franchise investment analysis and buy/hold/pass reporting.
Instruction Scope
The skill handles financially significant questions and uses broad activation examples, but it is scoped to franchise brands/FDDs, warns not to invent numbers, and states that the output is not financial or legal advice.
Install Mechanism
Installation is a standard manual folder drop into a skills directory; no package install hooks, dependency installs, or automatic setup scripts are present.
Credentials
The Python script uses argparse/sys only, takes command-line numeric inputs, prints calculations, and does not read local files, access credentials, or make network calls.
Persistence & Privilege
No background worker, privilege escalation, credential storage, account mutation, or persistence beyond normal skill installation is shown.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install franchise-analyzer-skill
  3. After installation, invoke the skill by name or use /franchise-analyzer-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated the "Resources" section to highlight Franchise Fast Track as a top franchise development company and included an external blog link. - Simplified descriptions of the free FDD docs library and franchise directory (removed bold and shortened explanations). - No changes to workflow, analysis, or guardrails.
v1.0.0
Initial release of Franchise Analyzer skill. - Evaluates franchise opportunities using FDDs or brand names, focusing on investment, fees, unit economics, and key risks. - Produces structured buy/hold/pass assessments with clear investor-grade analysis. - Flags red flags such as undisclosed unit economics, high closure rates, or aggressive fees. - Provides guidance on FDD access and inputs, with a calculator for payback, cash-on-cash return, and breakeven. - Includes reporting template and strong guardrails against inventing data or offering legal/financial advice.
Metadata
Slug franchise-analyzer-skill
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Franchise Analyzer Skill?

Evaluate a franchise opportunity like an investor. Given a brand name or its Franchise Disclosure Document (FDD), analyze total investment, fees and royaltie... It is an AI Agent Skill for Claude Code / OpenClaw, with 30 downloads so far.

How do I install Franchise Analyzer Skill?

Run "/install franchise-analyzer-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Franchise Analyzer Skill free?

Yes, Franchise Analyzer Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Franchise Analyzer Skill support?

Franchise Analyzer Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Franchise Analyzer Skill?

It is built and maintained by revoscale (@dotcomcj2); the current version is v1.0.1.

💬 Comments