Bài 15.5: Chia sẻ skill với team & tổ chức

​

Mục tiêu học tập

• ✅ Chia sẻ skill với team bằng cách commit .claude/skills/ vào Git repository
• ✅ Phân phối skill qua plugin marketplace cho cộng đồng rộng hơn
• ✅ Deploy skill cho toàn tổ chức qua enterprise managed settings với priority cao nhất
• ✅ Configure custom subagent dùng skill — hiểu gotcha “subagent không inherit skill tự động”
• ✅ Chọn phương pháp share phù hợp cho từng scenario (team / cross-repo / enterprise)

​

Mở đầu: Từ “skill của tôi” sang “skill của team”

• Mọi PR review output cùng format (reviewer mới không phải “học style”)
• Feedback tone nhất quán (không có review harsh chỗ này, soft chỗ khác)
• Compliance check (security, a11y) không bị miss
• New hire onboard nhanh: clone repo về, skill đã nằm trong .claude/skills/, Claude của họ review đúng style từ ngày đầu

“Skills become much more valuable when they’re shared. A PR review skill that only you use is helpful, but that same skill shared across your entire team standardizes code review and creates a consistent experience across your organization.”

​

3 phương pháp share — Tổng quan

​

Phương pháp 1: Commit skill vào repository

​

Cấu trúc thư mục

my-app/                                 ← root của repo
├── .claude/
│   ├── skills/                         ← skill của team
│   │   ├── pr-review/
│   │   │   └── SKILL.md
│   │   ├── commit-format/
│   │   │   └── SKILL.md
│   │   └── brand-guidelines/
│   │       ├── SKILL.md
│   │       └── references/
│   │           └── full-brand-book.md
│   ├── agents/                         ← custom subagent (optional)
│   ├── hooks/                          ← hook settings (optional)
│   └── settings.json                   ← Claude Code config (optional)
├── src/
├── package.json
└── README.md

​

Workflow chia sẻ

cd /path/to/my-app
mkdir -p .claude/skills/pr-review
# tạo SKILL.md với frontmatter + instructions

git add .claude/skills/pr-review
git commit -m "chore: add pr-review skill for team standardization"
git push

git pull

​

Ưu điểm

• Zero friction: dev đã biết Git, không cần học tool mới
• Version control: git log .claude/skills/ cho lịch sử thay đổi skill
• PR review cho skill: skill mới được team review như code khác
• Rollback được: git revert nếu skill mới phá vỡ workflow
• Branch per skill: thử nghiệm skill mới trên feature branch

​

Nhược điểm

• Phụ thuộc repo: chỉ dùng được khi clone repo này → không dùng cho skill cross-project
• Scope limit: team nhỏ OK. Tổ chức 500 người dùng nhiều repo → không scale

​

Prompt tip cho việc setup lần đầu

initialize this project with a simple .claude/skills structure

​

⚠️ Gotcha: Enable skill trong settings

​

Case study: Team engineering 12 người

• 12 dev, 12 style review PR hơi khác nhau
• New hire mất 2 tuần hiểu “style review của team này”
• Tech lead paste lại review instruction ~40 lần/tuần trong các session Claude

• 12 dev cùng format review output
• New hire: ngày 1 clone repo, Claude review theo đúng style team
• Tech lead gõ “review PR #142” → skill trigger, 0 dòng instruction prefix

​

Phương pháp 2: Plugin marketplace

​

Khi nào cần

• seo-blog-writer — áp dụng cho mọi project content marketing
• jest-test-generator — hữu ích cho bất kỳ JS project nào
• owasp-security-audit — check chung cho web app
• conventional-commits — standard cross-industry

​

Plugin structure

my-plugin/
├── plugin.json                  ← metadata plugin
├── skills/                      ← cùng convention như .claude/skills/
│   ├── seo-blog-writer/
│   │   └── SKILL.md
│   └── conventional-commits/
│       └── SKILL.md
└── README.md

​

Distribution

• Push plugin lên GitHub repo hoặc npm package
• Publish lên marketplace (khi Claude Code hỗ trợ)
• User install: claude plugin install <plugin-name>
• Skills trong plugin available ở tầng priority 4 (plugin — thấp nhất)

​

Skill Anthropic ship sẵn (ví dụ marketplace)

• skill-creator — wizard tạo skill mới (tự tạo skill!)
• canvas-design — design canvas layout
• theme-factory — tạo color theme
• slack-gif-creator — generate GIF cho Slack
• powerpoint-generator — tạo PowerPoint deck

