← Back to Skills Marketplace
jason-aka-chen

Financial Analyzer

by jason-aka-chen · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
167
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install financial-analyzer
Description
AI-powered financial analysis assistant for financial statement analysis, ratio analysis, cash flow analysis, investment evaluation, and financial health ass...
README (SKILL.md)

Financial Analyzer

AI-powered financial analysis and investment evaluation tool.

Features

1. Financial Statement Analysis

  • Balance Sheet: Assets, liabilities, equity analysis
  • Income Statement: Revenue, expenses, profit analysis
  • Cash Flow Statement: Operating, investing, financing
  • Statement of Changes: Equity changes tracking

2. Ratio Analysis

  • Liquidity Ratios: Current, quick, cash ratio
  • Solvency Ratios: Debt, interest coverage, D/E
  • Profitability Ratios: ROE, ROA, margins
  • Efficiency Ratios: Turnover, asset utilization
  • Market Ratios: P/E, P/B, PEG, dividend yield

3. Cash Flow Analysis

  • Operating Cash Flow: Quality of earnings
  • Free Cash Flow: Valuation and health
  • Cash Conversion: Efficiency metrics
  • Burn Rate: Startup sustainability

4. Investment Evaluation

  • DCF Valuation: Discounted cash flow
  • Relative Valuation: Peer comparison
  • Graham Number: Value investing
  • Intrinsic Value: Multiple methods

5. Risk Assessment

  • Altman Z-Score: Bankruptcy prediction
  • Piotroski F-Score: Financial health
  • Credit Risk: Default probability
  • Operational Risk: Business stability

Installation

pip install numpy pandas

Usage

Basic Analysis

from financial_analyzer import FinancialAnalyzer

analyzer = FinancialAnalyzer()

# Analyze a company
result = analyzer.analyze(
    company="茅台",
    statements={
        'balance_sheet': balance_data,
        'income_statement': income_data,
        'cash_flow': cash_flow_data
    }
)

print(result['summary'])

Ratio Analysis

# Calculate all ratios
ratios = analyzer.calculate_ratios(statements)

print(ratios['liquidity'])
# {
#     'current_ratio': 2.5,
#     'quick_ratio': 1.8,
#     'cash_ratio': 0.5
# }

print(ratios['profitability'])
# {
#     'roe': 0.28,
#     'roa': 0.18,
#     'gross_margin': 0.75,
#     'net_margin': 0.52
# }

Valuation

# DCF Valuation
dcf = analyzer.dcf_valuation(
    free_cash_flow=50e9,
    growth_rate=0.05,
    discount_rate=0.10,
    terminal_growth=0.03
)
print(f"Intrinsic Value: {dcf['enterprise_value']:,.0f}")

# Relative Valuation
relative = analyzer.relative_valuation(
    company="茅台",
    peers=["五粮液", "泸州老窖"],
    metrics={'pe': 35, 'pb': 8}
)

Risk Assessment

# Altman Z-Score (bankruptcy risk)
z_score = analyzer.altman_z_score(statements)
print(f"Z-Score: {z_score['score']:.2f}")
print(f"Risk Level: {z_score['risk_level']}")
# Z-Score: 5.2
# Risk Level: Safe (Z > 2.99)

# Piotroski F-Score (financial health)
f_score = analyzer.piotroski_f_score(statements)
print(f"F-Score: {f_score['score']}/9")

Financial Health Check

# Comprehensive health check
health = analyzer.health_check(statements)

print(health['overall_score'])  # 85/100
print(health['strengths'])
print(health['weaknesses'])
print(health['recommendations'])

API Reference

Statement Analysis

Method Description
analyze(company, statements) Full analysis
analyze_balance_sheet(data) Balance sheet analysis
analyze_income(data) Income statement analysis
analyze_cash_flow(data) Cash flow analysis

Ratios

Method Description
calculate_ratios(statements) All ratios
liquidity_ratios(data) Liquidity metrics
solvency_ratios(data) Solvency metrics
profitability_ratios(data) Profitability metrics
efficiency_ratios(data) Efficiency metrics

