convez.ai
SkillProdutividadeIntermediário
zpyoung

Quirk — Skills Core para Claude Code

zpyoung/quirk

19 skills + artefatos tipados para TDD, debug e colaboração em Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Biblioteca de 19 skills para Claude Code cobrindo TDD, debugging sistemático, padrões de colaboração e técnicas comprovadas. Inclui sistema de artefatos tipados para rotear observações (bugs, tarefas adiadas, decisões arquiteturais) em arquivos estruturados em vez de prosa dispersa.

Instalação

$npx convez-ai zpyoung/quirk

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

Casos de uso

  • Implementar ciclos TDD estruturados em projetos
  • Organizar bugs, tarefas adiadas e decisões arquiteturais em arquivos canônicos
  • Facilitar code review e ideação divergente com padrões de colaboração
  • Gerar Architecture Decision Records (ADRs) e rastrear backlog de testes

Veredito

Ferramenta madura (v5.6.2) com design sólido para governança de conhecimento técnico. Sem dependências externas (Python 3.9+), integra bem ao fluxo Claude Code, mas requer disciplina do usuário para máximo valor. Recomendado para equipes que adotam TDD e documentação estruturada.

README

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

quirk

Core skills library for Claude Code: TDD, debugging, collaboration patterns, typed artifacts, and proven techniques.

Version: 5.6.2

What ships

  • 19 skills under skills/ covering TDD, systematic debugging, brainstorming, divergent ideation, plan writing, code review, parallel agent dispatch, and more.
  • Typed artifacts (added in 5.1.0) — surface-routing for observations Claude cannot act on. See below.

Installation

Install via the quirk-dev marketplace (.claude-plugin/marketplace.json).

Typed artifacts

A discipline for routing deferred observations into structured markdown files instead of burying them in prose ("pre-existing", "out of scope", "skipped for brevity").

Quick start

In your project, run:

/quirk:artifacts:init

That scaffolds BUGS.md, DEFERRED.md, TEST_BACKLOG.md, proposals.md, and docs/adr/. It also appends a 5-line trigger snippet to your project's CLAUDE.md (use --no-claude-md to skip that).

Slash commands

CommandPurpose
/quirk:artifacts:initScaffold artifact files into the current project
/quirk:artifacts:bugAppend a BUG-N entry to BUGS.md
/quirk:artifacts:deferAppend a DEFER-N entry to DEFERRED.md
/quirk:artifacts:test-skipAppend a TEST-N entry to TEST_BACKLOG.md
/quirk:artifacts:triageClassify an observation and append to the right file
/quirk:artifacts:adrCreate a new Architecture Decision Record
/quirk:artifacts:review-artifactsRead-only summary of all entries

Hooks

Three lifecycle hooks (warn-only, never block):

  • SessionStart loads tail of artifact files (or suggests /init if none exist).
  • PostToolUse lints written files for tic phrases ("pre-existing", etc.).
  • Stop posts a wrap-up reminder.

All three gate on artifact-file presence — they are inert no-ops in projects that haven't run /quirk:artifacts:init.

Design + spec

See docs/specs/2026-05-04-typed-artifacts-design.md.

Agent Isles bridge

Quirk can author Agent Isles-aware artifacts while keeping Markdown canonical and Agent Isles optional. The stdlib-only helper in bin/agent_isles.py detects a local isles binary, an isles on PATH, or an explicit npx agent-isles@next fallback; it never silently installs packages.

python3 bin/agent_isles.py doctor
python3 bin/agent_isles.py command examples/agent-isles/typed-artifacts-summary.md

The experimental local component pack lives in packs/quirk/ and covers typed artifact summaries, TDD cycle reports, plan readiness, and review findings. Examples live in examples/agent-isles/. See docs/agent-isles-artifacts.md for the authoring contract: Markdown source is canonical, generated HTML under .quirk/isles/ is disposable by default, and the Quirk pack is trusted local code.

Development

python3 -m pytest -q

Stdlib-only Python 3.9+. No third-party dependencies.

Ver o original no GitHub

Bom para

Relacionados