TL;DR

Claude Skills là folder chứa SKILL.md — tài liệu markdown với YAML frontmatter — mà Claude tự động tải khi task khớp. Thay vì re-paste context mỗi chat, bạn encode expertise lần, rồi Claude áp dụng tự động. Skills lên từ tháng 10/2025 và nhanh chóng thành cách dominant để mở rộng Claude. Kiến trúc progressive disclosure cho phép 50+ skills cùng lúc mà không làm chậm context. Có 2 loại: Capability Uplift (dùng Python/Bash để đưa khả năng mới) và Encoded Preference (tuân thủ quy cách cụ thể của team bạn).

Claude Skills là gì?

Claude Skills là gói hướng dẫn tái sử dụng mà Claude tự động kích hoạt khi bạn yêu cầu công việc phù hợp. Thay vì phải gõ lại "dùng brand color #141413" hoặc "tuân thủ commit format của mình" mỗi lần, bạn tạo skill một lần, encode quy tắc vào SKILL.md, rồi Claude apply tự động mỗi khi bạn ask về task đó.

Skill là một folder đơn giản, chứa tối thiểu một file SKILL.md (case-sensitive) và tuỳ chọn các subfolder: scripts/ (code thực thi), references/ (tài liệu dùng lúc cần), và assets/ (template, font, ảnh). Không cần model, plugin, hay install external. Chỉ là markdown + optional code.

Kiến trúc Progressive Disclosure

Skills dùng hệ thống tải 3 level, tối ưu cho token efficiency:

Progressive disclosure architecture
Kiến trúc gồm 3 layer: frontmatter luôn load (~100 tokens), body load khi cần, files lớn load on-demand.
  1. YAML Frontmatter (~100 tokens) — Luôn được load vào system prompt. Chứa name (identifier) và description (trigger mechanism). Claude đọc description để quyết định có kích hoạt skill không.
  2. SKILL.md Body (~5,000 tokens) — Full playbook với step-by-step instructions, ví dụ, troubleshooting. Load chỉ khi Claude xác định skill relevant.
  3. Reference Files (unlimited) — Tài liệu dài, API guide, script. Load on-demand khi task yêu cầu, không bao giờ default load.

Điều này cho phép bạn có 50+ skills installed mà chỉ metadata (~100 tokens mỗi skill) load by default. Unrelated tasks không bị ảnh hưởng.

Hai loại Skills: Capability Uplift vs Encoded Preference

Trước khi viết code, hãy phân loại skill của bạn:

Capability Uplift Skills

Cho Claude khả năng nó không có sẵn. Ví dụ: tạo PDF format tốt, crawl web, chạy browser automation, xử lý data. Loại này thường kèm executable scripts (Python/Bash) bundled trong skill.

Ví dụ thực tiễn:

  • docx skill — Unpack MS Word file thành raw XML, edit tracked changes với `<w:ins>`/`<w:del>` tags, implement complex redlining. Cần pandoc, LibreOffice, defusedxml.
  • sales-data-analyzer — Ingest revenue CSV, tính MoM growth, flag anomalies. Chỉ có chỉ dành cho Capability Uplift.

Encoded Preference Skills

Capture cách specific của team bạn để làm công việc mà Claude đã biết. Ví dụ: Claude đã biết viết code, nhưng skill encode commit message format team bạn, code review checklist, hay brand language.

Loại này thường chỉ là SKILL.md + instructions (không code):

  • brand-guidelines — RGB color, typography (Poppins/Lora), tone of voice. Claude apply vào bất kỳ generated asset.
  • blog-content-writer — H2 headers phải là claims cụ thể (không vague labels), paragraph 2-4 sentences, sentence <30 words, 7-point quality checklist before delivery.
  • frontend-design — Disable generic "AI slop" (Inter font, purple gradient). Force Claude pick bold aesthetic direction (brutalism, retro, maximalism, etc.), use distinctive typography, spatial composition.

5 Bước Tạo Skill

Bước 1: Định nghĩa use case

Trước khi viết code, định nghĩa 2-3 trigger scenario cụ thể. Không phải "helps with sales" (quá abstract), mà "analyze this month's revenue CSV", "find patterns in deals sheet", "chart Q3 performance".

Rule of thumb: Đã làm task này ≥5 lần? Sẽ làm ≥10 lần nữa? Nếu có, skill có giá trị.

Bước 2: Chốt tên

Dùng kebab-case, chữ thường, match với folder name. Tối đa 64 ký tự. Ví dụ: client-follow-up-email, code-reviewer, frontend-design.

Cấm: Chứa "claude" hoặc "anthropic" (reserved).

Bước 3: Viết description

Đây là phần quan trọng nhất. Description là trigger mechanism — Claude đọc nó để quyết định có load skill không.

Formula tốt: [Trigger phrase] + [Nó làm gì] + [Output là gì]

