AI Skills para Codex, Claude Code e OpenCode
Victorcorcos/skills
Skills portáveis para automação de workflows de desenvolvimento
Ver no GitHubColeção de skills reutilizáveis para automação de fluxos de desenvolvimento de software. Suporta Codex CLI, Claude Code e OpenCode com comandos como /planner, /improver, /tester, /creator e outros para planejamento, revisão, testes e geração de PRs. Instale uma vez, use em múltiplas plataformas.
Instalação
npx convez-ai Victorcorcos/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
- Planejar e executar tarefas com gates de aprovação
- Revisar código e refatorar testes automaticamente
- Gerar descrições de PRs e investigar bugs
- Aumentar cobertura de testes com testes estruturados em BDD
- Quebrar PRs grandes em unidades menores e independentes
Veredito

Conjunto bem estruturado de skills prontas para produção que automatiza tarefas comuns de desenvolvimento. Requer setup inicial (ENV SKILLS_PATH) e conhecimento de Python, mas oferece retorno alto para equipes que usam Codex, Claude Code ou OpenCode regularmente.
README
A tradução para o português deste README ainda está na fila.
AI Skills
A collection of reusable prompts and skills for software development workflows.
This repository supports:
- Codex CLI — skills installed into
~/.codex/skills/<skill-name>/(full skill folder, includingscripts/,agents/, etc.) - Claude Code — skills installed into
<project>/.claude/skills/<skill-name>/(full skill folder) and invoked as/creator,/planner, etc. - OpenCode — skills installed into
~/.config/opencode/skills/<skill-name>/and auto-discovered by theskilltool
[!TIP] Quick start:
- Codex CLI:
python3 "$SKILLS_PATH/scripts/sync.py" --install --codex- Claude Code:
cd <your-project>thenpython3 "$SKILLS_PATH/scripts/sync.py" --install --claude- OpenCode:
python3 "$SKILLS_PATH/scripts/sync.py" --install --opencode
[!NOTE] Every skill is a template. Fork this repo, tweak the prompts to match your team's conventions, and commit your own version.
[!IMPORTANT] Pre-requisite: Add the
SKILLS_PATHENV to your bash profile:export SKILLS_PATH="/abs/path/to/this/repository/skills"
🧠 Skills
| Emoji | Skill | Command | Purpose | Status |
|---|---|---|---|---|
| 🗺️ | Planner | /planner | Plan tasks in sections, execute with approval gates | 🟢 |
| ✨ | Improver | /improver | Review code and tests, then fix all found issues directly | 🟢 |
| 🧪 | Tester | /tester | Refactor tests using BDD principles and improve them to be readable, meaningful, and real-world focused, avoiding unnecessary mocks | 🟢 |
| 🚬 | Smoker | /smoker | Generate SMOKE_TEST.md manual testing steps from the current branch diff | 🟢 |
| 🌍 | Creator | /creator | Generate PR descriptions & titles from diffs and open the PR on GitHub | 🟢 |
| 📋 | Filler | /filler | Generate PR descriptions & titles from diffs and output pull_request.md for copy-paste (no PR creation) | 🟢 |
| ✂️ | Breaker | /breaker | Split large PRs into smaller, independent SRP-based units created from the base ref using wisetree worktrees | 🟢 |
| 📈 | Coverager | /coverager | Increase code coverage to 100% with meaningful BDD-structured tests from a SimpleCov report | 🟢 |
| 🩹 | Fixer | /fixer | Resolve PR review comments interactively | 🟢 |
| 🐛 | Bugkiller | /bugkiller | Investigate a bug, write ranked causes, evidence quality, and solutions to BUG_INVESTIGATION.md, then fix selected solutions with regression tests | 🟢 |
| 🔍 | Reviewer | /reviewer | Review code and tests, post inline PR comments for approved findings, then optionally submit a PR review summary | 🟢 |
| 🔀 | Merger | /merger | Fetch and merge a remote branch into the current branch, resolving conflicts without breaking code | 🟢 |
Workflow
flowchart LR
A[🗺️ planner] --> B[Coding]
B --> M[🔀 merger]
M --> B
B --> C[✨ improver]
B --> D[🧪 tester]
C --> E[🌍 creator]
D --> E[🌍 creator]
E -->|if small| F[Code Review]
E -->|if large| G[✂️ breaker]
G --> F
I[🔍 reviewer] -->|add comments + summary| F
F --> J[📈 coverager]
J --> F
F --> L[🚬 smoker]
L --> F
F --> H[🩹 fixer]
H --> F
B --> K[🐛 bugkiller]
K --> E
style A fill:#2563EB,color:#fff
style C fill:#D97706,color:#fff
style D fill:#059669,color:#fff
style E fill:#EA580C,color:#fff
style F fill:#1e293b,color:#fff
style G fill:#DC2626,color:#fff
style H fill:#DB2777,color:#fff
style I fill:#7C3AED,color:#fff
style J fill:#16a34a,color:#fff
style K fill:#0f766e,color:#fff
style L fill:#92400e,color:#fff
style M fill:#0369a1,color:#fff
style B fill:#1e293b,color:#fff
🔧 Installation
🌍 Codex CLI - Globally
python3 "$SKILLS_PATH/scripts/sync.py" --install --codex
This installs every skill from skills/* into ~/.codex/skills/<skill-name>/, copying the full skill folder including any scripts/, references/, and agents/ subfolders.
Restart Codex CLI to pick up the new skill.
🖥️ Claude Code - Locally
From the root of any target repository:
python3 "$SKILLS_PATH/scripts/sync.py" --install --claude
This installs each skill into <project>/.claude/skills/<skill-name>/, copying the full skill folder (including scripts/, references/, and agents/ if present) so skills that ship helper scripts continue to work.
🟣 OpenCode - Globally
python3 "$SKILLS_PATH/scripts/sync.py" --install --opencode
This installs every skill from skills/* into ~/.config/opencode/skills/<skill-name>/. Skills are auto-discovered and listed in the skill tool.
⚡ Install all at once
python3 "$SKILLS_PATH/scripts/sync.py" --install
This installs Claude, Codex, and OpenCode targets.
🔍 Dry run (print paths without writing)
python3 "$SKILLS_PATH/scripts/sync.py"
🚀 Usage
🌍 Codex CLI
cd <your-project>
codex
# then call it explicitly:
Use the planner skill to plan the implementation of the new feature
# or:
Use the creator skill to generate a PR title and description
🖥️ Claude Code
cd <your-project>
claude
# then invoke:
/planner
/creator
/tester upstream/main
🟣 OpenCode
cd <your-project>
opencode
# Skills are auto-discovered and listed in the skill tool:
Use the planner skill to plan the implementation of the new feature
# or:
Use the creator skill to generate a PR title and description
📖 Skill Descriptions
- 🗺️ Planner — Investigates the codebase, plans tasks in structured checkpoint-driven sections saved as
PLAN.md, then executes section by section with human approval gates. - ✨ Improver — Reviews branch code and related automated tests for Clean Code violations, security vulnerabilities, performance issues, test quality weaknesses, and convention mismatches, then walks through each finding interactively — proposing fixes with diffs and applying them upon approval.
- 🧪 Tester — Refactors tests using Behavior Driven Development principles against an explicit
BASE_REF, improving them to be readable, meaningful, and real-world focused while avoiding unnecessary mocks. - 🚬 Smoker — Analyzes the current branch diff and writes a
SMOKE_TEST.mdfile with branch-specific manual test steps, including prerequisite setup viarails cor API requests when needed. - 🌍 Creator — Reads the current diff / branch, produces a well-structured PR title and description following your team's template, and opens the PR on GitHub.
- 📋 Filler — Reads the current diff / branch and produces a well-structured PR title and description in
pull_request.mdfor manual copy-paste, without creating the PR on GitHub. - ✂️ Breaker — Analyzes a large PR and splits it into smaller, independent pull requests following the Single Responsibility Principle using
wisetreeworktrees — each child branch is created from the base ref, each PR is self-sufficient with its own implementation and tests in an isolated worktree directory, and the sum of all child PRs must exactly match the original diff. - 📈 Coverager — Analyzes a SimpleCov HTML coverage report, identifies uncovered lines, and adds meaningful BDD-structured tests to reach full coverage without artificial test padding.
- 🩹 Fixer — Fetches review comments from a GitHub PR, filters actionable feedback, proposes up to three solutions per comment, and walks through an interactive resolution flow with apply/skip/custom options.
- 🐛 Bugkiller — Reads a bug description, investigates likely root causes, writes
BUG_INVESTIGATION.mdwith ranked solutions and evidence quality, waits for the developer to choose fixes, then implements them with regression tests that should fail on the resolved base ref and pass on the fixed branch. - 🔍 Reviewer — Reviews branch code and related automated tests for Clean Code violations, security vulnerabilities, performance issues, test quality weaknesses, and convention mismatches, then walks through each finding interactively — posting inline PR comments with code suggestions upon approval, and finally drafting a markdown PR review summary that can be submitted either as a comment-only review or a request-changes review.
- 🔀 Merger — Fetches a remote and merges its branch into the current branch (e.g.
upstream/main), then resolves any conflicts by preserving the intent of both sides — without using--ours/--theirsshortcuts and without introducing bugs.
Example Usage
# 🗺️ Plan a new feature
claude /planner "Implement password reset emails with expiring tokens"
# ✨ Review and auto-fix issues in one step
claude /improver
# 🧪 Write code, then improve tests (argument: base ref)
claude /tester upstream/main
# 🚬 Generate a branch-specific smoke test guide (argument: base ref)
claude /smoker upstream/main
# 🌍 Generate the PR description and open the PR (argument: branch to compare)
claude /creator upstream/main
# 📋 Generate pull_request.md without opening a PR (argument: branch to compare)
claude /filler upstream/main
# ✂️ If the PR is too large (argument: maximum lines)
claude /breaker 1000
# 📈 Increase coverage from a SimpleCov report (argument: PATH to the coverage file)
claude /coverager path/to/coverage/index.html
# 🩹 After receiving review feedback (argument: PR number)
claude /fixer 42
# 🐛 Investigate and fix a bug
claude /bugkiller "Checkout fails when a saved card has expired"
# 🔍 Review your own changes
claude /reviewer
# 🔀 Merge a remote branch into the current branch (argument: <remote>/<branch>)
claude /merger upstream/main
"Reusable prompts turn tribal knowledge into shared infrastructure. Write the prompt once, improve it forever."
Contributing
Contributions are welcome! If you have a skill that fits the development workflow, open a PR with:
- A new skill folder under
skills/<skill-name>/SKILL.md - A corresponding
skills/<skill-name>/agents/openai.yaml - An updated entry in the skills table above
Then run:
python3 scripts/sync.py --write