​

Ưu điểm

• Cross-team, cross-org reuse
• Community contribute được (open source plugin)
• Phân phối rộng (hàng ngàn người dùng)

​

Nhược điểm

• Priority thấp nhất (tầng 4) → enterprise/personal/project đè được
• Quality phụ thuộc plugin author
• Phải tin plugin author (không execute code lạ từ plugin)

​

Security concern

​

Phương pháp 3: Enterprise managed settings

​

Khi nào cần

• Security audit phải chạy trên mọi code review
• Compliance check phải có cho healthcare/finance
• Code style phải nhất quán toàn công ty

​

Cấu trúc managed settings

{
  "skills": {
    "skillDirectories": [
      "/opt/acme-corp/skills"
    ],
    "strictKnownMarketplaces": [
      {
        "source": "github",
        "repo": "acme-corp/approved-plugins"
      },
      {
        "source": "npm",
        "package": "@acme-corp/compliance-plugins"
      }
    ]
  }
}

• skillDirectories — folder trên máy dev chứa enterprise skill (deploy qua MDM hoặc image)
• strictKnownMarketplaces — whitelist marketplace. Dev chỉ được cài plugin từ nguồn này

​

Case study: Ngân hàng với compliance requirements

• Không log PII (personally identifiable information) ra console
• Không hard-code secret
• Audit log tất cả query access DB production

# /opt/bank/skills/mandatory-compliance-review/SKILL.md
---
name: code-review
description: Code review with mandatory compliance checks. Use when reviewing PR or code change.
allowed-tools: Read, Grep, Glob
---

Every code review MUST include:

1. PII scan: grep for names/emails/SSN patterns in logs
2. Secret scan: check for API keys, passwords hardcoded
3. Audit log requirement: all DB production access must have audit call
4. Sign-off: review is not complete without all 3 checks passed

• Dev gõ “review this PR” → trigger skill code-review
• Enterprise version override nếu dev có personal code-review
• 3 check compliance luôn chạy, không miss

​

Ưu điểm

• Priority cao nhất — không ai bypass được
• Centralized management — admin deploy 1 lần, toàn org có
• Security + compliance enforced automatically

​

Nhược điểm

• Cần admin access platform/deployment tool (MDM, corp laptop image)
• Setup phức tạp (MDM profile, managed settings JSON)
• Friction với dev cá nhân (họ mất customization rights cho cùng skill name)

​

Workaround cho dev: đặt tên khác

Enterprise: code-review      (mandatory, formal)
Personal:   my-code-review   (informal, cá nhân)

​

Skill với subagent — Gotcha quan trọng

​

Gotcha chính: Subagent KHÔNG inherit skill tự động

.claude/
├── skills/
│   ├── a11y-standard/
│   └── pr-review/
└── agents/
    └── frontend-reviewer.md

“Subagents don’t automatically see your skills. When you delegate a task to a subagent, it starts with a fresh, clean context.”

​

Thêm nữa: Built-in agent không access skill được

• Built-in (Explorer, Plan, Verify) — không access skill được, ever
• Custom (bạn tạo) — access được skill, nhưng phải explicit list

​

Cách đúng: Khai báo skills field trong agent.md

# .claude/agents/frontend-reviewer.md
---
name: frontend-reviewer
description: Reviews frontend code for accessibility, performance, design system compliance.
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill
model: sonnet
color: blue
skills: a11y-standard, pr-review, design-system-check
---

You are a frontend code reviewer. For each code change, check:

1. Accessibility (use a11y-standard skill)
2. Code quality (use pr-review skill)
3. Design system compliance (use design-system-check skill)

Output: structured review with severity labels (critical/major/minor).

​

Khi subagent load skill?

• Khi subagent start (không on-demand như main conversation)
• Tất cả skill trong skills: load hết vào subagent context
• Dữ liệu tổng của các skill ăn context của subagent

​

Pattern: Specialized subagent + shared skill

“Your front-end developer subagent can use a component pattern skill. Your UI reviewer subagent can use a design system skill, but both can load and use the same accessibility standard skill.”

agents/
├── frontend-developer.md    skills: [component-patterns, a11y-standard]
├── ui-reviewer.md           skills: [design-system, a11y-standard]
└── backend-reviewer.md      skills: [api-conventions, sql-perf-check]

