# Market Education

> >

- **Type:** Skill
- **Install:** `agentstack add skill-thanhdatngo2003-claude-market-skills-market-education`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ThanhDatNgo2003](https://agentstack.voostack.com/s/thanhdatngo2003)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ThanhDatNgo2003](https://github.com/ThanhDatNgo2003)
- **Source:** https://github.com/ThanhDatNgo2003/claude-market-skills/tree/master/build/market-education

## Install

```sh
agentstack add skill-thanhdatngo2003-claude-market-skills-market-education
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Market Education — Expert Cards

> **Khi dùng ví dụ thực tế, chạy script để có giá chính xác.**
> 
> Chạy `python scripts/analyze_all.py [TICKER]` trước khi viết ví dụ minh họa.
> Script dùng VPS API (realtime) + yfinance (fallback) để lấy giá CHÍNH XÁC từ sàn.
> Nếu script fail: dùng **WebFetch** gọi `https://bgapidatafeed.vps.com.vn/getliststockdata/[TICKER]`
> Ví dụ với số liệu sai gây hiểu nhầm cho người học. WebSearch cho giá thường SAI (delay, outdated).

## 🧠 BƯỚC 0 — ĐỌC JOURNAL TRƯỚC KHI PHÂN TÍCH (Learning Loop)

Skill này có **bộ nhớ dài hạn** lưu tại `~/.claude/skills-data/market-analyst/`. Mỗi lần phân tích đều được ghi journal và Claude phải đọc track record cũ trước khi đưa ra recommendation mới.

**Quy trình BẮT BUỘC:**

1. **Trước phân tích** — chạy: `python scripts/journal_manager.py context [TICKER] --price [GIA_HIEN_TAI]`
   - Trả về: track record cũ, calibration score, lessons learned, lịch sử thesis
   - Nếu `bull_hit_rate` /dev/null
python scripts/analyze_all.py FPT HPG
```

Script sử dụng VPS API (realtime) + yfinance (fallback) để lấy:
- ✅ Giá realtime chính xác từ sàn — dùng làm ví dụ giá
- ✅ OHLC, volume — dùng minh họa candlestick, volume analysis
- ✅ Trần/sàn — dùng giải thích biên độ giá VN
- ✅ Phân tích kỹ thuật + cơ bản — dùng minh họa RSI, MACD, P/E, etc.

**Lưu ý giá VPS API:** Trả theo đơn vị nghìn (18.1 = 18,100 VND). Script tự convert.

Dùng giá từ script làm **nguồn chính** cho ví dụ. Sau đó dùng WebSearch nếu cần bối cảnh thêm (so sánh ngành, tin liên quan).

**Ưu tiên 2 — Nếu script fail (ví dụ trong Claude.ai sandbox):** Dùng **WebFetch** gọi VPS API trực tiếp:
```
WebFetch URL: https://bgapidatafeed.vps.com.vn/getliststockdata/[TICKER]
Prompt: "Trả về JSON: lastPrice, r, c, f, highPrice, lowPrice, openPrice, lot, fBVol, fSVolume"
```
Gọi TỪNG MÃ MỘT. Nếu fail, THỬ LẠI 1 lần.

**Ưu tiên 3 — Fallback cuối cùng:** WebSearch giá từ `finance.vietstock.vn` hoặc `cafef.vn`.

## Bước 2: Lấy dữ liệu thực tế bổ sung

### Tại sao cần dữ liệu thực

Ví dụ với số liệu thật giúp người học hiểu ngay cách áp dụng. "P/E của FPT là 18.5, ngành IT trung bình 25 → FPT đang rẻ hơn ngành" dễ hiểu hơn gấp 10 lần so với "P/E thấp hơn ngành là tín hiệu tốt".

Nếu cần bối cảnh thêm (so sánh ngành, tin tức), dùng **web_search 1-2 queries**:
```
"ví dụ [khái niệm] thị trường Việt Nam"
"ngành [sector] so sánh P/E ROE VN"
```

Script/VPS API đã cung cấp giá realtime chính xác — KHÔNG cần WebSearch cho giá.

## Bước 3: Tạo React Education Card — LIGHT THEME

### Quy tắc giao diện

- Nền: `bg-white` hoặc `bg-gray-50`
- Cards: `bg-white shadow-sm border border-gray-200 rounded-lg`
- Accent colors cho visual: `blue-500`, `green-500`, `red-500`, `amber-500`
- Text: `text-gray-900` chính, `text-gray-600` phụ
- **Không dùng:** `bg-gray-900`, `bg-slate-800`, nền tối

### Cấu trúc education card

**Header:**
- Icon + Tên khái niệm (lớn, bold)
- 1 câu định nghĩa ngắn gọn
- Difficulty badge: CO BAN / TRUNG CAP / NANG CAO (bg-blue-100, bg-amber-100, bg-red-100)

**Visual Illustration:**
Tùy khái niệm, tạo visual phù hợp bằng inline SVG:
- RSI: Gauge 0-100 với zones (oversold | neutral | overbought)
- MACD: Mini chart minh họa crossover
- P/E: Bar chart so sánh P/E giữa vài công ty VN thực tế
- Candlestick: SVG vẽ mô hình nến
- Bollinger: SVG bands illustration
- Portfolio: Donut chart allocation
- Nếu không cần chart: infographic style với icons và arrows

**Ví dụ thực tế VN (bắt buộc):**
- Box highlight với mã cụ thể VN
- Số liệu thực từ web_search hoặc scripts
- Ghi rõ thời điểm data

**Giải thích chuyên sâu — Không surface-level:**
RSI > 70 không đơn giản = "bán". Trong bull market mạnh, RSI có thể duy trì > 70 nhiều tuần (RSI range shift). Giải thích context và ngoại lệ giúp người học tránh áp dụng máy móc.

**Key Takeaways:**
- 3-4 bullet ngắn gọn
- Dùng icons cho dễ scan

**Expandable sections (useState toggle):**
- Cách tính (công thức, bước chi tiết)
- Cách sử dụng trong giao dịch thực tế
- Sai lầm phổ biến (quan trọng vì nhiều người mắc)
- Khái niệm liên quan (sendPrompt buttons)

**Khái niệm liên quan:**
- Buttons gọi sendPrompt: "RSI là gì?", "MACD là gì?", "Bollinger Bands là gì?" — học tiếp chuỗi kiến thức

### Khi so sánh A vs B

Tạo comparison card:
- Bảng side-by-side (tiêu chí | A | B)
- Verdict: "Khi nào dùng A? Khi nào dùng B?"
- Visual: score bars cho mỗi tiêu chí trên bg-white

### Expert Voice
- Chuyên nghiệp, đi thẳng vào vấn đề
- Giải thích ngắn gọn nhưng chính xác
- Ví dụ thực tế là bắt buộc
- Giải thích WHY, không chỉ WHAT — "RSI đo momentum vì so sánh tốc độ tăng vs giảm trong N phiên, giúp phát hiện khi giá đi quá nhanh so với bình thường"

## References
- `references/market-analyst-guide.md` — Framework chuyên gia
- `references/indicator_guide.md` — Chỉ báo kỹ thuật
- `references/ichimoku_guide.md` — Ichimoku Cloud chi tiết
- `references/elliott_wave_guide.md` — Elliott Wave theory
- `references/vwap_guide.md` — VWAP và bands
- `references/candlestick_patterns.md` — Mô hình nến
- `references/fundamental_ratios.md` — Chỉ số tài chính
- `references/macro_calendar.md` — Sự kiện vĩ mô
- `references/crypto_glossary.md` — Crypto/DeFi
- `references/bond_analysis.md` — Trái phiếu & Fixed Income
- `references/options_greeks.md` — Options, Greeks, Covered Warrants
- `references/sector_rotation.md` — Vòng quay ngành theo chu kỳ
- `references/vn_market_guide.md` — Đặc thù VN
- `references/upgrade_rules.md` — Quy tắc nâng cấp v5

---
## Nhắc lại: Khi dùng ví dụ thực tế, chạy script trước
Nếu bạn đang viết ví dụ với số liệu thực mà chưa chạy `python scripts/analyze_all.py`, DỪNG LẠI và chạy script ngay bây giờ.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ThanhDatNgo2003](https://github.com/ThanhDatNgo2003)
- **Source:** [ThanhDatNgo2003/claude-market-skills](https://github.com/ThanhDatNgo2003/claude-market-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-thanhdatngo2003-claude-market-skills-market-education
- Seller: https://agentstack.voostack.com/s/thanhdatngo2003
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.