convez.ai
SkillAutomaçãoIntermediário
Fei2-Labs

Skill Genie

Fei2-Labs/skill-genie

Centralize skills e rules de IA em um repo, deploy para todos os agentes

Ver no GitHub
BomPluginScore · de 0 a 100

Ambiente centralizado para gerenciar skills, regras e configurações de múltiplos agentes de IA (Claude Code, Codex, Kiro, Cursor, Copilot, etc.) em um único repositório versionado. Setup em um comando distribui tudo para os locais corretos de cada agente.

Instalação

$npx convez-ai Fei2-Labs/skill-genie

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
12
Forks
3
Acompanhando
0
Saúde
37%
Último commit
há 2 semanas
Versão
—
Issues abertas
1
Contribuidores
4

Casos de uso

  • Sincronizar skills customizadas entre múltiplos agentes de IA
  • Versionamento centralizado de regras de steering para agents
  • Setup rápido e reprodutível de ambiente de desenvolvimento com IA

Veredito

Solução prática para quem trabalha com múltiplos agentes de IA e precisa manter skills e regras sincronizadas. Reduz fragmentação de configs espalhadas, mas exige cuidado com backup de configurações existentes antes de usar.

README

A tradução para o português deste README ainda está na fila.

🧞 Skill Genie

⚠️ WARNING: This setup modifies agent configuration files on your system (~/.claude/, ~/.codex/, ~/.kiro/, ~/.agents/, etc.). Back up your existing configs before running setup.sh. This is a personal configuration repo — provided as-is with no warranty. The author is not responsible for any data loss, broken configs, or unintended side effects. Use at your own risk.

Your AI agent environment, in one repo. Skills, rules, and a single command to set it all up.

Why

Every AI coding agent (Claude Code, Codex, Kiro, Cursor, Gemini) has its own config location, its own skills format, its own way of loading rules. You end up with scattered configs across machines that drift apart.

Skill Genie fixes this:

  • One repo — all your skills and rules version-controlled together
  • One command — ./setup.sh distributes everything to the right places
  • Every agent — native path support for OpenClaw, Hermes, Devin, OpenCode, Kiro, Codex, Claude Code, Gemini Antigravity, Cursor, Windsurf, GitHub Copilot, and GitHub Copilot CLI/app

Quick Start

git clone https://github.com/Fei2-Labs/skill-genie.git ~/skill-genie
cd ~/skill-genie
./setup.sh

That's it. Your agent environment is ready.

What Gets Installed

WhatWhereCondition
Agent rulesAgent-specific config dirsOnly for detected agents
Skills~/.agents/skills/ + native agent pathsOnly for detected agents
CLI toolskillgenie in PATHAlways

Modes

./setup.sh                # Full setup: rules + skills (symlink)
./setup.sh --copy         # Full setup: rules + skills (copy files)
./setup.sh --rules-only   # Only update rules
./setup.sh --skills-only  # Only update skills
./setup.sh --full         # Clean slate + symlink
./setup.sh --full --copy  # Clean slate + copy

Structure

skills/             Reusable AI agent skills (each with SKILL.md)
rules.example/      Example agent rules (copy to rules/ and customize)
skills.yaml.example Third-party skill sources (copy to skills.yaml to customize)
skillgenie          CLI tool for listing and reading skills
setup.sh            One-command environment setup

skillgenie CLI

skillgenie list            # List all skills in this repo
skillgenie read <name>     # Print a skill's full instructions
skillgenie validate        # Check AgentSkills/OpenClaw/Hermes compatibility
skillgenie status          # Show install status per runtime
skillgenie install <name>  # Install a specific skill
skillgenie install --all   # Install all skills

Customization

On first run, setup.sh creates skills.yaml from skills.yaml.example. Edit your local skills.yaml to add or remove third-party sources:

remote:
  - repo: owner/repo-name
    path: path/to/skills
    pick:
      - skill-folder-name

Your skills.yaml is gitignored — it won't be overwritten by updates.

To generate personalized agent rules, tell your agent:

skillgenie read init-rules