skills/
├── component-patterns/      ← dùng bởi frontend-developer
├── design-system/           ← dùng bởi ui-reviewer
├── a11y-standard/           ← SHARED giữa frontend-developer & ui-reviewer
├── api-conventions/         ← dùng bởi backend-reviewer
└── sql-perf-check/          ← dùng bởi backend-reviewer

• Bạn muốn isolated task delegation với specific expertise
• Subagent khác nhau cần skill khác nhau (frontend vs backend)
• Enforce standards trong delegated work không dựa vào prompt

​

Workflow tạo subagent với skill

​

Cách 1: Dùng command /agents trong Claude Code

/agents

• Tên subagent
• Description
• Tools allowed
• Skills to load ← chọn từ danh sách skill đã có

​

Cách 2: Tạo file manual

cat > .claude/agents/security-auditor.md << 'EOF'
---
name: security-auditor
description: Audits code for security vulnerabilities per OWASP top 10.
tools: Read, Grep, Glob, Bash
model: opus
color: red
skills: owasp-check, secret-scan, dependency-audit
---

[instructions...]
EOF

​

Đảm bảo skill exist trước

ls .claude/skills/owasp-check
# nếu không thấy → tạo skill này trước khi wire vào subagent

​

So sánh 3 phương pháp share — Decision matrix

​

Checklist chọn phương pháp

​

Case studies theo role

​

Sales team sharing CRM prep skill

• Pull CRM account data (qua MCP salesforce-mcp)
• Pull email history (qua MCP gmail-mcp)
• Output: 1-page briefing với talking points

​

Marketing team sharing brand voice skill

• references/brand-voice.md — trích từ brand book 40 trang
• references/seo-checklist.md — 27 điểm
• references/past-winners.md — 10 blog post top performance
• SKILL.md orchestrate workflow

​

Finance team — Enterprise compliance skill

• Mandatory check cho SOX compliance mọi financial report
• Audit log mọi access vào financial data
• Escalation path nếu detect violation

​

Legal — Plugin cho OSS community

• Review NDA, MSA, SOW theo templates public
• Red flag common patterns
• Không include proprietary data (open source)

​

Healthcare — Multi-tier setup

• Enterprise: mandatory-phi-check (PHI = Protected Health Info)
• Project: clinical-research-workflow (trong repo study-specific)
• Personal: my-research-style (của mỗi researcher)

• User gõ “review this study data” → semantic match phi-check first (enterprise override)
• Rồi Claude còn match clinical-research-workflow (project)
• Nếu personal my-research-style cùng tên → bị enterprise đè

​

Anti-patterns — Sai lầm khi share skill

​

❌ Push skill chứa secret vào repo

---
name: deploy-to-prod
description: ...
---

API_KEY=sk_live_abc123...  ← HARDCODED!

​

❌ Enterprise deploy skill không test cẩn thận

• Trial ở team nhỏ (10-20 dev) trước
• Staging environment trước production deploy
• Rollback plan sẵn (version trước trong managed settings)

​

❌ Plugin chứa code malicious

• Admin whitelist marketplace qua strictKnownMarketplaces
• Audit plugin source code trước install
• Enterprise: block plugin install ngoài whitelist

​

❌ Skill trong repo nhưng không document

## Claude Code Skills

This project ships with the following team skills:

- `pr-review` — team code review standard. Trigger: "review this PR"
- `commit-format` — conventional commits. Trigger: "write commit message"
- `incident-response` — postmortem template. Trigger: "postmortem for incident"

​

❌ Subagent skill list không match thực tế

skills: a11y-standard, nonexistent-skill, old-deleted-skill

​

Áp dụng ngay

​

Bài tập 1: Share skill đầu tiên cho team (~15 phút)

cd /path/to/project
mkdir -p .claude/skills
mv ~/.claude/skills/<tên-skill> .claude/skills/

git add .claude/skills/<tên-skill> README.md
git commit -m "chore: add <tên-skill> skill for team"
git push

​

Bài tập 2: Tạo subagent dùng skill (~10 phút)

• Name: <role>-reviewer (ví dụ frontend-reviewer)
• Description: role của subagent
• Skills: list 2-3 skill ở Bước 1

​

Tóm tắt bài học

​

Bài tiếp theo

​

Tài liệu tham khảo

• Anthropic Academy — “Sharing skills”
• Video — “Distributing skills”
• Claude Code — /agents command docs
• Enterprise managed settings — official Claude Code docs