Communitygithub.com

jpoindexter/theft-kit

Painel de fila somente leitura para o ship com reconhecimento de workspace. Mostra quais slots VERSION estão atualmente ocupados por PRs abertos, quais workspaces irmãos do Conductor têm trabalhos em andamento com probabilidade de envio próximo, e qual slot /ship escolheria em seguida. Sem mutações — apenas um instantâneo. Use quando perguntado sobre 'relatório de pouso', 'o que está na fila', 'mostre-me PRs abertos' ou 'qual versão devo pegar em seguida'.

O que é theft-kit?

Este skill fornece um painel de fila de versão somente leitura para o ship do gstack, projetado para workspaces do Conductor. Ele exibe uma visão geral não destrutiva dos slots VERSION ocupados por PRs abertos, identifica workspaces irmãos com trabalho em andamento que provavelmente será enviado em breve, e mostra qual slot o comando /ship selecionaria a seguir. Isso permite que desenvolvedores e agentes de IA entendam rapidamente o estado atual da fila de implantação sem arriscar modificações acidentais. O skill suporta Claude Code, Cursor, Codex e outros agentes de IA que utilizam o ecossistema gstack. A implementação utiliza scripts shell para coletar dados de configuração e telemetria, consultar git para a branch atual, e carregar aprendizados do projeto. Quando invocado, o skill executa um preâmbulo de configuração, verifica atualizações disponíveis, e então apresenta o relatório de pouso formatado. Durante o modo de planejamento, o skill respeita a precedência de comandos seguros e gerencia prompts de integração, como descoberta de recursos, preferências de telemetria, e configuração de roteamento no CLAUDE.md. Importante: o skill é apenas leitura e nunca modifica o estado do repositório; ele apenas fornece um instantâneo da fila para tomada de decisão informada.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/jpoindexter/theft-kit/tree/HEAD/landing-report

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

/landing-report — Painel da Fila de Versão

Preâmbulo (execute primeiro)

_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIVE: $_PROACTIVE"
echo "PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED"
echo "SKILL_PREFIX: $_SKILL_PREFIX"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
if [ "$_EXPLAIN_LEVEL" != "default" ] && [ "$_EXPLAIN_LEVEL" != "terse" ]; then _EXPLAIN_LEVEL="default"; fi
echo "EXPLAIN_LEVEL: $_EXPLAIN_LEVEL"
_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "QUESTION_TUNING: $_QUESTION_TUNING"
mkdir -p ~/.gstack/analytics
if [ "$_TEL" != "off" ]; then
echo '{"skill":"landing-report","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")'"}'  >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
fi
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
  if [ -f "$_PF" ]; then
    if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
      ~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
    fi
    rm -f "$_PF" 2>/dev/null || true
  fi
  break
done
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
_LEARN_FILE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
  _LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
  echo "LEARNINGS: $_LEARN_COUNT entradas carregadas"
  if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
    ~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
  fi
else
  echo "LEARNINGS: 0"
fi
~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"landing-report","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
_HAS_ROUTING="no"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
  _HAS_ROUTING="yes"
fi
_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "HAS_ROUTING: $_HAS_ROUTING"
echo "ROUTING_DECLINED: $_ROUTING_DECLINED"
_VENDORED="no"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
  if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
    _VENDORED="yes"
  fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true

Operações Seguras no Modo de Planejamento

No modo de planejamento, são permitidas por informarem o plano: $B, $D, codex exec/codex review, gravações em ~/.gstack/, gravações no arquivo de plano, e open para artefatos gerados.

Invocação de Skill Durante o Modo de Planejamento

Se o usuário invocar um skill no modo de planejamento, o skill tem precedência sobre o comportamento genérico do modo de planejamento. Trate o arquivo do skill como instruções executáveis, não como referência. Siga-o passo a passo a partir do Passo 0; o primeiro AskUserQuestion é o fluxo de trabalho entrando no modo de planejamento, não uma violação dele. AskUserQuestion (qualquer variante — mcp__*__AskUserQuestion ou nativa; veja "Formato AskUserQuestion → Resolução de ferramenta") satisfaz o requisito de fim de turno do modo de planejamento. Se nenhuma variante for chamável, o skill está BLOQUEADO — pare e reporte BLOQUEADO — AskUserQuestion indisponível conforme a regra de Formato AskUserQuestion. Em um ponto STOP, pare imediatamente. Não continue o fluxo de trabalho nem chame ExitPlanMode lá. Comandos marcados como "EXCEÇÃO DO MODO DE PLANEJAMENTO — SEMPRE EXECUTAR" são executados. Chame ExitPlanMode somente após o fluxo de trabalho do skill ser concluído, ou se o usuário disser para cancelar o skill ou sair do modo de planejamento.

Se PROACTIVE for "false", não auto-invoque nem sugira skills proativamente. Se um skill parecer útil, pergunte: "Acho que /nomedoskill pode ajudar aqui — quer que eu execute?"

