convez.ai
SkillAutomaçãoAvançado
borkweb

Skills para Claude Code e Desenvolvimento

borkweb/skills

Skills de planejamento, revisão e ship para desenvolvimento full-cycle

Ver no GitHub
InicialPluginScore · de 0 a 100

Coleção de skills, agents e comandos para Claude Code, Codex e Gemini cobrindo todo o ciclo de desenvolvimento: planejamento, revisão de código, QA e deployment. Inclui ferramentas de arquitetura, segurança, linting e automação de documentação.

Instalação

$npx convez-ai borkweb/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
9
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
2026-05-16-001
Issues abertas
0
Contribuidores
1

Casos de uso

  • Planejar features e arquitetura antes de codificar
  • Revisar código, segurança e documentação automaticamente
  • Executar QA em staging e preparar PRs
  • Auditar instruções de agents e reduzir uso de contexto
  • Orquestrar múltiplos builders em modo arquiteto

Veredito

Coleção madura e bem-organizada focada em automação de processos de desenvolvimento. Bastante específica para fluxos em Claude Code; exige familiaridade com o ecossistema e mentalidade de engenharia sênior para aproveitar plenamente.

README

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

skills

My Original and Collected skills, agents, commands, and hooks for Claude Code, Codex, and Gemini. Writing, reviewing, planning, QA, and shipping across the development cycle.

Skills are organized into two buckets:

  • skills/core/ — skills I wrote (or substantially extended from a small starting point)
  • skills/gstack/ — skills ported from upstream sources like gstack, then trimmed of upstream-specific infrastructure and adapted to local conventions

Personal voice and other private things live separately at borkweb/skills-private.

Install

Add via skills.sh

npx skills add borkweb/skills

Or as a Claude Code plugin

/plugin marketplace add https://github.com/borkweb/skills
/plugin install bork

Quick Start

  1. Run /plan-session — describe what you're building. It will reframe the problem before you write a line of code.
  2. Run /plan-deep-review on any feature idea
  3. Run /plan-eng-review on any plan
  4. Run /review on any branch with changes
  5. Run /qa on your staging URL
  6. Run /ship to merge, run tests, and open the PR

Original and collected skills (skills/core/)

SkillDescription
agents-md-lintAudits AI agent instruction files (AGENTS.md, CLAUDE.md, etc.) and removes facts discoverable from code alone to save context tokens.
auto-scopeProactively scopes a coding task before implementation — names the handful of relevant files (read/edit these), the areas to leave alone, and open scope questions, so work doesn't start by reading the whole repo. Tool-agnostic discovery (grepika / graphify / grep); self-skips trivial or single-file work.
cavemanUltra-compressed response mode that drops articles, filler, and hedging to cut tokens ~75% while preserving technical accuracy. Intensity levels: lite / full / ultra (and wenyan variants).
councilRuns structured adversarial assessment of ideas, plans, and proposals through selected lenses, debate rounds, risk mapping, and a verdict.
handoffWrites handoff documentation so agents can communicate with relevant context and pick up from an optimal place.
humanizeDetects and removes AI writing patterns (inflated language, em dash overuse, rule of three, hollow rhythm punches, etc.) on inline text or a file path; rewrites files in place.
offloadArchitect-mode codex orchestration. Reads session-keyed handoffs from ~/.agent-handoffs/offload/, arbitrates builder disagreements, judges gate results against frozen criteria, specs the next one-PR slice, and dispatches a builder block into a new tmux window (falls back to Terminal, then headless). The architect never writes implementation code; the human is the final judge.
prototypeScaffolds a frontend prototype or a backend prototype with a disposable state machine to test an idea.
red-penStrict editorial reviewer applying Orwell's rules and Practical Typography. Catches passive voice, dead metaphors, straight quotes, wrong dashes, and other prose drift.
review-securityDeep security review grounded in 20 CVE-based pattern libraries (Heartbleed, Log4Shell, Next.js bypass, runc escape, xz backdoor, etc.). Callable standalone or as a reference from review.
session-budgetX-rays context composition (stale vs. load-bearing), gives a compact/clear/leave-it verdict, and — only when a handoff would carry state not recoverable from disk/git — writes a reinit-ready handoff to a consume-once ~/.agent-handoffs/ mailbox.
writing-commitsAnalyzes staged changes and generates conventional commit messages matching repository style.
writing-plansApplies concise writing style to plan documents — strips filler, bans inflated adjectives, requires structured decisions.
writing-sqlEnforces strict vertical SQL formatting conventions for raw files, inline PHP, migrations, and framework query builders.

Gstack ports (skills/gstack/)

Workflow stack ported from gstack and adapted. Together the skills cover a full sprint:

Think → Plan → Build → Review → Test → Ship

Each skill feeds into the next. plan-session writes a design doc that plan-deep-review reads. plan-eng-review writes a test plan that qa picks up. review catches bugs that ship verifies are fixed. Nothing falls through the cracks because every step knows what came before it.

