# himself65/finance-skills architecture

> Architecture diagram of the GitHub repository himself65/finance-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/himself65/finance-skills
- Repository: https://github.com/himself65/finance-skills

## Overview

Finance Skills is a collection of agent-facing financial research, analysis, and workflow skills, with bundled OpenCLI readers for TradingView and Hyperliquid. The primary flow is an agent using a skill to obtain or analyze information and return a research result; the README documents the skill capabilities and external services. The graph also shows the sampled reader entry points and helpers. Many skill instructions and other plugin sources were not sampled, so those branches are represented at skill-directory level and their internal calls are not inferred.

Main entry points: [`plugins/data-providers/skills`](https://github.com/himself65/finance-skills/tree/main/plugins/data-providers/skills) (Provider Skills), [`opencli-plugins/hyperliquid/markets.js`](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/markets.js) (Hyperliquid Commands), [`opencli-plugins/hyperliquid/lib/api.js`](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/api.js) (Hyperliquid Info API), [`plugins/market-analysis/skills`](https://github.com/himself65/finance-skills/tree/main/plugins/market-analysis/skills) (Analysis Skills)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Market Analysis"]
  node_analysis_skills["Analysis Skills"]
  node_market_data["Market Data"]
end

subgraph group_providers["Data Providers"]
  node_data_skills["Provider Skills"]
  node_sentiment_data["Sentiment / Fintel APIs"]
  node_hormuz_data["Hormuz Monitoring"]
  node_tv_mcp["TradingView MCP"]
end

subgraph group_social["Social Readers"]
  node_social_skills["Social Skills"]
end

subgraph group_workflows["Other Skills"]
  node_startup["Startup Analysis"]
  node_ui["Generative UI"]
  node_creator["Skill Creator"]
end

subgraph group_tv_runtime["TradingView Reader"]
  node_tv_commands["TradingView Commands<br/>[screener.js]"]
  node_tv_scanner["Scanner Helpers<br/>[scanner.js]"]
  node_tv_news["News Helpers<br/>[news.js]"]
  node_tv_symbols["Symbol Helpers<br/>[symbols.js]"]
  node_tv_cookies["Cookie Fetch<br/>[cookies.js]"]
  node_tv_cdp["CDP Client<br/>[cdp.js]"]
end

subgraph group_hl_runtime["Hyperliquid Reader"]
  node_hyperliquid_entry["Hyperliquid Commands<br/>[markets.js]"]
  node_hyperliquid_api["Hyperliquid Info API<br/>[api.js]"]
  node_hl_normalizers["Market Normalizers<br/>[markets.js]"]
  node_hl_funding["Funding Normalizers<br/>[funding.js]"]
  node_hl_book["Order Book<br/>[book.js]"]
  node_hl_candles["Candles<br/>[candles.js]"]
end

node_agent(("Agent / User"))
node_tradingview["TradingView"]
node_hyperliquid["Hyperliquid API"]
node_result["Research Result"]

node_agent -->|"requests analysis"| node_analysis_skills
node_agent -->|"requests data"| node_data_skills
node_agent -->|"requests research"| node_social_skills
node_agent -->|"requests analysis"| node_startup
node_agent -->|"requests widget"| node_ui
node_agent -->|"creates skills"| node_creator
node_analysis_skills -->|"uses data"| node_market_data
node_data_skills -->|"reads provider data"| node_sentiment_data
node_data_skills -->|"monitors"| node_hormuz_data
node_data_skills -->|"reads TradingView"| node_tv_mcp
node_data_skills -->|"reads markets"| node_hyperliquid_entry
node_social_skills -->|"returns research"| node_result
node_analysis_skills -->|"returns analysis"| node_result
node_startup -->|"returns perspectives"| node_result
node_hyperliquid_entry -->|"fetches market data"| node_hyperliquid_api
node_hyperliquid_entry -->|"normalizes markets"| node_hl_normalizers
node_hyperliquid_api -->|"posts info request"| node_hyperliquid
node_hl_funding -->|"uses numeric helpers"| node_hyperliquid_api
node_hl_normalizers -->|"uses numeric helpers"| node_hyperliquid_api
node_tv_commands -->|"builds scanner query"| node_tv_scanner
node_tv_scanner -->|"fetches scanner data"| node_tv_cookies
node_tv_commands -->|"queries scanner service"| node_tradingview
node_tv_news -->|"fetches news"| node_tv_cookies
node_tv_cookies -->|"harvests cookies"| node_tv_cdp
node_tv_cdp -->|"connects via CDP"| node_tradingview
node_hyperliquid_entry -->|"emits rows"| node_result

click node_analysis_skills "https://github.com/himself65/finance-skills/tree/main/plugins/market-analysis/skills"
click node_data_skills "https://github.com/himself65/finance-skills/tree/main/plugins/data-providers/skills"
click node_social_skills "https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills"
click node_startup "https://github.com/himself65/finance-skills/tree/main/plugins/startup-tools/skills/startup-analysis"
click node_ui "https://github.com/himself65/finance-skills/tree/main/plugins/ui-tools/skills/generative-ui"
click node_creator "https://github.com/himself65/finance-skills/tree/main/plugins/skill-creator/skills/skill-creator"
click node_hyperliquid_entry "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/markets.js"
click node_hyperliquid_api "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/api.js"
click node_hl_normalizers "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/markets.js"
click node_hl_funding "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/funding.js"
click node_hl_book "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/book.js"
click node_hl_candles "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/candles.js"
click node_tv_commands "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/screener.js"
click node_tv_scanner "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/scanner.js"
click node_tv_news "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/news.js"
click node_tv_symbols "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/symbols.js"
click node_tv_cookies "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/cookies.js"
click node_tv_cdp "https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/cdp.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_analysis_skills,node_market_data,node_agent,node_tradingview toneBlue
class node_data_skills,node_sentiment_data,node_hormuz_data,node_tv_mcp toneAmber
class node_social_skills,node_hyperliquid toneMint
class node_startup,node_ui,node_creator toneRose
class node_tv_commands,node_tv_scanner,node_tv_news,node_tv_symbols,node_tv_cookies,node_tv_cdp,node_result toneIndigo
class node_hyperliquid_entry,node_hyperliquid_api,node_hl_normalizers,node_hl_funding,node_hl_book,node_hl_candles toneTeal
```

## Components

### Market Analysis

- [Analysis Skills](https://github.com/himself65/finance-skills/tree/main/plugins/market-analysis/skills): `plugins/market-analysis/skills`
- **Market Data**

### Data Providers

- [Provider Skills](https://github.com/himself65/finance-skills/tree/main/plugins/data-providers/skills): `plugins/data-providers/skills`
- **Sentiment / Fintel APIs**
- **Hormuz Monitoring**
- **TradingView MCP**

### Social Readers

- [Social Skills](https://github.com/himself65/finance-skills/tree/main/plugins/social-readers/skills): `plugins/social-readers/skills`

### Other Skills

- [Startup Analysis](https://github.com/himself65/finance-skills/tree/main/plugins/startup-tools/skills/startup-analysis): `plugins/startup-tools/skills/startup-analysis`
- [Generative UI](https://github.com/himself65/finance-skills/tree/main/plugins/ui-tools/skills/generative-ui): `plugins/ui-tools/skills/generative-ui`
- [Skill Creator](https://github.com/himself65/finance-skills/tree/main/plugins/skill-creator/skills/skill-creator): `plugins/skill-creator/skills/skill-creator`

### TradingView Reader

- [TradingView Commands](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/screener.js): `opencli-plugins/tradingview/screener.js`
- [Scanner Helpers](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/scanner.js): `opencli-plugins/tradingview/lib/scanner.js`
- [News Helpers](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/news.js): `opencli-plugins/tradingview/lib/news.js`
- [Symbol Helpers](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/symbols.js): `opencli-plugins/tradingview/lib/symbols.js`
- [Cookie Fetch](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/cookies.js): `opencli-plugins/tradingview/lib/cookies.js`
- [CDP Client](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/tradingview/lib/cdp.js): `opencli-plugins/tradingview/lib/cdp.js`

### Hyperliquid Reader

- [Hyperliquid Commands](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/markets.js): `opencli-plugins/hyperliquid/markets.js`
- [Hyperliquid Info API](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/api.js): `opencli-plugins/hyperliquid/lib/api.js`
- [Market Normalizers](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/markets.js): `opencli-plugins/hyperliquid/lib/markets.js`
- [Funding Normalizers](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/funding.js): `opencli-plugins/hyperliquid/lib/funding.js`
- [Order Book](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/book.js): `opencli-plugins/hyperliquid/lib/book.js`
- [Candles](https://github.com/himself65/finance-skills/blob/main/opencli-plugins/hyperliquid/lib/candles.js): `opencli-plugins/hyperliquid/lib/candles.js`

### Other components

- **Agent / User**
- **TradingView**
- **Hyperliquid API**
- **Research Result**

## Connections

- Agent / User → Analysis Skills: requests analysis (evidence: `README.md`)
- Agent / User → Provider Skills: requests data (evidence: `README.md`)
- Agent / User → Social Skills: requests research (evidence: `README.md`)
- Agent / User → Startup Analysis: requests analysis (evidence: `README.md`)
- Agent / User → Generative UI: requests widget (evidence: `README.md`)
- Agent / User → Skill Creator: creates skills (evidence: `README.md`)
- Analysis Skills → Market Data: uses data (evidence: `README.md`)
- Provider Skills → Sentiment / Fintel APIs: reads provider data (evidence: `README.md`)
- Provider Skills → Hormuz Monitoring: monitors (evidence: `README.md`)
- Provider Skills → TradingView MCP: reads TradingView (evidence: `README.md`)
- Provider Skills → Hyperliquid Commands: reads markets (evidence: `README.md`)
- Social Skills → Research Result: returns research (evidence: `README.md`)
- Analysis Skills → Research Result: returns analysis (evidence: `README.md`)
- Startup Analysis → Research Result: returns perspectives (evidence: `README.md`)
- Hyperliquid Commands → Hyperliquid Info API: fetches market data (evidence: `opencli-plugins/hyperliquid/markets.js`)
- Hyperliquid Commands → Market Normalizers: normalizes markets (evidence: `opencli-plugins/hyperliquid/markets.js`)
- Hyperliquid Info API → Hyperliquid API: posts info request (evidence: `opencli-plugins/hyperliquid/lib/api.js`)
- Funding Normalizers → Hyperliquid Info API: uses numeric helpers (evidence: `opencli-plugins/hyperliquid/lib/funding.js`)
- Market Normalizers → Hyperliquid Info API: uses numeric helpers (evidence: `opencli-plugins/hyperliquid/lib/markets.js`)
- TradingView Commands → Scanner Helpers: builds scanner query (evidence: `opencli-plugins/tradingview/screener.js`)
- Scanner Helpers → Cookie Fetch: fetches scanner data (evidence: `opencli-plugins/tradingview/lib/scanner.js`)
- TradingView Commands → TradingView: queries scanner service (evidence: `opencli-plugins/tradingview/screener.js`)
- News Helpers → Cookie Fetch: fetches news (evidence: `opencli-plugins/tradingview/lib/news.js`)
- Cookie Fetch → CDP Client: harvests cookies (evidence: `opencli-plugins/tradingview/lib/cookies.js`)
- CDP Client → TradingView: connects via CDP (evidence: `opencli-plugins/tradingview/lib/cdp.js`)
- Hyperliquid Commands → Research Result: emits rows (evidence: `opencli-plugins/hyperliquid/markets.js`)