Se SKILL_PREFIX for "true", sugira/invoque nomes /gstack-*. Os caminhos de disco permanecem ~/.claude/skills/gstack/[nome-do-skill]/SKILL.md.

Se a saída mostrar UPGRADE_AVAILABLE <antiga> <nova>: leia ~/.claude/skills/gstack/gstack-upgrade/SKILL.md e siga o "Fluxo de atualização inline" (atualização automática se configurada, caso contrário AskUserQuestion com 4 opções, escreva estado de adiamento se recusado).

Se a saída mostrar JUST_UPGRADED <de> <para>: imprima "Executando gstack v{para} (acabou de atualizar!)". Se SPAWNED_SESSION for true, pule a descoberta de recursos.

Descoberta de recursos, no máximo um prompt por sessão:

  • Faltando ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion para auto-commits de checkpoint Contínuo. Se aceito, execute ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Sempre toque no marcador.
  • Faltando ~/.claude/skills/gstack/.feature-prompted-model-overlay: informe "Sobreposições de modelo estão ativas. MODEL_OVERLAY mostra o patch." Sempre toque no marcador.

Após prompts de atualização, continue o fluxo de trabalho.

Se WRITING_STYLE_PENDING for yes: pergunte uma vez sobre o estilo de escrita:

Os prompts v1 são mais simples: glossário de jargão no primeiro uso, perguntas com resultados enquadrados, prosa mais curta. Manter o padrão ou restaurar o terse?

Opções:

  • A) Manter o novo padrão (recomendado — uma boa escrita ajuda todos)
  • B) Restaurar prosa V0 — definir explain_level: terse

Se A: deixe explain_level não definido (padrão para default). Se B: execute ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.

Sempre execute (independentemente da escolha):

rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted

Pule se WRITING_STYLE_PENDING for no.

Se LAKE_INTRO for no: diga "gstack segue o princípio Ferver o Lago — faça a coisa completa quando a IA torna o custo marginal quase zero. Leia mais: https://garryslist.org/posts/boil-the-ocean" Ofereça para abrir:

open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen

Execute open apenas se a resposta for sim. Sempre execute touch.

Se TEL_PROMPTED for no E LAKE_INTRO for yes: pergunte sobre telemetria uma vez via AskUserQuestion:

Ajude o gstack a melhorar. Compartilhe apenas dados de uso: skill, duração, travamentos, ID de dispositivo estável. Nenhum código, caminhos de arquivo ou nomes de repositório.

Opções:

  • A) Ajude o gstack a melhorar! (recomendado)
  • B) Não, obrigado

Se A: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry community

Se B: pergunte acompanhamento:

O modo anônimo envia apenas uso agregado, sem ID único.

Opções:

  • A) Sim, anônimo está ok
  • B) Não, obrigado, totalmente desligado

Se B→A: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous Se B→B: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry off

Sempre execute:

touch ~/.gstack/.telemetry-prompted

Pule se TEL_PROMPTED for yes.

Se PROACTIVE_PROMPTED for no E TEL_PROMPTED for yes: pergunte uma vez:

Deixe o gstack sugerir skills proativamente, como /qa para "isso funciona?" ou /investigate para bugs?

Opções:

  • A) Manter ativado (recomendado)
  • B) Desligar — vou digitar /comandos eu mesmo

Se A: execute ~/.claude/skills/gstack/bin/gstack-config set proactive true Se B: execute ~/.claude/skills/gstack/bin/gstack-config set proactive false

Sempre execute:

touch ~/.gstack/.proactive-prompted

Pule se PROACTIVE_PROMPTED for yes.

Se HAS_ROUTING for no E ROUTING_DECLINED for false E PROACTIVE_PROMPTED for yes: Verifique se um arquivo CLAUDE.md existe na raiz do projeto. Se não existir, crie-o.

Use AskUserQuestion:

gstack funciona melhor quando o CLAUDE.md do seu projeto inclui regras de roteamento de skills.

Opções:

  • A) Adicionar regras de roteamento ao CLAUDE.md (recomendado)
  • B) Não, obrigado, vou invocar skills manualmente

Se A: Anexe esta seção ao final do CLAUDE.md:


## Skill routing

Quando a solicitação do usuário corresponder a um skill disponível, invoque-o através da ferramenta Skill. Em caso de dúvida, invoque o skill.

Regras principais de roteamento:
- Ideias/brainstorming de produto → invocar /office-hours
- Estratégia/escopo → invocar /plan-ceo-review
- Arquitetura → invocar /plan-eng-review
- Sistema de design/revisão de plano → invocar /design-consultation ou /plan-design-review
- Pipeline de revisão completo → invocar /autoplan
- Bugs/erros → invocar /investigate
- QA/teste de comportamento do site → invocar /qa ou /qa-only
- Revisão de código/verificação de diff → invocar /review
- Polimento visual → invocar /design-review
- Ship/deploy/PR → invocar /ship ou /land-and-deploy
- Salvar progresso → invocar /context-save
- Restaurar contexto → invocar /context-restore

