Claude Common Skills
minhnguyen2381/Claude-Common-Skills
Skills e commands compartilhados com deploy automatizado para Claude Code e agents
Ver no GitHubRepositório centralizado de skills e commands reutilizáveis para Claude Code e runtimes de agents. Oferece um sistema de deploy automatizado (via scripts PowerShell/CMD) para sincronizar comandos e skills entre projetos, com controle fino de permissões e configurações locais.
Instalação
npx convez-ai minhnguyen2381/Claude-Common-Skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Centralizar skills e commands reutilizáveis entre múltiplos projetos
- Sincronizar configurações de agentes Claude em equipes
- Automatizar deploy de workflows customizados em projetos Android/mobile
Veredito

Ferramenta sólida para times que precisam manter skills e commands sincronizados entre projetos. O deploy via PowerShell/CMD é bem pensado (merge-only, preview), mas a documentação em vietnamita limita a acessibilidade. Recomendado para workflows que exigem reutilização consistente de skills customizadas.
README
A tradução para o português deste README ainda está na fila.
ClaudeSkillCommon
Kho skills và commands dùng chung cho Claude Code (.claude) và Codex/agents runtime (.agents).
Cấu trúc repo
ClaudeSkillCommon/
├── .claude/
│ ├── commands/ # Slash commands (vd. review-android.md)
│ ├── skills/ # Skill bundles (android-code-review, git-workflow, ...)
│ └── settings.local.json # Permissions cụ thể máy — không deploy mặc định
└── scripts/
├── deploy-claude-agents.cmd # Launcher (khuyên dùng trên Windows)
└── deploy-claude-agents.ps1
Khi deploy sang project khác, script tạo hai thư mục giống nhau:
| Thư mục đích | Dùng cho |
|---|---|
{project}/.claude/ | Claude Code |
{project}/.agents/ | Codex / agents runtime |
Yêu cầu
- Windows PowerShell 5.1 trở lên (hoặc PowerShell 7+)
- Quyền ghi vào thư mục project đích
Cách dùng
Chạy từ thư mục gốc repo ClaudeSkillCommon.
Windows mặc định chặn chạy
.ps1(running scripts is disabled). Dùng file.cmdbên dưới — không cần đổi Execution Policy.
Deploy thông thường (khuyên dùng)
Copy skills/commands sang project đích (cả .claude và .agents):
.\scripts\deploy-claude-agents.cmd -TargetPath "D:\AndroidStudioProjects\MyApp"
Hoặc PowerShell (nếu Execution Policy cho phép):
.\scripts\deploy-claude-agents.ps1 -TargetPath "D:\AndroidStudioProjects\MyApp"
Xem trước (không ghi file)
.\scripts\deploy-claude-agents.cmd -TargetPath "D:\AndroidStudioProjects\MyApp" -WhatIf
Kèm settings.local.json
Mặc định script bỏ qua settings.local.json vì file này chứa permissions gắn với máy cụ thể. Chỉ bật khi bạn chủ đích muốn copy:
.\scripts\deploy-claude-agents.cmd -TargetPath "D:\AndroidStudioProjects\MyApp" -IncludeSettings
Chỉ định nguồn khác
Mặc định nguồn là .claude trong repo này. Có thể override:
.\scripts\deploy-claude-agents.cmd -TargetPath "D:\AndroidStudioProjects\MyApp" -SourcePath "F:\ClaudeSkillCommon\.claude"
Tham số
| Tham số | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|
-TargetPath | Có | — | Đường dẫn project đích |
-SourcePath | Không | {repo}/.claude | Thư mục nguồn cần copy |
-IncludeSettings | Không | Tắt | Copy thêm settings.local.json |
-SkipGitIgnore | Không | Tắt | Không cập nhật .gitignore project đích |
-WhatIf | Không | — | Chỉ in preview, không ghi file |
Hành vi sync
Script dùng chế độ merge-only:
- Ghi đè file trùng tên giữa source và target
- Không xóa file thừa đã có trong target (vd. file custom chỉ tồn tại ở project đích)
Mỗi lần chạy, output mẫu:
Deploy agent skills
Source : F:\ClaudeSkillCommon\.claude
Target : D:\AndroidStudioProjects\MyApp
Include settings.local.json: False
-> D:\AndroidStudioProjects\MyApp\.claude
Copied : 186
Skipped: 1
-> D:\AndroidStudioProjects\MyApp\.agents
Copied : 186
Skipped: 1
Done. 2 destinations updated (372 files copied, 2 skipped).
Updated .gitignore (added: .agents/, .claude/).
(Skipped: 1 là settings.local.json khi không dùng -IncludeSettings.)
Bỏ qua cập nhật .gitignore
Nếu project đích cần commit .claude/ hoặc .agents/:
.\scripts\deploy-claude-agents.cmd -TargetPath "D:\AndroidStudioProjects\MyApp" -SkipGitIgnore
.gitignore project đích
Sau deploy, script tự kiểm tra và bổ sung các dòng còn thiếu vào .gitignore project đích (hoặc tạo file mới nếu chưa có):
# ClaudeSkillCommon deploy (auto-added)
.agents/
.claude/
- Chạy lại deploy không duplicate dòng đã có (idempotent).
-WhatIfin preview các dòng sẽ thêm, không ghi file.- Nếu
.claude/hoặc.agents/đã được git track trước đó, thêm vào.gitignorekhông tự untrack — chạy thủ công:
git rm -r --cached .claude .agents
Ví dụ workflow
# 1. Cập nhật skills trong ClaudeSkillCommon (commit/push nếu cần)
cd F:\ClaudeSkillCommon
# 2. Xem trước thay đổi sẽ deploy
.\scripts\deploy-claude-agents.cmd -TargetPath "D:\AndroidStudioProjects\Satellite" -WhatIf
# 3. Deploy thật
.\scripts\deploy-claude-agents.cmd -TargetPath "D:\AndroidStudioProjects\Satellite"
Execution Policy bị chặn
Lỗi:
running scripts is disabled on this system
Cách 1 — Dùng launcher .cmd (khuyên dùng, không đổi policy):
.\scripts\deploy-claude-agents.cmd -TargetPath "D:\AndroidStudioProjects\MyApp"
Cách 2 — Bypass một lần trong PowerShell:
powershell -ExecutionPolicy Bypass -File .\scripts\deploy-claude-agents.ps1 -TargetPath "D:\AndroidStudioProjects\MyApp"
Cách 3 — Cho phép script local vĩnh viễn (chỉ user hiện tại):
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
Sau đó chạy lại .\scripts\deploy-claude-agents.ps1 như bình thường.
Xử lý lỗi thường gặp
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
running scripts is disabled | Execution Policy chặn .ps1 | Dùng deploy-claude-agents.cmd hoặc xem mục trên |
Source path not found | -SourcePath sai hoặc chạy script ngoài repo | Chạy từ ClaudeSkillCommon hoặc truyền đúng -SourcePath |
missing skills/ subdirectory | Thư mục nguồn không phải .claude hợp lệ | Kiểm tra đường dẫn nguồn có skills/ |
Access denied | Không có quyền ghi target | Mở PowerShell với quyền phù hợp hoặc chọn path khác |
Phạm vi
Script không:
- Tạo
.cursor/(Cursor dùng convention riêng) - Convert commands sang skills
- Commit/push git
- Untrack file đã commit trong project đích (chỉ append
.gitignore)