Claude Skills — Gerenciador Portável de Skills e Agents
arghhhhh/claude-skills
Skills portáveis para Claude com instalação CLI e sincronização entre máquinas
Ver no GitHubConjunto de skills, agents e rules para Claude que pode ser instalado e sincronizado entre máquinas via um único instalador CLI em bash. Oferece setup automático de dependências, versionamento de skills e sincronização bidirecional com repositório remoto.
Instalação
npx convez-ai arghhhhh/claude-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
- Sincronizar skills customizadas entre múltiplos computadores
- Automatizar setup de environment com dependências (cargo, pip, npx)
- Manter versionamento e histórico de skills instaladas
- Delegar setup complexo para Claude Code via agent-driven installation
Veredito

Solução robusta para quem trabalha com múltiplos ambientes e precisa sincronizar skills do Claude. O instalador bash é produção-ready com versionamento, rollback e testes integrados; recomendado para usuários avançados que automatizam workflows.
README
A tradução para o português deste README ainda está na fila.
claude-skills
Portable Claude Code skills, agents, and rules — shareable across machines via a single CLI installer.
New machine? Paste this into Claude Code:
Set up my Claude skills from https://github.com/arghhhhh/claude-skills — ask me which groups to install, then handle the rest including software installation and path configuration.
Quick Start
# Clone
git clone https://github.com/arghhhhh/claude-skills.git
cd claude-skills
# Interactive — pick which groups to install
bash install.sh
# Or install specific groups
bash install.sh --skills unity-cli,blender
# Skills only (skip software installation)
bash install.sh --skills comfyui --skip-software
# List available groups
bash install.sh --list
# Verify everything is correctly installed
bash install.sh --verify
# See version status of all skills
bash install.sh --status
# Update installed skills from repo
bash install.sh --update
# Bidirectional sync (also push local improvements back to repo)
bash install.sh --update --sync
# Test live connections (software must be running)
bash install.sh --test-integration --skills unity-cli
Agent-Driven Setup (Recommended)
Use the prompt at the top of this README to kick off setup. Here's what the agent will do:
What the agent will do:
- Clone the repo to
~/.claude/.skill-repos/claude-skills/ - Show you the available skill groups and ask which to install (or all)
- Ask whether to also install the software dependencies
- Run the installer
- Search the machine for any
{{PLACEHOLDER}}paths (binary locations, workspace dirs) and auto-resolve them into~/.claude/skills-config.sh - Re-run the installer to apply the config
- Run
--verifyand report results
After first-time setup, the skill-repo-maintenance skill is installed and teaches agents how to update/add/sync skills going forward. From that point on, the agent can reference that skill directly.
Other useful prompts:
- "Sync my skills" — pulls latest from repo and updates
- "Add a new skill for X" — creates skill files, bumps versions, pushes
- "Check my skill versions" — runs
--status
What It Does
For each selected skill group, the installer:
- Checks prerequisites (cargo, pip, npx, etc.)
- Installs the software (e.g.
cargo install unity-cli,pip install comfy-cli) - Symlinks skills into
~/.claude/skills/(with version tracking) - Symlinks agents into
~/.claude/agents/ - Configures placeholders from
~/.claude/skills-config.sh - Appends trigger phrases to
~/.claude/CLAUDE.md - Runs a smoke test to verify the software works
On first run from a temporary directory (e.g. /tmp), the repo is automatically copied to ~/.claude/.skill-repos/claude-skills/ so symlinks survive reboots.
Skill Versioning
Every skill file includes a version field in its YAML frontmatter:
---
version: 1.2.0
---
# My Skill
...
The installer tracks versions to enable:
--status: See which skills are up to date, have updates available, or are newer locally--update: Pull newer versions from the repo into your local install--update --sync: Also push locally-improved skills back into the repo
When updating, the installer automatically backs up your existing skills to ~/.claude/.skill-backups/.
Skill Groups
| Group | Software | Install Method | Skills | Agent |
|---|---|---|---|---|
app-ui | Unity App UI | Unity Package Manager | 5 skills | — |
ast-grep | ast-grep | brew / npm / cargo / pip | ast-grep | — |
blender | Blender + blender-mcp | manual / brew | blender-mcp | blender |
claude-mermaid | claude-mermaid MCP server | npm | claude-mermaid | — |
claude-notifications | Built-in Claude Code plugin | bootstrap script | — | — |
comfyui | comfy-cli + comfy-pilot | pip install | comfy-cli, comfy-pilot | comfyui |
find-docs | Context7 | npx ctx7@latest (no install) | find-docs | — |
find-skills | skills.sh | npx skills (no install) | find-skills | — |
ghidra | ghidra-cli | cargo install --git | ghidra-cli | ghidra |
github-cli | gh | brew / winget / binary | github-cli | — |
houdini | SideFX Houdini + houdini-mcp | bootstrap script / manual | houdini-mcp | houdini |
huggingface-downloader | hfdownloader | GitHub release binary | huggingface-downloader | — |
ilspy | ilspy-cli (ilspy-cli crate) | cargo install --git | ilspy-cli | ilspy |
imagemagick | ImageMagick | winget / brew / apt | imagemagick-cli | imagemagick |
notch | Notch Builder 2026.1 + Node.js | manual (Notch); node for lookup CLI | notch | notch |
obs-studio | gobs-cli | go install / brew / binary | obs-cli | obs-studio |
officecli | OfficeCLI | curl / PowerShell / binary | 9 skills (vendored from upstream) | — |
playwright-cli | Playwright | npm / npx | playwright-cli | — |
unity-cli | unity-cli (upstream akiojin) | cargo install (requires Rust) | 13 skills (vendored) | unity |
MCPorter-based skills (comfyui, blender, houdini, claude-mermaid) also need mcporter (npx mcporter — auto-installed via npx).
Vendored groups (officecli, unity-cli) ship skills sourced from upstream repos rather than authored here. See each group's manifest.json for the source_repo reference. Local customizations live in an overlays/ subfolder; everything else is pulled fresh on install.
Directory Structure
claude-skills/
├── install.sh # Cross-platform CLI installer
├── config.example.sh # Machine-specific config template
├── skill-groups/
│ ├── app-ui/ # Unity App UI (5 skills)
│ ├── ast-grep/ # Structural code search
│ ├── blender/ # Blender 3D + MCP addon (+ agent)
│ ├── claude-mermaid/ # Mermaid diagram rendering MCP
│ ├── claude-notifications/ # Claude Code desktop notifications plugin
│ ├── comfyui/ # ComfyUI + comfy-pilot (+ agent)
│ ├── find-docs/ # Context7 doc lookup
│ ├── find-skills/ # skills.sh discovery
│ ├── ghidra/ # Ghidra reverse engineering (+ agent)
│ ├── github-cli/ # GitHub CLI (gh)
│ ├── houdini/ # SideFX Houdini + MCP (+ agent)
│ ├── huggingface-downloader/ # Fast HuggingFace downloads
│ ├── ilspy/ # .NET decompilation (+ agent)
│ ├── imagemagick/ # Image manipulation (+ agent)
│ ├── notch/ # Notch Builder JS authoring (+ agent)
│ ├── obs-studio/ # OBS Studio + gobs-cli (+ agent)
│ ├── officecli/ # Office docs (9 skills, vendored)
│ ├── playwright-cli/ # Browser automation
│ └── unity-cli/ # Unity Editor (13 skills, vendored from akiojin/unity-cli, + agent overlay)
├── shared/
│ ├── skills/ # mcp-setup.md, skill-repo-maintenance/
│ └── claude-md/ # CLAUDE.md snippets per group
└── README.md
After installation, the following is created in ~/.claude/:
~/.claude/
├── skills/ # Symlinks (or copies with configured placeholders)
├── agents/ # Symlinks to agent definitions
├── .skill-repos/
│ └── claude-skills/ # Canonical repo copy (symlinks point here)
├── .skills-meta/
│ └── repo-path # Stored repo location
├── .skill-backups/ # Timestamped backups (created on update)
├── skills-config.sh # Machine-specific config (you create this)
└── CLAUDE.md # Trigger phrases appended here
Machine-Specific Configuration
Some skills have {{PLACEHOLDER}} variables for machine-specific paths. The installer will automatically substitute values from your config file:
- Copy
config.example.shto~/.claude/skills-config.sh - Fill in your machine's paths
- Re-run the installer — placeholders are replaced automatically
When a skill has placeholders and a config value is available, the symlink is replaced with a configured copy (the repo original stays as a template).
Updating Skills Across Machines
The typical workflow for keeping skills in sync:
# Machine A: improve a skill, bump its version
# (edit ~/.claude/skills/comfy-cli.md, change version: 1.0.0 → 1.1.0)
# Sync the improvement back to the repo
bash install.sh --update --sync
cd ~/.claude/.skill-repos/claude-skills
git add -A && git commit -m "Bump comfy-cli to 1.1.0" && git push
# Machine B: pull and update
cd ~/.claude/.skill-repos/claude-skills
git pull
bash install.sh --update
Cross-Platform Notes
- macOS/Linux: Symlinks work natively
- Windows: Requires Developer Mode enabled for symlinks, falls back to junction points or copies
- All skill files use
~/.claude/skills/paths internally
Verification & Testing
bash install.sh --verify # Check symlinks, files, CLAUDE.md, prerequisites
bash install.sh --status # Version table (local vs repo)
bash install.sh --test-integration # Test live connections (software must be running)
Prerequisites and integration test commands are defined per group in each manifest.json — run --verify to see what's missing.
Adding a New Skill Group
- Create
skill-groups/<name>/manifest.json(see existing ones for format) - Add skill
.mdfiles underskill-groups/<name>/skills/— includeversion: 1.0.0in YAML frontmatter - Add agent
.mdfiles underskill-groups/<name>/agents/ - Add a CLAUDE.md snippet to
shared/claude-md/<name>.md - The installer reads the manifest to know what to install and test