Em seguida, faça commit da alteração: git add CLAUDE.md && git commit -m "chore: adicionar regras de roteamento de skills gstack ao CLAUDE.md"

Se B: execute ~/.claude/skills/gstack/bin/gstack-config set routing_declined true e diga que podem reativar com gstack-config set routing_declined false.

Isso só acontece uma vez por projeto. Pule se HAS_ROUTING for yes ou ROUTING_DECLINED for true.

Se VENDORED_GSTACK for yes, avise uma vez via AskUserQuestion a menos que ~/.gstack/.vendoring-warned-$SLUG exista:

Este projeto tem gstack vendido em .claude/skills/gstack/. Vending está obsoleto. Migrar para o modo de equipe?

Opções:

  • A) Sim, migrar para o modo de equipe agora
  • B) Não, vou lidar com isso eu mesmo

Se A:

  1. Execute git rm -r .claude/skills/gstack/
  2. Execute echo '.claude/skills/gstack/' >> .gitignore
  3. Execute ~/.claude/skills/gstack/bin/gstack-team-init required (ou optional)
  4. Execute git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrar gstack de vendido para modo de equipe"
  5. Diga ao usuário: "Concluído. Cada desenvolvedor agora executa: cd ~/.claude/skills/gstack && ./setup --team"

Se B: diga "OK, você está por conta própria para manter a cópia vendida atualizada."

Sempre execute (independentemente da escolha):

eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}

Se o marcador existir, pule.

Se SPAWNED_SESSION for "true", você está executando dentro de uma sessão gerada por um orquestrador de IA (ex.: OpenClaw). Em sessões geradas:

  • NÃO use AskUserQuestion para prompts interativos. Escolha automaticamente a opção recomendada.
  • NÃO execute verificações de atualização, prompts de telemetria, injeção de roteamento ou introdução do lago.
  • Concentre-se em concluir a tarefa e relatar resultados através de saída em prosa.
  • Termine com um relatório de conclusão: o que foi enviado, decisões tomadas, qualquer coisa incerta.

Formato AskUserQuestion

Resolução de ferramenta (leia primeiro)

"AskUserQuestion" pode resolver para duas ferramentas em tempo de execução: a variante MCP do host (ex.: mcp__conductor__AskUserQuestion — aparece na sua lista de ferramentas quando o host a registra) ou a ferramenta nativa do Claude Code.

Regra: se qualquer variante mcp__*__AskUserQuestion estiver na sua lista de ferramentas, prefira-a. Hosts podem desabilitar AUQ nativa via --disallowedTools AskUserQuestion (Conductor faz isso, por padrão) e rotear através de sua variante MCP; chamar a nativa lá falha silenciosamente. Mesmo formato de perguntas/opções; o mesmo formato de resumo de decisão se aplica.

Se nenhuma variante AskUserQuestion aparecer na sua lista de ferramentas, este skill está BLOQUEADO. Pare, reporte BLOQUEADO — AskUserQuestion indisponível e aguarde o usuário. Não escreva decisões no arquivo de plano como substituto, não as emita como prosa e pare, e não decida automaticamente silenciosamente (apenas opt-ins /plan-tune AUTO_DECIDE autorizam auto-seleção).

Formato

Cada AskUserQuestion é um resumo de decisão e deve ser enviado como tool_use, não como prosa.

D<N> — <título da pergunta em uma linha>
Projeto/branch/tarefa: <1 frase de contextualização curta usando _BRANCH>
ELI10: <inglês simples que um adolescente de 16 anos entenderia, 2-4 frases, nomeie os riscos>
Riscos se escolhermos errado: <uma frase sobre o que quebra, o que o usuário vê, o que é perdido>
Recomendação: <escolha> porque <motivo em uma linha>
Completude: A=X/10, B=Y/10 (ou: Nota: as opções diferem em tipo, não em cobertura — sem pontuação de completude)
Prós / contras:
A) <rótulo da opção> (recomendado)
  ✅ <pró — concreto, observável, ≥40 caracteres>
  ❌ <contra — honesto, ≥40 caracteres>
B) <rótulo da opção>
  ✅ <pró>
  ❌ <contra>
Líquido: <síntese em uma linha do que você está realmente trocando>

Numeração D: a primeira pergunta em uma invocação de skill é D1; incremente você mesmo. Esta é uma instrução no nível do modelo, não um contador de tempo de execução.

ELI10 está sempre presente, em inglês simples, sem nomes de funções. A Recomendação está SEMPRE presente. Mantenha o rótulo (recomendado); AUTO_DECIDE depende dele.

Completude: use Completude: N/10

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

jpoindexter/theft-kit

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

jpoindexter/theft-kit

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

jpoindexter/theft-kit

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

jpoindexter/theft-kit

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

jpoindexter/theft-kit

Minimal pre-launch landing with email capture, brand logo, and optional decorative layer. Reads DESIGN.md for colors, typography, and layout rules. Best for: product launches, beta signups, early access programs, indie projects.

Habilidades Relacionadas