Skill Genie
Fei2-Labs/skill-genie
Centralize skills e rules de IA em um repo, deploy para todos os agentes
Ver no GitHubAmbiente 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-genie1 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 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 runningsetup.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.shdistributes 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
| What | Where | Condition |
|---|---|---|
| Agent rules | Agent-specific config dirs | Only for detected agents |
| Skills | ~/.agents/skills/ + native agent paths | Only for detected agents |
| CLI tool | skillgenie in PATH | Always |
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.
| Agent | Detection | Rules | Skills |
|---|---|---|---|
| Kiro | kiro in PATH or ~/.kiro/ exists | ~/.kiro/steering/*.md (all topic files) | ~/.kiro/skills/ + ~/.agents/skills/ |
| OpenClaw | openclaw in PATH or ~/.openclaw/ exists | Reads linked/global rules on demand | ~/.openclaw/skills/ + ~/.agents/skills/ |
| Hermes | hermes in PATH or ~/.hermes/ exists | Reads linked/global rules on demand | ~/.hermes/skills/ + ~/.agents/skills/ |
| OpenCode | opencode in PATH or ~/.config/opencode/ exists | Reads project/global rules on demand | ~/.config/opencode/skills/ + ~/.agents/skills/ |
| Devin (CLI + Desktop) | devin in PATH, or ~/.config/devin/, ~/.devin/, ~/.devin-next/ exists | Reads project/global rules on demand | ~/.config/devin/skills/ + ~/.agents/skills/ |
| Claude Code | claude in PATH or ~/.claude/ exists | ~/.claude/CLAUDE.md → router.md | ~/.claude/skills/ |
| Codex | codex 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 Antigravity | antigravity in PATH | — | ~/.gemini/antigravity/skills/ |
| Cursor | cursor in PATH | — | ~/.cursor/skills/ |
| GitHub Copilot | gh in PATH + ~/.github/ exists | — | ~/.github/skills/ |
| GitHub Copilot CLI/app | copilot 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, andlicensefields. metadatais a single-line JSON object so OpenClaw's embedded parser can read it, includingmetadata.version.- Tags are stored in
metadata.tagsand mirrored tometadata.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.mddirectly — 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