Ví dụ tốt:

  • ❌ "Helps with writing" (quá vague, chẳng trigger)
  • ✅ "When I paste raw meeting notes and ask for a client follow-up email. Turns messy notes into clear professional follow-up with next steps." (specific trigger + output)

Limit: 1,024 ký tự (recommended <200 cho Claude.ai để trigger reliably). Mô tả càng cụ thể, trigger rate càng cao.

Bước 4: Viết instructions

Markdown body chứa full playbook. Áp dụng những nguyên tắc:

  • Specific và actionable — "state what to do, not why". Nếu cần tránh sai lầm, write "Do not modify existing code — only report issues".
  • Numbered steps cho procedures — Claude follow sequence tốt hơn unstructured prose.
  • Concrete examples — Show input/output example, làm rõ bạn expect gì.
  • Giữi tận ~500 dòng (~5,000 words) — Nếu quá dài, di reference material vào `references/` folder.

Bước 5: Test trên thực

Viết prompt trigger skill bạn vừa tạo. Kiểm tra:

  • Skill có trigger không? Nếu không, tighten description.
  • Output có follow instructions? Nếu không, clarify steps.
  • Test edge case + out-of-scope inputs để verify boundaries.

Ví Dụ Thực Tiễn

Dưới đây là 3 production skills đã được validate:

  • frontend-design (277,000+ installs) — Force Claude generate production-grade UI instead of generic "AI aesthetic" (Inter font, purple gradient). Encode bold design direction, distinctive typography, advanced spatial layout.
  • code-reviewer — Systematic PR review với configurable focus areas: security, performance, style. Best combined với Claude Code git worktree workflow cho parallel PR review.
  • docx (Advanced Document Editor) — Unpack Word docs thành raw XML. Perform complex redlining bằng cách edit `<w:ins>`/`<w:del>` tags. Precise, minimal edits instead of replacing entire paragraphs.
Workflow diagram
Quy trình từ lên ý tưởng đến triển khai: Plan → Write SKILL.md → Add Scripts → Install → Deploy.

Hạn Chế và Yêu Cầu

Technical Constraints

Claude silently fail khi bạn vi phạm rule — không error message:

  • SKILL.md case-sensitive — skill.md, Skill.md sẽ bị ignore.
  • Folder name kebab-case — my-skill, không MySkill hay my_skill.
  • Tên không chứa "claude" hay "anthropic" (reserved).
  • Không có README.md trong skill folder — Doc dành cho Claude vào SKILL.md hoặc references/.
  • Không XML angle brackets trong frontmatter — Security risk (prompt injection).

Plan Requirements

Để upload custom skills trên Claude.ai:

  • Pro, Max, Team, hoặc Enterprise plan (Free không support custom skills).
  • "Code execution" phải enable trong Settings > Capabilities.
  • Enterprise: Admin phải enable cả "Code execution" + "Skills" trước khi members dùng.

Limitation: Triggering

Claude không dùng keyword matching — nó evaluate semantic relationship giữa user prompt và skill description.

  • Vague description → skill chẳng trigger.
  • Generic description → trigger inappropriately cho unrelated task.
  • Multiple skills có thể activate cùng lúc nếu cùng address khía cạnh của complex task.

Security Consideration

Skills có thể instruct Claude execute arbitrary code, install packages (pip/npm), hay connect external networks. Luôn review skill từ external source trước khi enable — kiểm tra Bash commands, hardcoded secrets, prompt injection, obfuscation.

Pricing và Availability

  • SKILL.md format là open-source, hoàn toàn free — Tạo, chia sẻ, dùng đều không mất tiền.
  • Official Anthropic skills — Mostly Apache 2.0 licensed, free.
  • Community skills — Free, hoặc premium trên third-party marketplace.
  • Portability across surfaces — Một skill build lần, works trên Claude.ai, Claude Code, và Claude API (miễn là env support dependencies).

Timeline và Roadmap

  • October 2025 — Claude Skills officially launch.
  • November 2025 — Anthropic publish official guidance, progressive disclosure architecture details.
  • May 2026 — Official repository (`github.com/anthropics/skills`) hits 141,000+ stars, 16,000+ forks — one of most-watched AI tooling repos on GitHub.
  • Mid-2026 — Ecosystem explosion: 1.2M+ community-contributed skills indexed across marketplaces.

Note: Sources không chứa roadmap info về future Claude Skills features.

Kết

Claude Skills transform repetitive prompt-pasting thành reusable, maintainable instruction packages. Với kiến trúc progressive disclosure, bạn có thể install 50+ skills mà không performance penalty. Dù bạn là developer (code-reviewer, deploy skills) hay marketer (brand-guidelines, content-calendar), đều có skill template ready — hoặc build custom skill với Anthropic's Skill Creator.

Bắt đầu: Define 1 task bạn đã làm ≥5 lần. Tạo SKILL.md với trigger description rõ ràng + step-by-step instructions. Test trên thực. Ship.

Tìm hiểu thêm tại via Claude Blog hay explore 1.2M skills trong ecosystem.