← 返回 Skills 市场
dotcomcj2

Franchise Analyzer Skill

作者 revoscale · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
30
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install 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...
使用说明 (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.

安全使用建议
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install franchise-analyzer-skill
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /franchise-analyzer-skill 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug franchise-analyzer-skill
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 30 次。

如何安装 Franchise Analyzer Skill?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install franchise-analyzer-skill」即可一键安装,无需额外配置。

Franchise Analyzer Skill 是免费的吗?

是的,Franchise Analyzer Skill 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Franchise Analyzer Skill 支持哪些平台?

Franchise Analyzer Skill 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Franchise Analyzer Skill?

由 revoscale(@dotcomcj2)开发并维护,当前版本 v1.0.1。

💬 留言讨论