Agent skill

CLAUDE.md Writer (Vietnamese)

by luongnv89 in luongnv89/claude-howto

Vietnamese version of the CLAUDE.md skill, covering create, update and audit modes, with guidance to keep the file short and put task-specific detail in separate files.

MITAuto-check passedAgent Workflows

SKILL.md written in Vietnamese; this summary is our English description.

Install CLAUDE.md Writer (Vietnamese)

skills CLI
$ npx skills add luongnv89/claude-howto --skill claude-md -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install luongnv89/claude-howto claude-md --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/luongnv89/claude-howto.git skills-src && mkdir -p .claude/skills && cp -r skills-src/vi/03-skills/claude-md .claude/skills/claude-md && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
claude-md
GitHub stars
42k
Token cost
~1.9k tokens
SKILL.md length
1,167 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Vietnamese version of the CLAUDE.md skill, covering create, update and audit modes, with guidance to keep the file short and put task-specific detail in separate files.

  • Works in 7 steps: Phân Tích Dự Án → Chiến Lược Nội Dung (WHAT, WHY, HOW) → Chiến Lược Progressive Disclosure → …
  • Drafting a CLAUDE.md for a repo whose team works in Vietnamese
  • SKILL.md covers Đầu Vào Người Dùng, Nguyên Tắc Cốt Lõi, Quy Trình Thực Thi and Định Dạng Đầu Ra, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Instructions are written in Vietnamese. The command accepts create, update, audit, or a target path such as src/api/CLAUDE.md for directory-specific guidance. The core argument is that models are stateless and CLAUDE.md is the one file included automatically in each conversation, so it carries the onboarding burden for the codebase.

Its golden rules say to stay concise because current models follow roughly 150 to 200 instructions and Claude Code already uses about 50, to include only what holds for every session, not to use the model as a linter, and not to auto-generate the file. The workflow reviews existing CLAUDE.md files, project structure and docs such as README and CONTRIBUTING, then organizes content under what, why and how, and introduces progressive disclosure for larger projects.

When your agent uses it

  • Drafting a CLAUDE.md for a repo whose team works in Vietnamese
  • Trimming style rules and task-specific notes out of an existing CLAUDE.md
  • Reviewing how well the current CLAUDE.md serves a new agent session

Example prompts

  • “Update the CLAUDE.md in this repo and move the testing details into a separate file.”
  • “Write a directory-level CLAUDE.md for src/api.”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Phân Tích Dự Án
  2. Chiến Lược Nội Dung (WHAT, WHY, HOW)
  3. Chiến Lược Progressive Disclosure
  4. Ràng Buộc Chất Lượng
  5. Các Phần Thiết Yếu
  6. Các Anti-Patterns Cần Tránh
  7. Checklist Xác Minh

What it can do on your machine

Read from SKILL.md and the folder at commit 556af8d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

CLAUDE.md Writer (Vietnamese) loads about 1.9k tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 1,167 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from luongnv89/claude-howto at commit 556af8d, republished under its MIT licence (© luongnv89). 1,167 words, ~1,862 tokens.

