Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/bittencourtthulio/expxdevnpx agentmods add skills/bittencourtthulio/expxdev/runxWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/bittencourtthulio/expxdev/runx)<a href="https://agentmods.dev/skills/bittencourtthulio/expxdev/runx"><img src="https://agentmods.dev/badge/skills/bittencourtthulio/expxdev/runx/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/bittencourtthulio/expxdev/runx"><img src="https://agentmods.dev/badge/skills/bittencourtthulio/expxdev/runx.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00071 | $0.04514 |
| Opus 5.5 | $0.00028 | $0.01806 |
| Sonnet 5.5 | $0.00014 | $0.00903 |
| Haiku 4.5 | $0.00007 | $0.00451 |
Grade A, and why
runx scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 257 lines — stays where its author put it; the contents beside it link to each section on GitHub.
runx
runx é a metade Run do método da Expx (Exponencial): a sustentação do dia a dia. A metade Build é a sprintx, que planeja features novas do zero. As duas compartilham a mesma disciplina de engenharia — base antes do plano, hierarquia sprint → fase → task, TDD obrigatório, critério de aceite verificável, paralelismo declarado, execução guiada por orquestrador. Muda o gatilho e o tamanho, nunca o rigor.
Princípio central
Não se corrige o que não se entendeu, e não se planeja o que não se mapeou. Primeiro a base do que será tocado, depois a causa, depois o plano, depois o código. O escopo fica travado no que a investigação provou: o que não está lá não é tocado.
Fronteira de escopo
runx começa quando o chamado já chegou na mão do desenvolvedor. O que vem antes — cliente reclama, suporte atende e cadastra a ocorrência — acontece fora daqui e chega pronto.
runx termina quando os relatórios estão gravados e a ocorrência está encerrada. O deploy em si é externo: runx registra que foi liberado, não executa o deploy.
Tipos de ocorrência
| Tipo | Significado |
|---|---|
bug |
defeito em comportamento existente |
melhoria-ui |
mudança visual, layout, componente |
melhoria-ux |
mudança de fluxo, navegação, usabilidade |
novo-relatorio |
relatório novo dentro de estrutura existente |
regra-de-calculo |
alteração de fórmula ou regra de negócio |
campo-novo |
novo campo em tela, formulário ou entidade |
outro |
qualquer coisa que não caiba acima |
O tipo é determinado no início e governa o comportamento do estágio E1: bug exige causa raiz comprovada; os demais tipos entram em análise de impacto.
Contratos
Contrato da Task — toda task declara, obrigatoriamente
| Campo | Conteúdo |
|---|---|
id |
T-NN.MM |
titulo |
título curto |
objetivo |
uma frase |
arquivos |
criados e alterados |
teste_regressao |
apenas na primeira task da primeira fase: o teste que reproduz o problema e hoje falha. Obrigatório quando tipo: bug |
teste_integracao |
o que valida, contra o quê |
teste_funcional |
o que valida, com qual entrada e saída |
criterio_aceite |
verificável, binário, sem adjetivo |
depende_de |
[ids] ou [] |
paralelizavel |
true | false |
status |
pendente | em_andamento | concluida | bloqueada |
What ships with it
22 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- assets/TEMPLATE-analise-impacto.md 5.3 KB
- assets/TEMPLATE-base-area.md 2.0 KB
- assets/TEMPLATE-causa-raiz.md 5.2 KB
- assets/TEMPLATE-fases.md 3.5 KB
- assets/TEMPLATE-INDICE.md 1.3 KB
- assets/TEMPLATE-ocorrencia.md 2.1 KB
- assets/TEMPLATE-ORQUESTRADOR.md 4.6 KB
- assets/TEMPLATE-plano-condensado.md 5.5 KB
- assets/TEMPLATE-qa.md 2.5 KB
- assets/TEMPLATE-relatorio-tecnico.md 3.7 KB
- assets/TEMPLATE-relatorio-uso.md 2.3 KB
- assets/TEMPLATE-sprint.md 1.7 KB
- assets/TEMPLATE-tasks.md 3.9 KB
- DECISOES-DA-SKILL.md 37 KB
- references/00-schema.md 21 KB
- references/01-investigacao.md 21 KB
- references/02-plano.md 14 KB
- references/03-fix.md 12 KB
- references/04-qa.md 9.2 KB
- references/05-relatorio.md 9.7 KB
- references/06-estado.md 11 KB
- references/07-diagrama.md 27 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- today First seen · 257 lines · 71 tokens per session scan A e1030339eb23
runx is a skill published in the GitHub repository bittencourtthulio/expxdev (3 stars, last pushed 1mo ago), licensed MIT. It adds 71 tokens to every session and 4,514 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-07.
runx compared with skills from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| runxbittencourtthulio/expxdev | Skill | 3 | 1mo ago | MIT | A | 71 | Claude Code |
| ph-debugjyt6640/persona-harness | Skill | 23 | 29d ago | Apache-2.0 | A | 25 | Claude Code, Codex |
| ph-lsp-setupjyt6640/persona-harness | Skill | 23 | 29d ago | Apache-2.0 | A | 22 | Claude Code, Codex |
| bug-investigation1024XEngineer/bytemind | Skill | 27 | 3mo ago | MIT | A | 16 | Claude Code |
| code_explorergoogle-gemini/gemini-cli | Skill | 109k | yesterday | Apache-2.0 | A | 28 | Gemini CLI |
| test-failure-explorerQwenLM/qwen-code | Skill | 29k | yesterday | Apache-2.0 | A | 32 | Claude Code, Codex |
| session-investigatorevalstate/fast-agent | Skill | 4.0k | yesterday | Apache-2.0 | A | 68 | Claude Code, Codex |