Installation

Add to your Claude Code skills directory:

# Add to your Claude Code skills
git clone https://github.com/phungthien269/VN-caveman

Security Report

Verified

Last scanned: —

{
  "status": "PASSED",
  "issues": []
}

README.md

VNcaveman

Name: VN-caveman
Author: phungthien269

ít token hơn, ít filler hơn, vẫn giữ nguyên ý kỹ thuật

Before/After • Install • Levels • Skills • Benchmarks • Evals

VNcaveman là repo Vietnamese-first cho bộ skill nén phản hồi gon: ngắn hơn, sắc hơn, ít token hơn, nhưng vẫn giữ nguyên ý kỹ thuật.

Repo này lấy cảm hứng từ caveman, nhưng không giữ persona "người tối cổ". Mục tiêu là câu trả lời ngắn hơn, tự nhiên hơn với dev Việt, và vẫn đủ sắc để dùng trong workflow thật.

gon tối ưu token bằng cách xử lý cả input lẫn output text:

chuẩn hóa intent từ prompt verbose sang chỉ thị ngắn, rõ, dev-like
cắt xã giao, hedge, đệm lời và các cấu trúc dài dòng không thêm ý
giữ nguyên code, command, URL, path, log, warning và proper noun
nén prose mạnh hơn, nhưng tự tăng clarity khi task có rủi ro cao
ưu tiên ratio ít token hơn / không mất nghĩa thay vì rút câu máy móc

Before / After

🗣️ Agent bình thường

"Có khả năng component của bạn đang bị re-render vì ở mỗi lần render bạn lại tạo ra một object mới và truyền object đó xuống dưới dạng prop. React so sánh nông nên sẽ coi đó là prop mới mỗi lần."

⚡ `gon` (`full`)

"Re-render do mỗi render tạo object mới. Prop object inline luôn ra ref mới. React thấy prop đổi. Dùng useMemo."

🗣️ Agent bình thường

"Mình nghĩ nguyên nhân nhiều khả năng nằm ở middleware xác thực. Bạn đang kiểm tra thời điểm hết hạn của token theo cách chưa chặt, nên token vừa hết hạn vẫn có thể lọt qua."

⚡ `gon` (`full`)

"Lỗi ở auth middleware. Check expiry đang sai đơn vị. exp là giây, Date.now() là ms. So sánh lại với exp * 1000."

Cùng ý kỹ thuật. Ít chữ hơn. Dễ scan hơn.

Chọn mức nén bạn muốn:

🪶 Lite

"Component re-render vì mỗi lần render bạn tạo object mới. React thấy ref mới nên render lại. Dùng useMemo."

⚡ Full

"Re-render do mỗi render tạo object mới. Prop inline ra ref mới. Dùng useMemo."

🔥 Ultra

"Inline obj -> ref mới -> re-render. useMemo."

Cùng ý. Bạn chọn độ gọn.

┌─────────────────────────────────────┐
│  TOKEN WASTE DOWN       ████████    │
│  TECHNICAL FIDELITY     ████████    │
│  READ SPEED             ████████    │
│  FILLER                 ██          │
└─────────────────────────────────────┘

Đọc nhanh hơn — ít chữ thừa, vào thẳng vấn đề
Scan tốt hơn — debug, review, commit message, docs đều gọn hơn
Không phá kỹ thuật — code, command, path, URL, log vẫn giữ nguyên
An toàn hơn khi cần — gặp destructive ops, prod, security, migration thì tự tăng clarity

Install

Chọn surface phù hợp. Repo này hiện mạnh nhất ở dạng clone + dùng local rules/hooks/plugin surfaces.

Surface	Cách dùng
Claude Code hooks	clone repo rồi chạy `./hooks/install.sh` hoặc `./hooks/install.ps1`
Codex repo-local	clone repo, mở trong Codex, dùng `.codex/config.toml` + `.codex/hooks.json`
Gemini CLI	dùng `GEMINI.md` + `gemini-extension.json` trong repo
Cursor / Windsurf / Cline / Copilot	dùng các rule files có sẵn trong repo
Skill files trực tiếp	mở `skills/` và dùng `SKILL.md` tương ứng

Install once. Dùng lại trong workflow hằng ngày.

What You Get