SkillSpecialistDescription
autoplanPlan PipelineAuto-review pipeline. Chains plan-deep-review → plan-design-review → plan-eng-review → plan-devex-review at full depth, auto-deciding intermediate AskUserQuestion calls via 6 principles. Surfaces taste decisions and user challenges at one Final Approval Gate.
design-consultationDesign PartnerDesign system consultation — proposes aesthetic, typography, color, layout, spacing, and motion as a coherent package. Generates font+color preview pages and writes DESIGN.md.
design-reviewDesigner Who CodesDesigner's eye QA on live sites. 10-category audit (~80 items), letter grades, AI slop detection. Fixes issues in source code with atomic commits and before/after verification.
document-releaseDoc EditorPost-ship documentation sync. Reads all project docs, cross-references the diff, auto-updates factual content, polishes CHANGELOG voice, cleans up TODOS, and optionally bumps VERSION.
investigateDebuggerSystematic debugging with root cause investigation. Five phases: collect symptoms, pattern analysis, hypothesis testing, implementation, verification. Iron Law: no fixes without root cause.
plan-deep-reviewProduct OwnerDeep plan review with four modes (Scope Expansion, Selective Expansion, Hold Scope, Scope Reduction). Challenges premises, maps failure modes, reviews architecture/security/performance/deployment.
plan-design-reviewSenior DesignerDesigner's eye plan review. Rates design dimensions 0-10, explains what would make each a 10, then fixes the plan to get there. Covers info architecture, interaction states, user journey, AI slop risk, responsive, and accessibility.
plan-devex-reviewDeveloper AdvocateDX plan review for developer-facing products (APIs, CLIs, SDKs, libraries, platforms, docs). Investigates persona, benchmarks competitors, designs magical moment, traces friction points, scores 8 DX dimensions 0-10. Three modes: DX EXPANSION / DX POLISH / DX TRIAGE.
plan-eng-reviewEng ManagerEng manager-mode plan review. Locks in execution plan — architecture, data flow, diagrams, edge cases, test coverage, performance. Interactive with opinionated recommendations.
plan-sessionProduct OwnerStructured product design session — forces hard questions about demand, status quo, and narrowest wedge before proposing solutions. Produces a design doc, not code.
qaQA LeadSystematic QA testing with fix loop. Three tiers (Quick/Standard/Exhaustive), diff-aware mode, health scoring, framework-specific guidance. Fixes bugs atomically with before/after evidence.
qa-onlyQA ReporterReport-only QA testing — finds and documents bugs with screenshots and health scores but never fixes anything. Same modes and rubric as qa.
reviewStaff EngineerPre-landing PR review. Two-pass analysis (critical + informational) for SQL safety, race conditions, LLM trust boundaries, enum completeness, and more. Fix-first: auto-fixes mechanical issues, asks about ambiguous ones.
shipRelease EngineerFully automated ship workflow: merge base, run tests, pre-landing review, plan completion audit, version bump, CHANGELOG, bisectable commits, push, create PR.

Commands

Skills get an auto-generated invocation from the host agent — these commands are the extras: aliases and compound workflows that don't map one-to-one to a single skill.

CommandDescription
/commitAlias for writing-commits. Checks for unstaged changes, optionally stages them, then crafts the message.
/full-reviewChains review → design-review → qa into one pipeline. Passes context forward between stages. Produces a combined ship-readiness verdict. review-security auto-inserts as Stage 2 when the diff touches security-sensitive code; force on with --security or off with --no-security.
/offloadRun one architect turn: judge ready results, spec the next slice, emit and optionally dispatch the codex builder block.
/preflightFast pre-merge safety check. Critical-only code review + smoke test + quick test run. Under 2 minutes. For small PRs where /full-review is overkill.
/statusRead-only branch status and workflow progress report. Shows what's been done, what's left, and suggests the next step.

Agents

AgentTriggerDescription
triage"production is broken", "urgent fix", "hotfix", "incident"Emergency incident response. Triages severity, fast-tracks root cause investigation, creates minimal hotfix, ships via emergency PR.

Hooks

HookEventDescription
pre-pushBefore git pushRuns critical-only review (SQL injection, auth gaps, race conditions) before any push. Blocks on critical issues. Under 30 seconds.
post-mergeAfter git merge on default branchNon-blocking reminders: nudges about /document-release when API/config/schema files changed. Also flags missed VERSION bumps and open TODOS items.

Credits

  • The Collected workflow stack is ported from garrytan/gstack with YCombinator-specific bits genericized and then iterated on locally.
  • council is based on @Devattom's workflow-debate skill.
  • handoff and prototype are from @mattpocock.
  • humanize originated from @blader's humanizer skill, with substantial extensions for the hand-cover diagnostic, hollow rhythm punches, and rewrite constraints.

License

MIT

Ver o original no GitHub

Bom para

Relacionados