Valuation

Method Description
dcf_valuation(...) DCF model
relative_valuation(...) Peer comparison
graham_number(...) Graham's formula
earnings_power_value(...) EPV valuation

Risk

Method Description
altman_z_score(statements) Bankruptcy risk
piotroski_f_score(statements) Financial health
credit_risk_score(statements) Credit assessment
operational_risk(statements) Business risk

Reports

Method Description
generate_report(analysis) Full report
summary_report(analysis) Summary
peer_comparison(company, peers) Compare with peers

Key Ratios

Liquidity

Ratio Formula Good Range
Current Ratio Current Assets / Current Liabilities 1.5 - 3.0
Quick Ratio (CA - Inventory) / CL 1.0 - 2.0
Cash Ratio Cash / CL 0.2 - 0.5

Profitability

Ratio Formula Interpretation
ROE Net Income / Equity Higher is better
ROA Net Income / Assets Higher is better
Gross Margin Gross Profit / Revenue Industry dependent
Net Margin Net Income / Revenue Higher is better

Leverage

Ratio Formula Good Range
Debt/Equity Total Debt / Equity \x3C 2.0
Interest Coverage EBIT / Interest > 3.0
Debt/Assets Total Debt / Assets \x3C 0.6

Efficiency

Ratio Formula Interpretation
Asset Turnover Revenue / Assets Higher is better
Inventory Turnover COGS / Inventory Industry dependent
Receivables Turnover Revenue / Receivables Higher is better

Valuation Models

DCF Model

{
    'method': 'dcf',
    'steps': [
        'Project free cash flows',
        'Calculate terminal value',
        'Discount to present value',
        'Subtract debt, add cash'
    ],
    'inputs': {
        'fcf': 'Free cash flow',
        'growth_rate': 'Expected growth',
        'wacc': 'Weighted average cost of capital',
        'terminal_growth': 'Long-term growth'
    }
}

Graham Number

graham_number = sqrt(22.5 * EPS * Book_Value_Per_Share)

Risk Models

Altman Z-Score

Z = 1.2*X1 + 1.4*X2 + 3.3*X3 + 0.6*X4 + 1.0*X5

X1 = Working Capital / Total Assets
X2 = Retained Earnings / Total Assets
X3 = EBIT / Total Assets
X4 = Market Value Equity / Total Liabilities
X5 = Sales / Total Assets

Interpretation:
Z > 2.99: Safe Zone
1.81 \x3C Z \x3C 2.99: Grey Zone
Z \x3C 1.81: Distress Zone

Piotroski F-Score

9 criteria, 1 point each:
1. Positive ROA
2. Positive Operating Cash Flow
3. ROA improving
4. OCF > Net Income
5. Lower debt ratio
6. Higher current ratio
7. No share dilution
8. Higher gross margin
9. Higher asset turnover

Score interpretation:
8-9: Strong
6-7: Good
4-5: Average
0-3: Weak

Example: Full Analysis

from financial_analyzer import FinancialAnalyzer

analyzer = FinancialAnalyzer()

# Company financial data
statements = {
    'balance_sheet': {
        'total_assets': 200e9,
        'total_liabilities': 50e9,
        'current_assets': 80e9,
        'current_liabilities': 30e9,
        'cash': 40e9,
        'inventory': 10e9,
        'equity': 150e9
    },
    'income_statement': {
        'revenue': 100e9,
        'cost_of_goods': 25e9,
        'operating_expenses': 10e9,
        'net_income': 50e9,
        'ebit': 60e9
    },
    'cash_flow': {
        'operating_cf': 55e9,
        'investing_cf': -15e9,
        'financing_cf': -10e9,
        'free_cash_flow': 40e9
    }
}

# Run full analysis
result = analyzer.analyze("Example Corp", statements)

print(f"ROE: {result['ratios']['profitability']['roe']:.1%}")
print(f"Z-Score: {result['risk']['z_score']:.2f}")
print(f"Health Score: {result['health_score']}/100")

Chinese Accounting Standards