Feature	Claude Code	Codex	Gemini CLI	Cursor	Windsurf	Cline	Copilot
`gon` mode	Y	Y	Y	Y	Y	Y	Y
Auto-activate every session	Y	Y¹	Y	Y²	Y²	Y²	Y²
Mode switching (`lite/full/ultra`)	Y	Y¹	Y	Y	Y	—	—
Statusline badge	Y	—	—	—	—	—	—
`gon-commit`	Y	Y	Y	Y	Y	Y	Y
`gon-review`	Y	Y	Y	Y	Y	Y	Y
`gon-compress`	Y	Y	Y	Y	Y	Y	Y
`gon-help`	Y	Y	Y	Y	Y	Y	Y

[!NOTE] ¹ Codex repo-local auto-start phụ thuộc .codex/hooks.json trong repo này.

² Cursor, Windsurf, Cline, Copilot dùng rule/instruction files nằm ngay trong repo. Nếu mang skill đi repo khác, bạn cần copy surface tương ứng hoặc cấu hình lại.

Levels

Level	Trigger	Mục tiêu
Lite	`/gon lite`	Bỏ filler nhưng vẫn là câu đầy đủ
Full	`/gon full`	Ngắn, trực diện, cân bằng nhất
Ultra	`/gon ultra`	Cực ngắn, shorthand dev, vẫn đủ nghĩa

Trigger phổ biến:

gon mode
trả lời gọn
nói ngắn hơn
ít token hơn

Tắt bằng:

stop gon
normal mode
trả lời bình thường

Skills

`gon`

Skill chính cho response compression tiếng Việt kỹ thuật.

skills/gon/SKILL.md

`gon-commit`

Commit message ngắn, đúng chuẩn, ít lan man.

skills/gon-commit/SKILL.md

`gon-review`

Code review ngắn, dễ scan, tập trung bug/risk/fix.

skills/gon-review/SKILL.md

`gon-help`

Quick reference cho mode, trigger và skill surfaces.

skills/gon-help/SKILL.md

`gon-compress`

Nén prose/docs để agent đọc ít token hơn, không chỉ trả ít token hơn.

Nó:

phát hiện prose/docs vs code/config
tạo backup .original.md
nén prose tiếng Việt
validate heading, code block, URL, path
retry fix tối đa 2 lần nếu validation fail
chặn path có dấu hiệu chứa secret/key

Benchmarks

Hiện repo đã có benchmark runner, nhưng chưa commit benchmark thật vào README.

Chạy benchmark:

uv run python benchmarks/run.py --dry-run

Nếu có ANTHROPIC_API_KEY:

uv run python benchmarks/run.py --update-readme

[!IMPORTANT] Repo này không bịa số benchmark. Chỉ chèn số vào README khi có run thật.

Evals

evals/ đo mức nén token thật theo mô hình:

__baseline__
__terse__
từng skill trong skills/

# chạy eval (cần claude CLI)
uv run python evals/llm_run.py

# đọc kết quả offline
uv run --with tiktoken python evals/measure.py

Mục tiêu là đo đúng phần skill đóng góp, không gian lận kiểu so với output verbose mặc định.

Star This Repo

Nếu repo này giúp agent trả lời gọn hơn, dễ đọc hơn, ít token hơn, hãy để lại một star.

Repo đang cần star thật từ người dùng thật, không phải star rác.

More Docs

License

MIT. Xem LICENSE.

Frequently Asked Questions

What is VN-caveman?⌄

VN-caveman is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by phungthien269. It has 0 GitHub stars.

Is VN-caveman safe to use?⌄

Yes. VN-caveman passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install VN-caveman?⌄

Clone the repository with "git clone https://github.com/phungthien269/VN-caveman" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is VN-caveman written in?⌄

VN-caveman is primarily written in Python. It is open-source under phungthien269 on GitHub, so you can review or fork the full source.

Are there alternatives to VN-caveman?⌄

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh VN-caveman against similar tools.

VN-caveman

Installation

Getting Started

Security Report

README.md

VNcaveman

Before / After

🗣️ Agent bình thường

⚡ gon (full)

🗣️ Agent bình thường

⚡ gon (full)

🪶 Lite

⚡ Full

🔥 Ultra

Install

What You Get

Levels

Skills

gon

gon-commit

gon-review

gon-help

gon-compress

Benchmarks

Evals

Star This Repo

More Docs

License

Frequently Asked Questions

Comments (0)

Related Skills

Developers Also Liked

⚡ `gon` (`full`)

⚡ `gon` (`full`)

`gon`

`gon-commit`

`gon-review`

`gon-help`

`gon-compress`