Content
# Finance Skills
> AI-Ready Financial Intelligence — Intelligent Skill System covering all CFO work domains
[](https://github.com/vivy-yi)
[](./finance-skills/skills)
[](./finance-skills/skills)
[](./finance-skills/CONNECTORS.md)
[](./LICENSE)
---
## Overview
Finance Skills is a comprehensive financial skill system for AI Agents. Each Skill corresponds to a specific task in a financial scenario, enabling Agents to complete entire workflows from data reading to output.
**Problem Solving**: Equip AI Agents with financial expertise — not general chat, but capable of executing tasks like "internal control testing," "KPI root cause analysis," and "IFRS 9 credit risk assessment."
---
## Architecture Overview
```
finance-skills/
├── FINANCE-SKILLS-OVERVIEW.html ← Visualized spectrum (open in browser)
├── finance-skills/
│ ├── ARCHITECTURE.md ← Engineering architecture description
│ ├── CLAUDE.md ← Global configuration template
│ ├── CONNECTORS.md ← 9 Connector definitions (SAP/Power BI/BlackLine/Bloomberg...)
│ ├── PROJECT_WORKSPACE.md ← Project space specification
│ ├── cold-start/ ← Initial configuration guide
│ └── skills/ ← 34 financial scenarios
│ ├── internal-control/
│ ├── kpi-management/
│ └── ...
└── diagram/
├── FINANCE-SKILLS-OVERVIEW.html
└── 财务职能体系全览.html ← Early design draft (reference)
```
**Three-Layer Architecture**:
| Layer | Content | Status |
|-------|----------|------|
| Layer 0 — Hub | Global configuration, cold start, Connector registration | ✅ |
| Layer 1 — Scenes | 34 scenes × (references/ + skills/ + CLAUDE.md) | ✅ |
| Layer 2 — Projects | Project space (remember context across sessions) | ✅ Specification defined |
---
## Core Concepts
### Skill Types
Two Skill types for each scene:
| Type | Positioning | Quantity/Scene |
|------|-------------|---------------|
| **Master Skill** | Scene main skill, identifies user intent and dispatches to Atomic | 1/Scene (30) |
| **Atomic Skill** | Atomic skill, executes specific financial tasks | 3~6/Scene (122) |
### Scene Knowledge Backend
Three knowledge files for each scene:
- **判断框架.md** — Financial judgment rules (YAML/table), e.g., internal control defect grading standards, KPI selection logic
- **数据源清单.md** — Scene-required data → Connector → system/table/field mapping
- **查询路径.md** — Manual SOP without Connector, guides users to complete data collection
### Connector Ecosystem
9 Connectors covering 5 layers:
```
L1 ERP SAP S/4HANA, Oracle EBS/Fusion, 用友 NC/U8, 金蝶 K3
L2 BI Power BI, Tableau, FineReport（帆软）
L3 Execution BlackLine, SAP Concur, Expensify, Kyriba, GTreasury, Bloomberg TSOX, Refinitiv Eikon, Capital IQ, Wind, AuditBoard
L4 Compliance SharePoint, Google Drive, Workday Adaptive, Anaplan, Tagetik, CCH Tagetik, Workiva
L5 HR/Tax Workday HCM, BambooHR, ADP, TaxDome, Vertex/Sovos
L5 ESG/IR Sustainalytics, MSCI ESG, Bloomberg ESG, Diligent, Q4
```
---
## Scene Panorama (34)
### Strategic Level (A) — 17
| Scene | Introduction | Atomic Skills |
|------|-------------|--------------|
| [internal-control](./finance-skills/skills/internal-control/) | Internal control and SOX compliance | Control testing/defect assessment/approval matrix/control design |
| [kpi-management](./finance-skills/skills/kpi-management/) | KPI selection, tracking, and root cause analysis | Indicator setting/tracking/alert processing/root cause analysis |
| [board-reporting](./finance-skills/skills/board-reporting/) | Board material preparation and distribution | Board materials/meeting management/audit committee support |
| [management-report](./finance-skills/skills/management-report/) | Management report generation and publication | Financial report generation/management layer comment writing/indicator alert |
| [business-insight](./finance-skills/skills/business-insight/) | Business insight generation and verification | Insight generation/verification/trend analysis/survey analysis |
| [strategic-planning](./finance-skills/skills/strategic-planning/) | Strategic planning and execution tracking | Strategic goal setting/assumption assessment/risk assessment/execution tracking |
| [financing-structure](./finance-skills/skills/financing-structure/) | Financing structure design and cost calculation | Financing cost calculation/bank relationship/covenant monitoring/debt restructuring |
| [m-and-a](./finance-skills/skills/m-and-a/) | M&A process | Financial due diligence/DCF modeling/comparable analysis/integration roadmap |
| [fx-risk](./finance-skills/skills/fx-risk/) | Foreign exchange risk identification and hedging | Exposure calculation/forecast analysis/hedging strategy/transaction execution |
| [esg-reporting](./finance-skills/skills/esg-reporting/) | ESG data integration and disclosure | Data integration/materiality assessment/rating tracking/report generation |
| [investor-relations](./finance-skills/skills/investor-relations/) | Investor relations management | Roadshow materials/performance call preparation/information disclosure/feedback tracking |
| [treasury-management](./finance-skills/skills/treasury-management/) | Treasury management and fund forecasting | Intraday position/fund forecasting/payment authorization and approval |
| [capital-allocation](./finance-skills/skills/capital-allocation/) | Capital allocation and ROIC analysis | Investment evaluation/ROIC vs. WACC comparison/scenario analysis/WACC calculation |
| [transfer-pricing-documentation](./finance-skills/skills/transfer-pricing-documentation/) | Transfer pricing documentation and BEPS compliance | Master file/local file/CbCR/APA management |
| [internal-audit](./finance-skills/skills/internal-audit/) | Internal audit management process | Annual audit plan/compliance audit/fraud investigation/remedial tracking |
| [project-valuation](./finance-skills/skills/project-valuation/) | Project valuation and investment decision | NPV-IRR calculation/real option analysis/comparable reference/investment decision report |
| [ifrs9-credit-risk](./finance-skills/skills/ifrs9-credit-risk/) | IFRS 9 credit risk exposure assessment | Three-stage classification/ECL measurement/macro forward-looking adjustment/regulatory disclosure |
### Operational Level (B) — 17
| Scene | Introduction | Atomic Skills |
|------|-------------|--------------|
| [accounts-payable](./finance-skills/skills/accounts-payable/) | Accounts payable and payment scheduling | Three-document matching automation/payment scheduling/supplier payment review |
| [accounts-receivable](./finance-skills/skills/accounts-receivable/) | Accounts receivable and collection | Aging analysis/credit assessment/collection automation |
| [audit-support](./finance-skills/skills/audit-support/) | Audit support and evidence collection | Audit adjustment review/evidence collection/confirmation management |
| [budget-management](./finance-skills/skills/budget-management/) | Budget preparation and execution monitoring | Annual budget preparation/budget adjustment review/execution monitoring/variance analysis |
| [cash-management](./finance-skills/skills/cash-management/) | Cash flow management and forecasting | Position monitoring/forecasting/payment scheduling |
| [compliance-reporting](./finance-skills/skills/compliance-reporting/) | Compliance reporting and regulatory disclosure | Tax declaration/regulatory reporting/disclosure management |
| [cost-control](./finance-skills/skills/cost-control/) | Cost control and variance analysis | Cost center performance/expense ratio analysis/standard cost variance |
| [expense-review](./finance-skills/skills/expense-review/) | Expense reimbursement review | Invoice verification/three-document matching/policy compliance check/dispute identification |
| [financial-analysis](./finance-skills/skills/financial-analysis/) | Financial analysis and reporting | Budget execution analysis/profitability analysis/KPI dashboard |
| [fixed-assets](./finance-skills/skills/fixed-assets/) | Fixed asset management | Asset purchase review/asset disposal review/depreciation analysis |
| [intercompany-accounting](./finance-skills/skills/intercompany-accounting/) | Intercompany transactions and transfer pricing | Intercompany reconciliation/transfer pricing review/guarantee review |
| [investment-management](./finance-skills/skills/investment-management/) | Investment portfolio management | Portfolio review/liquidity assessment/financing cost analysis |
| [month-end-close](./finance-skills/skills/month-end-close/) | Month-end close automation | Month-end checklist execution/verification/cross-period adjustment/reconciliation automation |
| [payroll-accounting](./finance-skills/skills/payroll-accounting/) | Payroll accounting and social security | Payroll calculation/social security review/withholding review |
| [tax-filing](./finance-skills/skills/tax-filing/) | Tax filing (corporate tax/VAT/personal tax) | Corporate tax filing/VAT filing/personal tax filing/tax risk assessment |
| [treasury-advanced](./finance-skills/skills/treasury-advanced/) | Advanced treasury (bank relationship/liquidity) | Bank relationship assessment/cash pool configuration/investment compliance check/LCR assessment |
| [working-capital](./finance-skills/skills/working-capital/) | Working capital optimization | Cash conversion cycle/inventory optimization/accounts payable strategy/supply chain finance |
> Note: Some operational scenes (budget-management, expense-review, month-end-close, etc.) are pure Atomic arrangement, without Master Skill.
---
## Quick Start
### 1. Install Skill
```bash
# Method 1: Soft link to Hermes
ln -s /path/to/finance-skills/finance-skills ~/.hermes/skills/finance
# Method 2: Configure reference path in SOUL.md
```
### 2. Initial Configuration (Cold Start)
```
/hermes
> /finance:cold-start
```
or trigger keywords: `Start configuration financial skills`, `Initialize finance`, `cold start`
Cold start process:
1. **Connector detection** — Verify system accessibility (SAP/Power BI/BlackLine, etc.)
2. **Company configuration** — Collect ERP type/audit cycle/financial function structure
3. **Scene selection** — Select relevant scenes (multiple selections allowed)
4. **Threshold setting** — Configure internal control defect grading standards, KPI benchmark values, etc.
5. **Persistence** — Write to `~/.config/finance-skills/CLAUDE.md`
### 3. Use Scene Skill
```
Hermes/Agent: Load scene Skill
↓
Master Skill: Identify user intent
↓
Atomic Skill: Execute specific task
↓
references/: Read judgment framework + data source mapping
↓
Connector: Call external system
↓
Output result (report/judgment/suggestion)
```
---
## Skill File Structure
```
skills/[Scene]/
├── CLAUDE.md ← User configuration (company name/threshold/contact)
├── references/
│ ├── 判断框架.md ← Financial judgment rules (YAML/table)
│ ├── 数据源清单.md ← Data → Connector → field mapping
│ └── 查询路径.md ← SOP (manual process without Connector)
└── skills/
├── [scene]-master/ ← Scene main skill
│ └── SKILL.md
└── [atomic-skill]/ ← Atomic skill
└── SKILL.md
```
Each SKILL.md includes:
```yaml
---
name: [skill-name]
description: [capability description]
argument-hint: "[parameter format]"
risk_level: [low|medium|high]
version: "1.0.0"
---
## Examples
> User says "...", call this skill
## Load context
Read `../../CLAUDE.md` to get scene-level configuration when first used
## Step 1 / Step 2 / ...
[Executable steps: judgment → tool call → output]
```
---
## Relationship with Legal Skill System
Finance Skills and [Greater China Legal](https://github.com/vivy-yi/Greater-China-Legal) share the same engineering specifications:
| Dimension | Greater China Legal | Finance Skills |
|------|---------------------|----------------|
| Scenes | 12 legal domains | 34 financial scenes |
| Architecture | Layer 0 Hub + Layer 1 domain + Layer 2 project | Layer 0 Hub + Layer 1 scene + Layer 2 project |
| Knowledge backend | Judgment framework + data source list + query path | Judgment framework + data source list + query path |
| Connector | Westlaw / 企查查 / MCP Server | SAP / Power BI / BlackLine / Bloomberg |
| Positioning | Lawyer business flow (review/negotiation/litigation) | CFO workflow (control/analysis/decision/disclosure) |
Both can be loaded on the same Agent, with automatic routing based on intent.
---
## File Statistics
| Indicator | Quantity |
|------|------|
| Total scenes | 34 |
| Strategic level (A) | 17 |
| Operational level (B) | 17 |
| Skill files (SKILL.md) | 152 |
| Master Skill | 30 |
| Atomic Skill | 122 |
| References files | 102 |
| Scene-level configuration files (CLAUDE.md) | 34 |
| Connector types | 34 (covering L1~L5) |
**Quality status**: All SKILL.md files with frontmatter ✅ + Examples ✅ 100%
---
## Technology Stack
- **Agent framework**: Hermes Agent / OpenClaw
- **Skill format**: Markdown (SKILL.md + YAML frontmatter)
- **Knowledge backend**: Markdown table/YAML (judgment framework/data source list/query path)
- **System integration**: MCP (Model Context Protocol) Connector
- **Visualization**: HTML5 + CSS3 (FINANCE-SKILLS-OVERVIEW.html)
---
## Directory Depth
```
finance-skills/finance-skills/skills/[scene]/skills/[skill]/SKILL.md
1 2 3 4 5 6
```
6 layers in total. Relative path `../../CLAUDE.md` from Skill file to scene root directory (unchanged depth).
---
## License
MIT License — Free for personal and commercial projects.
---
## Author
**vivy-yi** · GitHub: [@vivy-yi](https://github.com/vivyyi)
Connection Info
You Might Also Like
No recommendations available