Skip to main content
skill CX Codex

qualitative-valuation — Claude Code skill: how to install

Evaluates business quality, economic moats, and corporate governance beyond pure spreadsheet models. Useful for equity research and spotting accounting red flags.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add JoelLewis/finance_skills --skill qualitative-valuation -a claude-code
Open on GitHub

What qualitative-valuation does

The skill evaluates business defensibility using the Morningstar framework across five moat sources: network effects, switching costs, intangible assets, cost advantages, and efficient scale. It grounds qualitative assertions in hard operational figures. Claiming switching costs requires enterprise gross retention above 90% or net revenue retention exceeding 100%.

Findings map directly into valuation inputs. A verified wide moat justifies trimming the discount rate by 0.5 to 1.0 percentage points or extending excess returns fade to 20 years. Conversely, aggressive accounting or frequent CFO departures add 0.5 to 1.5 percentage points to the discount rate. If total discount rate adjustments exceed 2 percentage points, the skill directs you to revise the base cash flow model instead of stacking adjustments.

The checklist flags divergences between net income and operating cash flow, related-party transactions, and serial dilutive acquisitions. Narrative claims without pricing power or retention proof get rejected.

What it helps with

  • assess economic moat sources and durability using retention data
  • calibrate DCF discount rates and return fade periods
  • detect aggressive accounting practices and cash-earnings divergence
  • evaluate management capital allocation track records

Example prompts for the agent

  • Evaluate whether this enterprise SaaS business has an economic moat given 95% gross retention.
  • Audit the latest filings for accounting red flags and divergence between net income and operating cash flow.
  • Calibrate the discount rate adjustment for an unmitigated regulatory exposure.

How to install qualitative-valuation

1Skills CLI (Vercel)

npx skills add JoelLewis/finance_skills --skill qualitative-valuation -a claude-code

2Manually: put the files in place

~/.claude/skills/qualitative-valuation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/qualitative-valuation/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about qualitative-valuation

How to install qualitative-valuation in Claude Code?

Run npx skills add JoelLewis/finance_skills --skill qualitative-valuation -a claude-code. Alternatively, add the file directly at ~/.claude/skills/qualitative-valuation/SKILL.md.

What does qualitative-valuation do?

It assesses competitive advantages, moat duration, and governance risks using concrete financial thresholds. It then translates these qualitative insights into specific adjustments for discount rates and terminal fade assumptions.

How does the skill qualify pricing power?

It looks for realized price hikes at or above inflation without volume drops or customer churn. Gross margins must also hold or expand during input-cost pressure cycles.

Source text

SKILL.md · MIT
---
name: qualitative-valuation
description: "Assess business quality, competitive positioning, and sustainability of value creation beyond financial models. Use when the user asks about economic moats, competitive advantages, Porter's Five Forces, management quality, ESG integration, or business model analysis. Also trigger when users mention 'does this company have a moat', 'switching costs', 'network effects', 'brand value', 'management track record', 'capital allocation', 'insider ownership', 'red flags', or ask whether a company's advantage is durable."
---

# Qualitative Valuation

## Core Concepts

### Economic Moats (Morningstar Framework)
An economic moat is a structural advantage that protects a company's profits from competition. Five sources:

1. **Network Effects:** the product becomes more valuable as more people use it (payment networks, marketplaces)
2. **Switching Costs:** customers face significant cost, effort, or risk in moving to a competitor (enterprise software, banking relationships)
3. **Intangible Assets:** brands, patents, licenses, or regulatory approvals competitors cannot replicate; brands must confer pricing power to qualify
4. **Cost Advantages:** structural cost advantages from process technology, scale, location, or unique resources
5. **Efficient Scale:** a market that supports only a few players, where new entry would drive returns below the cost of capital (utilities, pipelines, railroads)

### Moat Width
- **Wide moat (20+ years):** multiple reinforcing moat sources, each backed by hard evidence
- **Narrow moat (10+ years):** at least one evidenced moat source with moderate durability
- **No moat:** commodity business with no structural advantage; competes on price

A moat claim is only as strong as its evidence. Do not award moat sources based on narrative — use the rubric below.

