Why it is worth attention

It systematically aggregates and visualizes data from multiple authoritative Vietnamese sources in a single, standardized dashboard, enforcing quality rules and avoiding placeholders.

Who it is for

Vietnamese macroeconomists and analysts
Foreign investors monitoring Vietnam
Academics and researchers in Southeast Asian economics
Data journalists covering Vietnam

Use cases

Monthly economic monitoring and reporting
Investment research preparation
Academic macroeconomic analysis
Policy and business decision support

Strengths

5 official free sources combined into one workflow
4 data quality rules ensure consistency
Fintech-style interactive dashboard with 5 tabs
No placeholder data – only real data used

Considerations

Requires web fetching capabilities (WebSearch, curl, etc.)
Only monthly frequency data – no quarterly or annual adjustments
Not investment advice and no opinionated analysis

README quick start

📊 vn-macro-monthly — Báo cáo vĩ mô Việt Nam hàng tháng

Skill tạo báo cáo vĩ mô VN monthly toàn diện 41 chỉ số từ 5 nguồn chính thức (NSO + Customs + S&P PMI + VBMA + VNBA). Bao phủ 4 trụ cột: sản xuất + ngoại thương + tiền tệ + tài chính.

Cấu trúc skill

vn-macro-monthly/
├── SKILL.md                      # Workflow chính (pre-flight → fetch → extract → render)
├── README.md                     # File này
├── references/
│   ├── core_rules.md             # 4 rules: Time / Frequency / Conflict / Unit
│   ├── sources_overview.md       # 5 nguồn: URL pattern + cách fetch
│   ├── preflight_check.md        # Kiểm tra toàn vẹn + lịch release + user override
│   ├── data_cards.md             # Schema data card + 41 chỉ số + narrative rule
│   ├── rendering.md              # HTML design pattern + 5 tab + placement rule
│   ├── news_sources.md           # Nguồn báo chí enrich (3 nhóm)
│   └── images.md                 # Ảnh minh họa stock (Unsplash)
├── assets/
│   └── report_template.html      # Template HTML dashboard (Chart.js + CSS fintech)
├── scripts/
│   └── qa_report.js              # Automated QA (Playwright)
└── agents/
    └── openai.yaml               # OpenAI agent interface

Workflow 4 bước

Pre-flight — kiểm tra 5 nguồn có sẵn chưa (all-or-nothing, hoặc user override partial)
Fetch + cache — tải 5 nguồn về sources_cache/
Extract — parse → 41 data cards + apply 4 rules + narrative
Render — HTML dashboard 5 tab (Kinh tế thực / Tiền tệ / Ngành / Bối cảnh / Tổng hợp)

Đặc trưng

5 nguồn chính thức miễn phí: NSO, Tổng cục Hải quan, S&P Global PMI, VBMA, VNBA
4 rules chất lượng: Time Consistency, Frequency (monthly-only), Conflict Resolution, Unit Convention
Dashboard đồng style: fintech dark theme, 5 tab nav, click-to-chart (ngủ chờ <6 tháng data)
Nguyên tắc không placeholder: chỉ tạo card khi có data thật
Narrative "người kể chuyện số liệu": KHÔNG cho ý kiến, chỉ kể diễn biến số

Sử dụng

Skill này hoạt động trong môi trường có thể fetch web (WebSearch, WebReader, curl, pdftotext). Kích hoạt:

/vn-macro-monthly 2026-06

Changelog

Xem cuối SKILL.md cho lịch sử thay đổi (bỏ cross-check, thêm nguyên tắc không placeholder, 5 tab, etc.).

License

Miễn phí cho mục đích cá nhân và nghiên cứu. KHÔNG phải lời khuyên đầu tư.

Related repositories

Similar projects matched by category, topics, and programming language.

ViffyGwaanl

Featured

kimi-k3-learn

An interactive learning system that turns the 47-page Kimi K3 technical report into a single offline HTML file with running algorithms, 3D visualizations, spaced repetition quizzes, and a smart highlighting QA tool.

AI & Machine Learning

osama-fawad

Pekingman

Pekingman is a multimodal agent system that integrates perception, long-term memory, human-like reasoning, emotional consistency, and real-time action to create believable NPC behavior.

HTML

933

syabro

neat-annotations

A CSS-only library for adding hand-drawn arrows and handwritten labels to any webpage using a single self-contained stylesheet, no JavaScript or build tools required.

HTML

378