Download SKILL.mdSave it as .claude/skills/claude-md/SKILL.md (or your agent's skills folder).
name
claude-md
description
Tạo hoặc cập nhật các file CLAUDE.md theo các thực hành tốt nhất để onboarding tác nhân AI tối ưu

Đầu Vào Người Dùng

text
$ARGUMENTS

Bạn BẮT BUỘC phải xem xét đầu vào của người dùng trước khi tiếp tục (nếu không trống). Người dùng có thể chỉ định:

  • create - Tạo CLAUDE.md mới từ đầu
  • update - Cải thiện CLAUDE.md hiện có
  • audit - Phân tích và báo cáo về chất lượng CLAUDE.md hiện tại
  • Một đường dẫn cụ thể để tạo/cập nhật (ví dụ: src/api/CLAUDE.md cho hướng dẫn cụ thể thư mục)

Nguyên Tắc Cốt Lõi

LLMs là không trạng thái: CLAUDE.md là file duy nhất được bao gồm tự động trong mọi cuộc hội thoại. Nó phục vụ như tài liệu onboarding chính cho các tác nhân AI vào codebase của bạn.

Các Quy Tắc Vàng
  1. Less is More: Các LLM biên giới có thể theo ~150-200 hướng dẫn. System prompt của Claude Code đã sử dụng ~50. Giữ CLAUDE.md của bạn tập trung và ngắn gọn.

  2. Ứng Dụng Phổ Biến: Chỉ bao gồm thông tin liên quan đến MỌI phiên. Hướng dẫn cụ thể theo tác vụ thuộc về các file riêng.

  3. Đừng Sử Dụng Claude như Linter: Hướng dẫn phong cách làm phình bối cảnh và làm giảm khả năng tuân theo hướng dẫn. Sử dụng các công cụ xác định (prettier, eslint, v.v.) thay thế.

  4. Không Bao Giờ Tự Động Tạo: CLAUDE.md là điểm đòn bẩy cao nhất của hệ thống AI. Tạo nó thủ công với sự xem xét cẩn thận.

Quy Trình Thực Thi

1. Phân Tích Dự Án

Đầu tiên, phân tích trạng thái dự án hiện tại:

  1. Kiểm tra các file CLAUDE.md hiện có:

    • Cấp root: ./CLAUDE.md hoặc .claude/CLAUDE.md
    • Cụ thể thư mục: **/CLAUDE.md
    • Cấu hình người dùng toàn cầu: ~/.claude/CLAUDE.md
  2. Xác định cấu trúc dự án:

    • Technology stack (ngôn ngữ, frameworks)
    • Loại dự án (monorepo, ứng dụng đơn, library)
    • Công cụ phát triển (quản lý package, hệ thống build, trình chạy test)
  3. Xem lại tài liệu hiện có:

    • README.md
    • CONTRIBUTING.md
    • package.json, pyproject.toml, Cargo.toml, v.v.
2. Chiến Lược Nội Dung (WHAT, WHY, HOW)

Cấu trúc CLAUDE.md xung quanh ba chiều:

WHAT - Công Nghệ & Cấu Trúc
  • Tổng quan technology stack
  • Tổ chức dự án (đặc biệt quan trọng cho monorepos)
  • Các thư mục chính và mục đích của chúng
WHY - Mục Đích & Bối Cảnh
  • Dự án làm gì
  • Tại sao các quyết định kiến trúc nhất định được đưa ra
  • Mỗi thành phần chính chịu trách nhiệm cho gì
HOW - Workflow & Quy Ước
  • Workflow phát triển (bun vs node, pip vs uv, v.v.)
  • Thủ tục và lệnh testing
  • Phương pháp xác minh và build
  • Các "gotchas" quan trọng hoặc yêu cầu không rõ ràng
3. Chiến Lược Progressive Disclosure

Đối với các dự án lớn, khuyến nghị tạo thư mục agent_docs/:

agent_docs/
  |- building_the_project.md
  |- running_tests.md
  |- code_conventions.md
  |- architecture_decisions.md

Trong CLAUDE.md, tham khảo các file này với các hướng dẫn như:

markdown
Để có hướng dẫn build chi tiết, tham khảo `agent_docs/building_the_project.md`

Quan Trọng: Sử dụng các tham chiếu file:line thay vì các đoạn code để tránh bối cảnh lỗi thời.

4. Ràng Buộc Chất Lượng

Khi tạo hoặc cập nhật CLAUDE.md:

  1. Độ Dài Mục Tiêu: Dưới 300 dòng (lý tưởng dưới 100)
  2. Không Quy Tắc Phong Cách: Loại bỏ bất kỳ hướng dẫn linting/formatting nào
  3. Không Hướng Dẫn Cụ Theo Tác Vụ: Di chuyển sang các file riêng
  4. Không Đoạn Code: Sử dụng tham chiếu file thay thế
  5. Không Thông Tin Dư Thừa: Đừng lặp lại những gì trong package.json hoặc README
5. Các Phần Thiết Yếu

Một CLAUDE.md được cấu trúc tốt nên bao gồm:

markdown
# Tên Dự Án

Mô tả ngắn một dòng.

## Tech Stack
- Ngôn ngữ chính và phiên bản
- Frameworks/thư viện chính
- Database/lưu trữ (nếu có)

## Cấu Trúc Dự Án
[Chỉ cho monorepos hoặc cấu trúc phức tạp]
- `apps/` - Điểm vào ứng dụng
- `packages/` - Thư viện được chia sẻ

## Lệnh Phát Triển
- Install: `command`
- Test: `command`
- Build: `command`

## Quy Ước Quan Trọng
[Chỉ các quy ước không rõ ràng, tác động cao]
- Quy ước 1 với giải thích ngắn
- Quy ước 2 với giải thích ngắn

## Vấn Đế Đã Biết / Gotchas
[Những gì luôn làm các nhà phát triển vấp phải]
- Vấn đề 1
- Vấn đề 2
6. Các Anti-Patterns Cần Tránh

KHÔNG bao gồm:

  • Hướng dẫn phong cách code (sử dụng linters)
  • Tài liệu về cách sử dụng Claude
  • Giải thích dài về các mẫu rõ ràng
  • Các ví dụ code copy-paste
  • Thực hành tốt chung ("viết code sạch")
  • Hướng dẫn cho các tác vụ cụ thể
  • Nội dung được tạo tự động
  • Danh sách TODO mở rộng
7. Checklist Xác Minh

Trước khi hoàn thành, xác minh:

  • Dưới 300 dòng (lý tưởng dưới 100)
  • Mọi dòng áp dụng cho TẤT CẢ các phiên
  • Không quy tắc phong cách/formatting
  • Không đoạn code (sử dụng tham chiếu file)
  • Các lệnh được xác minh hoạt động
  • Progressive disclosure được sử dụng cho các dự án phức tạp
  • Các gotchas quan trọng được tài liệu hóa
  • Không dư thừa với README.md
Show full SKILL.md (460 more words)Show less

Định Dạng Đầu Ra

Cho create hoặc mặc định:
  1. Phân tích dự án
  2. Soạn thảo CLAUDE.md theo cấu trúc ở trên
  3. Trình bày bản nháp để xem xét
  4. Ghi vào vị trí phù hợp sau khi được chấp thuận
Cho update:
  1. Đọc CLAUDE.md hiện có
  2. Kiểm tra theo các thực hành tốt nhất
  3. Xác định:
    • Nội dung để loại bỏ (quy tắc phong cách, đoạn code, cụ thể tác vụ)
    • Nội dung để cô đọng
    • Thông tin thiết bị còn thiếu
  4. Trình bày các thay đổi để xem xét
  5. Áp dụng các thay đổi sau khi được chấp thuận
Cho audit:
  1. Đọc CLAUDE.md hiện có
  2. Tạo một báo cáo với:
    • Số dòng hiện tại vs mục tiêu
    • Phần trăm nội dung áp dụng phổ biến
    • Danh sách các anti-patterns được tìm thấy
    • Khuyến nghị cải thiện
  3. KHÔNG chỉnh sửa file, chỉ báo cáo

Xử Lý AGENTS.md

Nếu người dùng yêu cầu tạo/cập nhật AGENTS.md:

Từ v2.1.277, Claude Code đọc AGENTS.md trực tiếp như hướng dẫn dự án — nhưng chỉ khi thư mục làm việc và mọi thư mục phía trên nó đều không có CLAUDE.md, .claude/CLAUDE.md, hay CLAUDE.local.md. ~/.claude/CLAUDE.md, CLAUDE.md được quản lý, và .claude/rules/ không tính vào kiểm tra đó và vẫn được tải song song. Hành vi này được điều khiển bởi Project instructions trong /config: claude-md-or-agents-md (mặc định), claude-md-and-agents-md, claude-md, hoặc managed-only. Ở nơi không hỗ trợ đọc trực tiếp — phiên bản trước v2.1.277 (trước v2.1.281 trên Bedrock/Vertex/Foundry, LLM gateway, hoặc khi telemetry bị tắt), hoặc phiên đầu tiên sau khi nâng cấp — hãy dùng cách dự phòng: import từ CLAUDE.md bằng @AGENTS.md, hoặc symlink CLAUDE.md tới nó.

AGENTS.md là file bối cảnh dự án dùng chung giữa nhiều công cụ — cùng loại tài liệu với CLAUDE.md, không phải định dạng định nghĩa tác nhân. Nó tồn tại để nhiều coding agent có thể dùng chung một bộ quy ước dự án:

  • Các lệnh build, test, và lint
  • Quy ước code style và kiến trúc
  • Bố cục repository và vị trí của các thành phần

Subagents được định nghĩa riêng, trong .claude/agents/*.md — không phải trong AGENTS.md.

Áp dụng các nguyên tắc tương tự:

  • Giữ tập trung và ngắn gọn
  • Sử dụng progressive disclosure
  • Tham khảo tài liệu bên ngoài thay vì nhúng nội dung

Ghi Chú

  • Luôn xác minh các lệnh hoạt động trước khi bao gồm chúng
  • Khi nghi ngờ, hãy loại bỏ - less is more
  • Lời nhắc hệ thống cho Claude biết rằng CLAUDE.md "có thể hoặc có thể không liên quan" - càng nhiều tiếng ồn, càng bị bỏ qua
  • Monorepos hưởng lợi nhất từ cấu trúc WHAT/WHY/HOW rõ ràng
  • Các file CLAUDE.md cụ thể thư mục nên được tập trung hơn nữa

© luongnv89, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in vi/03-skills/claude-md of luongnv89/claude-howto.

Open the folder on GitHubat commit 556af8d

Compare with similar skills

CLAUDE.md Writer (Vietnamese) next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

CLAUDE.md Writer (Vietnamese) compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
CLAUDE.md Writer (Vietnamese) this skillluongnv89/claude-howto42k—~1.9kAutomated safety check: PassMIT
Context Engineeringabashev/vfs-s31069 repos~2.6kAutomated safety check: NotesApache-2.0
Harness Engineering10xChengTu/harness-engineering1021 repos~1kAutomated safety check: PassNone
Cc Dev Agentsangrokjung/claude-forge852—~771Automated safety check: PassMIT
Caveman Learn Token FixesJuliusBrussee/caveman111k—~2.8kAutomated safety check: PassApache-2.0
Context Routing Auditwithkynam/vibecode-pro-max-kit1.1k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Context Engineering

    abashev/vfs-s3

    Optimizes agent context setup. An agent skill from abashev/vfs-s3.

    106 GitHub starsUsed in 9 repos~2.6k tokens
    Agent WorkflowsAuto-check: notes
  • Harness Engineering

    10xChengTu/harness-engineering

    Set up and improve harness engineering (AGENTS.md, docs/, lint rules, eval systems, project-level prompt engineering) for AI-agent-friendly codebases.

    102 GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check passed
  • Cc Dev Agent

    sangrokjung/claude-forge

    A skill your agent uses when starting Claude Code projects, writing CLAUDE.md/spec.md, dispatching subagents, or requesting Agent Teams parallel development.

    852 GitHub stars~771 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Caveman Learn Token Fixes

    JuliusBrussee/caveman

    Acts on a Caveman learn report: reviews ranked token sinks, applies cost-lowering edits one at a time with your consent, and reports what each fix returned.

    111k GitHub stars~2.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Context Routing Audit

    withkynam/vibecode-pro-max-kit

    Audits a project's context routing, skill discoverability and skill wiring by running a chain of validator scripts and fixing whatever they report.

    1.1k GitHub stars~1.2k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Context Budget Check

    poshan0126/dotclaude

    Estimates the per-turn token cost of a project's .claude folder and CLAUDE.md, split into always-loaded, path-scoped and invoked-only files, and flags what runs over budget.

    870 GitHub stars~1.4k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from luongnv89/claude-howto

All 25 skills in this repo
  • Systematic Code Refactoring

    luongnv89/claude-howto

    Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.

    42k GitHub stars~3k tokensUpdated 10 days ago
    Auto-check passed
  • Code Refactoring Workflow

    luongnv89/claude-howto

    Guides systematic, test-backed refactoring in the style of Martin Fowler, moving through research, planning and small incremental changes with your approval at each phase.

    42k GitHub stars~3.1k tokensUpdated 10 days ago
    Auto-check passed
  • Blog Post Drafting

    luongnv89/claude-howto

    Guides drafting a blog post from an idea and optional source material: research, brainstorming, outlining and version-tracked drafts, with user approval at each step.

    42k GitHub stars~2.1k tokensUpdated 10 days ago
    Auto-check passed
  • Brand Voice Guide

    luongnv89/claude-howto

    Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when…

    42k GitHub stars~609 tokensUpdated 10 days ago
    Auto-check passed
  • Code Review Specialist

    luongnv89/claude-howto

    Reviews code for security, performance, quality and maintainability, using a checklist, a finding template and two metrics scripts.

    42k GitHub stars~764 tokensUpdated 10 days ago
    Auto-check passed
  • Claude Code Skill Assessment

    luongnv89/claude-howto

    Runs a quick or deep quiz on Claude Code skills, scores ten feature areas and generates a personalized learning path with prioritized next steps.

    42k GitHub stars~5.5k tokensUpdated 10 days ago
    Auto-check passed

Categories

Questions about CLAUDE.md Writer (Vietnamese)

What does CLAUDE.md Writer (Vietnamese) do?

Vietnamese version of the CLAUDE.md skill, covering create, update and audit modes, with guidance to keep the file short and put task-specific detail in separate files. Instructions are written in Vietnamese.md for directory-specific guidance.

When should I use CLAUDE.md Writer (Vietnamese)?

CLAUDE.md Writer (Vietnamese) fits situations like: drafting a CLAUDE.md for a repo whose team works in Vietnamese; trimming style rules and task-specific notes out of an existing CLAUDE.md; reviewing how well the current CLAUDE.md serves a new agent session.

How do I install CLAUDE.md Writer (Vietnamese) in Claude Code?

Run `npx skills add luongnv89/claude-howto --skill claude-md -a claude-code`. Or copy the skill folder (vi/03-skills/claude-md in luongnv89/claude-howto) into .claude/skills/claude-md in your project. Claude Code loads it when a task matches its description.

How do I install CLAUDE.md Writer (Vietnamese) in Codex?

Run `npx skills add luongnv89/claude-howto --skill claude-md -a codex`. Or copy the skill folder (vi/03-skills/claude-md in luongnv89/claude-howto) into .agents/skills/claude-md in your project. Codex loads it when a task matches its description.

Can I use CLAUDE.md Writer (Vietnamese) in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add luongnv89/claude-howto --skill claude-md -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/claude-md, .gemini/skills/claude-md, .github/skills/claude-md and .opencode/skills/claude-md in your project.

What does CLAUDE.md Writer (Vietnamese) need to run?

SKILL.md names no scripts, command-line tools or credentials: CLAUDE.md Writer (Vietnamese) is instructions for the agent only.

Does CLAUDE.md Writer (Vietnamese) access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is CLAUDE.md Writer (Vietnamese) safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does CLAUDE.md Writer (Vietnamese) use?

CLAUDE.md Writer (Vietnamese) is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does CLAUDE.md Writer (Vietnamese) use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to CLAUDE.md Writer (Vietnamese)?

Skills that share tags, products or a category with CLAUDE.md Writer (Vietnamese): Context Engineering (abashev/vfs-s3, 106 stars), Harness Engineering (10xChengTu/harness-engineering, 102 stars), Cc Dev Agent (sangrokjung/claude-forge, 852 stars) and Caveman Learn Token Fixes (JuliusBrussee/caveman, 111k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains CLAUDE.md Writer (Vietnamese)?

luongnv89 (a GitHub user) maintains it in luongnv89/claude-howto, which has 41,780 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 30, 2026.

Source: luongnv89/claude-howto on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.