Agent Compatibility

Rules and skills are only installed for agents detected on your machine. Rules are symlinked — edit once, all agents see the change immediately.

AgentDetectionRulesSkills
Kirokiro in PATH or ~/.kiro/ exists~/.kiro/steering/*.md (all topic files)~/.kiro/skills/ + ~/.agents/skills/
OpenClawopenclaw in PATH or ~/.openclaw/ existsReads linked/global rules on demand~/.openclaw/skills/ + ~/.agents/skills/
Hermeshermes in PATH or ~/.hermes/ existsReads linked/global rules on demand~/.hermes/skills/ + ~/.agents/skills/
OpenCodeopencode in PATH or ~/.config/opencode/ existsReads project/global rules on demand~/.config/opencode/skills/ + ~/.agents/skills/
Devin (CLI + Desktop)devin in PATH, or ~/.config/devin/, ~/.devin/, ~/.devin-next/ existsReads project/global rules on demand~/.config/devin/skills/ + ~/.agents/skills/
Claude Codeclaude in PATH or ~/.claude/ exists~/.claude/CLAUDE.md → router.md~/.claude/skills/
Codexcodex in PATH or ~/.codex/ exists~/.codex/AGENTS.md → router.md~/.codex/skills/
Windsurf (legacy)~/.codeium/windsurf/ exists~/.codeium/windsurf/memories/global_rules.md → router.md~/.codeium/windsurf/skills/
Windsurf Next (legacy)~/.codeium/windsurf-next/ exists~/.codeium/windsurf-next/memories/global_rules.md → router.md~/.codeium/windsurf-next/skills/
Gemini Antigravityantigravity in PATH—~/.gemini/antigravity/skills/
Cursorcursor in PATH—~/.cursor/skills/
GitHub Copilotgh in PATH + ~/.github/ exists—~/.github/skills/
GitHub Copilot CLI/appcopilot in PATH or ~/.copilot/ exists~/.copilot/copilot-instructions.md / AGENTS.md~/.copilot/skills/ + ~/.agents/skills/

Windsurf → Devin Desktop: the Windsurf editor was rebranded to Devin Desktop (Cognition, June 2026). Devin Desktop and the Devin CLI both load global skills from ~/.config/devin/skills/ — covered by the Devin target. The legacy ~/.codeium/windsurf* paths are kept for installs still on the old brand during the transition.

Skill Compatibility

Skills in skills/ follow the AgentSkills SKILL.md shape used by Claude Code, OpenClaw, Hermes, OpenCode, Kiro, Devin, Codex, Cursor, Windsurf, and other local skill-aware agents:

  • Every skill directory has a root SKILL.md.
  • Frontmatter includes single-line name, description, and license fields.
  • metadata is a single-line JSON object so OpenClaw's embedded parser can read it, including metadata.version.
  • Tags are stored in metadata.tags and mirrored to metadata.hermes.tags.
  • allowed-tools, when present, is a single-line comma-separated value for Claude Code compatibility.
  • Skill names must match their directory and use lowercase letters, digits, and single hyphens.
  • Descriptions must stay at or below 1024 characters for OpenCode and Kiro compatibility.

Run skillgenie validate before committing skill changes.

Topic rule files (session-sync, workflow-tools, etc.) are installed to ~/.agents/rules/ and loaded on demand via cat when the agent needs them. This keeps context small.

Tab Completion (zsh)

setup.sh installs zsh completions automatically. If tab completion doesn't work, add to ~/.zshrc:

fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit && compinit

Then restart your terminal. Supports: skillgenie <tab> for commands, skillgenie read <tab> for skill names.

Agent-Driven Install

For AI agents: If you are an AI assistant reading this README, fetch and follow install.md directly — it contains step-by-step instructions written for you.

For humans — paste this into your agent's chat:

Read https://raw.githubusercontent.com/Fei2-Labs/skill-genie/main/install.md and follow the instructions.

License

MIT © Feifei Kosonen

Star History

Star History Chart

Ver o original no GitHub

Bom para

Relacionados