convez.ai
SkillDesenvolvimento WebIntermediário
toporek

Zero Docs Skill

toporek/zero-docs-skill

Documentação do Zero localmente sincronizada para respostas precisas no Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill do Claude Code que espelha a documentação do Rocicorp Zero localmente em Markdown, permitindo que Claude responda perguntas sobre ZQL, schema, mutators e zero-cache baseado na documentação real em vez de adivinhar. Sincroniza automaticamente semanalmente e funciona offline, sem round-trips de rede durante o desenvolvimento.

Instalação

$npx convez-ai toporek/zero-docs-skill

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

Casos de uso

  • Desenvolvimento com Rocicorp Zero sem consultar documentação externa
  • Respostas precisas sobre ZQL, schema e mutators durante pair programming
  • Busca offline e versionada de referências técnicas do Zero

Veredito

Skill especializado e bem-executado para desenvolvedores que trabalham com Rocicorp Zero. O mecanismo de sincronização automática e busca local garante respostas precisas e offline, eliminando alucinações sobre APIs específicas da framework.

README

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

zero-docs-skill

A Claude Code plugin that mirrors the Rocicorp Zero documentation into local, grep-friendly Markdown so Claude Code answers Zero questions (ZQL, schema, mutators, permissions, zero-cache) from the real docs instead of guessing.

Compared to fetching zero.rocicorp.dev/llms.txt at question time: this is offline, grep-able, version-pinned (SOURCE.md), auto-synced weekly, and the skill triggers automatically whenever you work on Zero code — no network round-trips mid-task.

Install

In Claude Code:

/plugin marketplace add toporek/zero-docs-skill
/plugin install zero-docs@zero-docs

The skill activates automatically when you work on Zero-related code. New commits (including the weekly docs sync) reach installed users as plugin updates.

How it works

  • skills/zero-docs/ — the installable skill: SKILL.md router, generated INDEX.md, and references/ (one Markdown file per upstream doc).
  • scripts/sync.mjs — enumerates docs from a shallow clone of rocicorp/zero-docs (for titles, descriptions, and the pinned commit), fetches each page's build-rendered markdown from zero.rocicorp.dev/docs/{slug}.md, and rewrites internal links to local relative paths.

Updating

npm run sync        # re-pull upstream and regenerate (commit the result)
npm run sync:check  # non-zero exit if committed output drifts from upstream
npm test            # unit tests for the transform/index/collect modules

SOURCE.md records the upstream commit the current mirror was generated from. A weekly GitHub Action opens a PR automatically when upstream changes.

Note (maintainers/forks): the weekly sync workflow opens PRs via peter-evans/create-pull-request, which requires the repo setting Settings → Actions → General → "Allow GitHub Actions to create and approve pull requests" to be enabled.

License & attribution

Documentation content under skills/zero-docs/references/ is © Rocicorp, mirrored from rocicorp/zero-docs and zero.rocicorp.dev under the Apache License 2.0, with mechanical modifications (fetched as rendered markdown; internal links rewritten to local paths). The sync tooling in this repo is also Apache-2.0.

This is an unofficial community project, not affiliated with or endorsed by Rocicorp. "Zero" and "Rocicorp" are names of their respective owners.

Ver o original no GitHub

Bom para

Relacionados