Market Education

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.