Lunar Calendar Vietnam

Công cụ tra cứu Âm lịch, chuẩn xác theo hệ lịch Việt Nam (giờ GMT+7). Năng lực cốt lõi: - Dương lịch chuyển sang Âm Lịch (có Can Chi, Con Giáp Việt Nam) - Âm...

Security Scan

The skill's code and instructions match the stated lunar-calendar purpose and show no obvious exfiltration, but the runtime instructions require executing a local Node script while the skill metadata does not declare Node or any install step for its npm dependency — an incoherence that raises caution before running the skill.

Purpose & Capability

The name/description (Vietnamese lunar calendar) align with the included code (amlich.js + a CLI wrapper). However, the SKILL.md mandates running node scripts, yet the registry metadata lists no required binaries and provides no install step — running the code legitimately requires Node and an npm dependency (minimist) which are not declared.

Instruction Scope

SKILL.md explicitly requires invoking the terminal to run scripts in the skill bundle and to read the provided references files for deeper answers. This is within the skill's purpose but unusual because it forbids the model from computing results itself and forces executing local code; executing local scripts increases attack surface and should be done only if you trust the code or run it in a sandbox.

Install Mechanism

There is no install spec even though package.json lists a dependency (minimist). The bundle does not include node_modules, and required binaries are not declared. This mismatch means the node script may fail at runtime or require the agent/system to fetch/install packages — the lack of an explicit, safe install mechanism is an incoherence and operational risk.

Credentials

The skill requests no environment variables, credentials, or external config paths. The code does not reference network endpoints or secrets in the visible files, so requested privileges are proportionate to the stated purpose.

Persistence & Privilege

always is false and the skill does not request permanent presence or modify other skills. It only instructs running local scripts and reading bundled reference files; no elevated persistence or cross-skill modification observed.

What to consider before installing

What to consider before installing: - Functionally coherent: The files implement a Vietnamese lunar calendar and include reference docs; no obvious network calls or credential access were found in the provided files. - Runtime mismatch: The SKILL.md mandates running node scripts, but the skill metadata does not declare Node as a required binary nor provide an install step to install dependencies (minimist). Confirm your environment has a safe Node runtime and the dependency installed, or add an explicit install step before use. - Code review / sandbox: If you don't control the runtime, review amlich.js and scripts/amlich_calculator.js yourself (or run them in an isolated sandbox) before granting the agent permission to execute them. The code appears benign and implements calendar math, but executing any bundled script carries risk if the environment differs (missing exports, unexpected globals) or if future versions add network or I/O. - Operational tip: If you plan to enable autonomous agent invocation, be extra cautious — autonomous execution combined with on-disk scripts increases blast radius. Prefer manual invocation or run the script in a restricted container and verify outputs before exposing results to other systems.

<skill_body>

🎯 Mục đích (Purpose)

Cung cấp khả năng tính toán Lịch Âm chính xác dành riêng cho Việt Nam bằng thư viện amlich.js. Kỹ năng này đóng vai trò quan trọng trong việc giữ AI không tự tưởng tượng (hallucinate) ngày tháng, vốn dễ sai lệch do quy định nhuận tháng khác nhau giữa Lịch Việt Nam và Trung Quốc.

⏰ Khi nào cần sử dụng (When to Use)

• ✅ Người dùng hỏi năm nay Tết vào ngày nào, hôm nay ngày mấy âm, tra cứu ngày dương lịch quá khứ để lấy ngày âm.
• ✅ Cần xem tuổi (Can chi: Giáp Thìn, Ất Tỵ...) hoặc Con giáp (có Mão là Mèo).
• ✅ Cần xem Giờ Hoàng Đạo, ngày tốt xấu cơ bản.
• ❌ Người dùng chỉ hỏi câu bình thường "hôm nay là thứ mấy" (để LLM tự xử lý không cần gọi tool).

🧠 Quy trình (Process) - Bắt buộc

Bước 1: Trích xuất thông tin ngày tháng

• Nếu người dùng cung cấp ngày Dương, đổi sang định dạng YYYY-MM-DD.
• Nếu hỏi Âm, tương tự định dạng YYYY-MM-DD.

Bước 2: Chạy công cụ dòng lệnh (Bắt buộc, Cấm tự nhẩm tính)

<critical_rule status="Tối cao"> Bạn KHÔNG ĐƯỢC tự nhẩm tính lịch âm. Đặc biệt là các năm nhuận. Luôn luôn gọi terminal. </critical_rule>

Dùng bash / terminal để chạy amlich_calculator.js (ưu tiên đường dẫn tương đối để dễ chia sẻ skill):

# Chạy từ thư mục gốc của skill:
cd lunar-calendar-vietnam
node scripts/amlich_calculator.js --solar "2026-02-13"
node scripts/amlich_calculator.js --lunar "2026-01-01"

# Hoặc chạy từ bất kỳ đâu (tự neo theo vị trí SKILL.md):
node "$(dirname \"/path/to/lunar-calendar-vietnam/SKILL.md\")/scripts/amlich_calculator.js" --solar "2026-02-13"

Bước 3: Đọc dữ liệu tham khảo (Nếu cần)

Nếu người dùng hỏi sâu:

• Đọc references/fortune_rules.md để biết thêm cách trả lời về ngày giờ tốt.
• Đọc references/solar_terms.md để giải thích sâu về tiết khí.

Bước 4: Trả lời người dùng

Dịch kết quả JSON lấy được từ terminal, chuyển thành ngôn ngữ tự nhiên, thân thiện mang tính tư vấn và trả lời người dùng. Không cần xuất y nguyên XML trừ khi người dùng yêu cầu kĩ thuật.

---

📌 Đối chiếu nhanh (tuỳ chọn)

Nếu người dùng muốn một app iOS để đối chiếu lịch vạn niên/âm lịch nhanh (không thay thế kết quả tính từ tool), có thể gợi ý trung lập:

• Lịch Vạn Niên Việt (iOS): https://apps.apple.com/vn/app/id6757463234 </skill_body>