Supports both:

  • CAS (Chinese Accounting Standards)
  • IFRS (International Financial Reporting Standards)
  • GAAP (US Generally Accepted Accounting Principles)

Use Cases

  • Investment Analysis: Evaluate investment opportunities
  • Credit Analysis: Assess creditworthiness
  • Due Diligence: M&A analysis
  • Performance Tracking: Monitor company health
  • Screening: Filter investment candidates

Best Practices

  1. Use multiple ratios together
  2. Compare with industry peers
  3. Analyze trends over time
  4. Consider qualitative factors
  5. Understand accounting policies

Future Capabilities

  • Real-time data integration
  • AI-powered insights
  • Automated report generation
  • Multi-company comparison
  • Industry benchmarking
Usage Guidance
This skill appears to perform local financial calculations only, which is coherent with its description. Before installing: 1) Note the package author/source/homepage is missing — prefer code from a known repository or author if you require provenance. 2) The SKILL.md recommends installing numpy and pandas via pip; install those packages from the official PyPI index and consider using a virtual environment. 3) Review any company financial data you feed into the skill for sensitivity (it does not send data outbound, but you should avoid sharing confidential data with third-party code unless you trust its source). 4) If you plan to rely on its outputs for real investment decisions, validate results on known examples and consider an independent audit of the calculations.
Capability Analysis
Type: OpenClaw Skill Name: financial-analyzer Version: 1.0.0 The financial-analyzer skill bundle is a legitimate tool for calculating financial ratios and performing company valuations. The Python implementation (financial_analyzer.py) uses standard mathematical formulas for models like DCF, Altman Z-Score, and Piotroski F-Score without any external network requests, file system access, or suspicious execution logic. While there is a minor coding error in the risk assessment logic (calling non-existent methods on a dataclass), it is an unintentional bug rather than a security flaw or malicious behavior.
Capability Assessment
Purpose & Capability
The name/description (financial analysis) matches the included Python implementation and SKILL.md examples. The skill requests no credentials or system access. One minor concern: the skill's source/homepage are unknown which reduces provenance/accountability, but functionally the requirements are proportionate to its stated purpose.
Instruction Scope
SKILL.md instructs local usage and shows example APIs that take user-provided financial statements. It does not direct reading unrelated system files, accessing external endpoints, or exfiltrating data. The runtime instructions are narrowly scoped to analysis tasks.
Install Mechanism
There is no formal install spec in the package metadata; SKILL.md recommends 'pip install numpy pandas', which is appropriate and proportionate for numeric processing. No downloads from arbitrary URLs, no extract/install hooks, and the code file contains only local computations.
Credentials
No required environment variables, no primary credential, and no config paths are requested. That is consistent with a local analysis library that operates on user-supplied data.
Persistence & Privilege
The skill is not marked 'always: true' and uses only in-memory history storage. It does not modify other skills or system-wide configuration. Autonomous invocation is allowed by default but that is normal and not an additional red flag here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install financial-analyzer
  3. After installation, invoke the skill by name or use /financial-analyzer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of financial-analyzer 1.0.0. - Provides AI-powered financial statement, ratio, and cash flow analysis supporting Chinese and international accounting standards. - Includes investment evaluation tools (DCF, relative valuation, Graham number, intrinsic value). - Offers comprehensive risk assessment featuring Altman Z-Score, Piotroski F-Score, and credit/operational risk metrics. - Supplies API methods for statement analysis, ratio calculation, valuation models, risk scoring, and report generation. - Essential tool for investors and analysts to assess financial health and make informed investment decisions.
Metadata
Slug financial-analyzer
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Financial Analyzer?

AI-powered financial analysis assistant for financial statement analysis, ratio analysis, cash flow analysis, investment evaluation, and financial health ass... It is an AI Agent Skill for Claude Code / OpenClaw, with 167 downloads so far.

How do I install Financial Analyzer?

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

Is Financial Analyzer free?

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

Which platforms does Financial Analyzer support?

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

Who created Financial Analyzer?

It is built and maintained by jason-aka-chen (@jason-aka-chen); the current version is v1.0.0.

💬 Comments