### Evidence Rubric: What Qualifies a Qualitative Claim
Anchor every claim in observable results, with retention and realized pricing as the strongest evidence:

| Claim | Qualifying evidence | Disqualifying signs |
|-------|--------------------|---------------------|
| Pricing power | Realized price increases at or above inflation with stable volumes and retention; gross margin held or expanded through input-cost cycles | Price increases followed by churn spikes; persistent discounting to hold share |
| Switching costs | Gross retention >90% (>95% for enterprise) or net revenue retention >100%; multi-year contracts; implementations measured in quarters; deep data/workflow integration | High churn; month-to-month terms; easy data export and low migration cost |
| Network effects | Unit economics measurably improve with scale (take rates, engagement, liquidity per user); winner-take-most share dynamics | User growth without any engagement, pricing, or cost benefit |
| Brand (intangible asset) | Sustained price premium over comparable products for years | Awareness without a premium; growth dependent on promotional spend |
| Cost advantage | Margins persistently above peers, traceable to scale, process, or resource access | One-off cost cuts; margin gap explained by product mix |
| Management quality | Multi-year ROIC > WACC; buybacks executed below subsequent intrinsic value; acquisitions that met stated return targets | Serial dilutive M&A; buybacks concentrated at price peaks; recurring guidance misses |

### Mapping Findings to Valuation Inputs
Translate qualitative conclusions into explicit adjustments to discount rate, fade period, or terminal assumptions in quantitative valuation. These ranges are judgment calibrations, not formulas — document the specific evidence behind each adjustment:

| Finding | Calibrated adjustment |
|---------|----------------------|
| Wide-moat evidence (2+ reinforcing, retention-backed sources) | Discount rate -0.5 to -1.0pp, or terminal multiple +1-2 turns, or extend the above-WACC return fade to 15-20 years |
| Narrow moat (one evidenced source) | Fade above-WACC returns over ~10 years; no discount-rate change |
| No moat | Fade returns to WACC by terminal year; terminal growth at or below inflation |
| Confirmed pricing power | Hold or modestly expand forecast margins; resist mean-reverting them prematurely |
| Governance red flags (see checklist) | Discount rate +0.5 to +1.5pp, haircut management guidance, or walk away |
| Material unmitigated ESG/regulatory exposure | Discount rate +0.5 to +1.5pp, or (often more transparent) probability-weight an impaired-earnings scenario |
| Key-person or succession risk | Discount rate +0.25 to +0.75pp |

If combined adjustments exceed roughly 2pp on the discount rate in either direction, the qualitative overlay is driving the valuation — re-examine the base-case cash flow assumptions instead of stacking adjustments.

### Qualitative Red Flags Checklist
Any single flag warrants deeper investigation before relying on a valuation model:

- **Aggressive accounting:** revenue recognition changes, newly capitalized expenses, non-GAAP adjustments that always exceed GAAP. Check: trend in the non-GAAP-to-GAAP gap over 3+ years.
- **Related-party transactions:** deals with insider-controlled entities that may not be at arm's length. Check: proxy statement and footnote disclosures.
- **Excessive M&A:** serial acquisitions that obscure weak organic growth and add integration risk. Check: organic growth disclosed vs reported growth.
- **High management turnover:** frequent CFO or auditor changes signal potential problems. Check: 8-K filings for departures and stated reasons.
- **Divergent cash flow and earnings:** net income growing while operating cash flow stagnates. Check: accruals (net income minus OCF) as a share of assets over time.

## Worked Examples

### Example 1: Moat Assessment — Enterprise Software Company
**Given:**
- Cloud-based ERP platform with 95% gross retention, 120% net revenue retention
- Average customer implementation takes 12-18 months
- Data integration with customer systems creates deep embedding
- No network effects; moderate brand value; costs in line with peers

**Assess:** Moat sources and width, using the evidence rubric

**Solution:**

