convez.ai
SkillAutomaçãoIntermediário
minhnguyen2381

Claude Common Skills

minhnguyen2381/Claude-Common-Skills

Skills e commands compartilhados com deploy automatizado para Claude Code e agents

Ver no GitHub
InicialPluginScore · de 0 a 100

Repositó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-Skills

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 1 semana
Versão
—
Issues abertas
0
Contribuidores
1

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 đíchDù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 .cmd bê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ộcMặc địnhMô tả
-TargetPathCó—Đường dẫn project đích
-SourcePathKhông{repo}/.claudeThư mục nguồn cần copy
-IncludeSettingsKhôngTắtCopy thêm settings.local.json
-SkipGitIgnoreKhôngTắtKhông cập nhật .gitignore project đích
-WhatIfKhô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).
  • -WhatIf in 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 .gitignore khô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ỗiNguyên nhânCách xử lý
running scripts is disabledExecution Policy chặn .ps1Dù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 repoChạy từ ClaudeSkillCommon hoặc truyền đúng -SourcePath
missing skills/ subdirectoryThư mục nguồn không phải .claude hợp lệKiểm tra đường dẫn nguồn có skills/
Access deniedKhông có quyền ghi targetMở 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)
Ver o original no GitHub

Bom para

Relacionados