convez.ai
SkillAutomaçãoIntermediário
Victorcorcos

AI Skills para Codex, Claude Code e OpenCode

Victorcorcos/skills

Skills portáveis para automação de workflows de desenvolvimento

Ver no GitHub
InicialPluginScore · de 0 a 100

Coleçã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/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
7
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

Claude Code Skills Codex CLI 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, including scripts/, 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 the skill tool

[!TIP] Quick start:

  • Codex CLI: python3 "$SKILLS_PATH/scripts/sync.py" --install --codex
  • Claude Code: cd <your-project> then python3 "$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_PATH ENV to your bash profile:

export SKILLS_PATH="/abs/path/to/this/repository/skills"

🧠 Skills

EmojiSkillCommandPurposeStatus
🗺️Planner/plannerPlan tasks in sections, execute with approval gates🟢
✨Improver/improverReview code and tests, then fix all found issues directly🟢
🧪Tester/testerRefactor tests using BDD principles and improve them to be readable, meaningful, and real-world focused, avoiding unnecessary mocks🟢
🚬Smoker/smokerGenerate SMOKE_TEST.md manual testing steps from the current branch diff🟢
🌍Creator/creatorGenerate PR descriptions & titles from diffs and open the PR on GitHub🟢
📋Filler/fillerGenerate PR descriptions & titles from diffs and output pull_request.md for copy-paste (no PR creation)🟢
✂️Breaker/breakerSplit large PRs into smaller, independent SRP-based units created from the base ref using wisetree worktrees🟢
📈Coverager/coveragerIncrease code coverage to 100% with meaningful BDD-structured tests from a SimpleCov report🟢
🩹Fixer/fixerResolve PR review comments interactively🟢
🐛Bugkiller/bugkillerInvestigate a bug, write ranked causes, evidence quality, and solutions to BUG_INVESTIGATION.md, then fix selected solutions with regression tests🟢
🔍Reviewer/reviewerReview code and tests, post inline PR comments for approved findings, then optionally submit a PR review summary🟢
🔀Merger/mergerFetch 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.md file with branch-specific manual test steps, including prerequisite setup via rails c or 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.md for 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 wisetree worktrees — 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.md with 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/--theirs shortcuts 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:

  1. A new skill folder under skills/<skill-name>/SKILL.md
  2. A corresponding skills/<skill-name>/agents/openai.yaml
  3. An updated entry in the skills table above

Then run:

python3 scripts/sync.py --write
Ver o original no GitHub

Bom para

Relacionados