convez.ai
SkillAutomaçãoAvançado
arghhhhh

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 GitHub
InicialPluginScore · de 0 a 100

Conjunto 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-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
28%
Último commit
há 2 dias
Versão
—
Issues abertas
16
Contribuidores
1

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:

  1. Clone the repo to ~/.claude/.skill-repos/claude-skills/
  2. Show you the available skill groups and ask which to install (or all)
  3. Ask whether to also install the software dependencies
  4. Run the installer
  5. Search the machine for any {{PLACEHOLDER}} paths (binary locations, workspace dirs) and auto-resolve them into ~/.claude/skills-config.sh
  6. Re-run the installer to apply the config
  7. Run --verify and 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:

  1. Checks prerequisites (cargo, pip, npx, etc.)
  2. Installs the software (e.g. cargo install unity-cli, pip install comfy-cli)
  3. Symlinks skills into ~/.claude/skills/ (with version tracking)
  4. Symlinks agents into ~/.claude/agents/
  5. Configures placeholders from ~/.claude/skills-config.sh
  6. Appends trigger phrases to ~/.claude/CLAUDE.md
  7. 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

GroupSoftwareInstall MethodSkillsAgent
app-uiUnity App UIUnity Package Manager5 skills—
ast-grepast-grepbrew / npm / cargo / pipast-grep—
blenderBlender + blender-mcpmanual / brewblender-mcpblender
claude-mermaidclaude-mermaid MCP servernpmclaude-mermaid—
claude-notificationsBuilt-in Claude Code pluginbootstrap script——
comfyuicomfy-cli + comfy-pilotpip installcomfy-cli, comfy-pilotcomfyui
find-docsContext7npx ctx7@latest (no install)find-docs—
find-skillsskills.shnpx skills (no install)find-skills—
ghidraghidra-clicargo install --gitghidra-clighidra
github-clighbrew / winget / binarygithub-cli—
houdiniSideFX Houdini + houdini-mcpbootstrap script / manualhoudini-mcphoudini
huggingface-downloaderhfdownloaderGitHub release binaryhuggingface-downloader—
ilspyilspy-cli (ilspy-cli crate)cargo install --gitilspy-cliilspy
imagemagickImageMagickwinget / brew / aptimagemagick-cliimagemagick
notchNotch Builder 2026.1 + Node.jsmanual (Notch); node for lookup CLInotchnotch
obs-studiogobs-cligo install / brew / binaryobs-cliobs-studio
officecliOfficeCLIcurl / PowerShell / binary9 skills (vendored from upstream)—
playwright-cliPlaywrightnpm / npxplaywright-cli—
unity-cliunity-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:

  1. Copy config.example.sh to ~/.claude/skills-config.sh
  2. Fill in your machine's paths
  3. 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

  1. Create skill-groups/<name>/manifest.json (see existing ones for format)
  2. Add skill .md files under skill-groups/<name>/skills/ — include version: 1.0.0 in YAML frontmatter
  3. Add agent .md files under skill-groups/<name>/agents/
  4. Add a CLAUDE.md snippet to shared/claude-md/<name>.md
  5. The installer reads the manifest to know what to install and test
Ver o original no GitHub

Bom para

Relacionados