1. **Switching Costs — STRONG (qualifies):** 95% gross retention and 120% net revenue retention clear the rubric thresholds, and 12-18 month implementations with deep data integration explain why. The 120% net retention also evidences realized pricing power: existing customers are paying more each year without offsetting churn.
2. **Network Effects — ABSENT:** an ERP system does not become more valuable to one customer because another adopts it.
3. **Intangible Assets — DOES NOT QUALIFY:** the brand is recognized but confers no measurable price premium over peers.
4. **Cost Advantages — ABSENT:** cost structure in line with competitors.
5. **Efficient Scale — ABSENT:** the market supports multiple competitors.

Assessment: **Narrow-to-wide moat.** One moat source, but with unusually strong retention evidence; durability 15-20+ years barring a technology shift. Valuation-input mapping: extend the above-WACC return fade toward 15-20 years and hold forecast margins, but skip the full wide-moat discount-rate reduction because there is no second reinforcing source.

### Example 2: Governance and Regulatory Risk — Discount Rate Calibration
**Given:** Base cost of equity 9.0%. The company operates in a high-carbon industry with no transition plan; pending carbon-tax legislation could reduce EBIT by 15%. Governance is strong: independent board, aligned compensation, no red flags.

**Calibrate:** Adjusted cost of equity

**Solution:**
- Unmitigated regulatory/environmental exposure: +1.5pp (top of the +0.5 to +1.5pp range — exposure is material, unmitigated, and legislation is pending)
- Strong governance: -0.25pp partial offset (well-governed firms adapt better)

Adjusted cost of equity = 9.0% + 1.5% - 0.25% = **10.25%**

Alternative (often more transparent): keep the 9% discount rate and probability-weight a scenario in which EBIT falls 15% when the carbon tax passes. Both approaches capture the same risk; do not apply both at once.

## Common Pitfalls
- Narrative fallacy: a compelling story is not evidence — require the rubric's observable results before crediting a moat
- Confirmation bias: seeking information that supports a pre-existing thesis while dismissing contradictory evidence
- Moat erosion: technology disruption can destroy moats faster than historical patterns suggest (e.g., retail disrupted by e-commerce)
- Double-counting: adjusting the discount rate and the cash flows for the same risk overstates the impact
- Overweighting management charisma: a compelling CEO presentation does not equal good capital allocation — check the multi-year ROIC and M&A record
- Static analysis: moats, competitive positioning, and regulatory risks evolve — reassess periodically

## Cross-References
- **quantitative-valuation** (wealth-management plugin): quantitative models that qualitative analysis informs and contextualizes
- **financial-statements** (wealth-management plugin): ROIC, margins, and cash flow patterns that validate qualitative assessments
- **forward-risk** (wealth-management plugin): risk premium adjustments from ESG and business quality factors
- **diversification** (wealth-management plugin): qualitative sector/factor analysis informs diversification decisions

© JoelLewis · MIT · JoelLewis/finance_skills

Similar skills

Everything for Finance and business →

From the same set84

next-best-action This skill designs next-best-action engines that watch client data for portfolio, life, market and compliance events and tell advisors what to do next. CX Codex +1 680installs know-your-customer Walks your agent through KYC: identity verification, beneficial ownership, EDD for PEPs, and keeping the customer profile current. CX Codex +1 679installs fixed-income-sovereign Prices Treasury bonds, builds the yield curve, and works out duration, convexity and DV01. Useful when you need rate risk numbers instead of hand-waving. CX Codex +1 678installs reconciliation Guides reconciliation workflows across portfolio systems, custodians, and clearing firms. It helps detect breaks, calibrate tolerance thresholds, and match internal books to official records. CX Codex +1 674installs exchange-connectivity Guides trading venue connectivity design, FIX session mechanics, and market data architecture. Useful when implementing low-latency protocols or Rule 15c3-5 risk checks. CX Codex +1 671installs operational-risk Guides operational risk identification, trade break investigations, and error account workflows for trading desks under Basel and FINRA standards. CX Codex +1 670installs settlement-clearing A skill covering trade settlement and clearing: the T+1 cycle, DTC/NSCC/FICC infrastructure, CNS netting, settlement fails and buy-in procedures. CX Codex +1 669installs performance-attribution Splits portfolio return into explainable pieces: how much came from sector weights, how much from stock picking inside them. Useful when you need to know why a portfolio beat or missed its benchmark. CX Codex +1 668installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor