cost-tracker
Skill28 starsChanged 3 months agoApache-2.0View on GitHub
Skill de rastreamento de custo por sessao. Monitora tokens consumidos, chamadas de API (fal.ai, Brave, Firecrawl), tempo de execucao e custo estimado por skill no pipeline. Gera relatorio de custo ao final da sessao. Trigger em: "custo", "cost", "quanto gastou", "token usage", "consumo", "budget", "relatorio de custo".
4 other projects use a version of this.
Adopted by
Most recently taken up by
- suryast/free-ai-agent-skillstheir own version, first seen Oct 10, 2026
- rohitg00/pro-workflowtheir own version, first seen Sep 29, 2026
- zeuikli/claude-code-workspacetheir own version, first seen Jun 16, 2026
- timdevai/proteustheir own version, first seen Jun 10, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- rohitg00/pro-workflow★ 2.9ksame name
- zeuikli/claude-code-workspace★ 155same name
- suryast/free-ai-agent-skills★ 2same name
- timdevai/proteus★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository92 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- po-feature-specSkill
- ui-ux-designSkill
- backend-apiSkill
- frontend-integrationSkill
- qa-testingSkill
- security-reviewSkill
- deploy-dockerSkill
- context-managerSkill
- orchestratorSkill
- documenterSkill
- reviewerSkill
- motion-designSkill
- marketing-copySkill
- seo-specialistSkill
- mobile-tauriSkill
- image-generatorSkill
- repo-auditorSkill
- asset-librarianSkill
- observability-sreSkill
- data-analyticsSkill
- accessibility-specialistSkill
- migration-refactor-specialistSkill
- release-managerSkill
- ai-integration-architectSkill
- prompt-engineerSkill
- video-integration-specialistSkill
- claude-md-generatorSkill
- design-intelligenceSkill
- session-summarySkill
- smart-suggestionsSkill
- detective-specSkill
- static-analysisSkill
- skill-authorSkill
- web-asset-generatorSkill
- tdd-engineerSkill
- architecture-deepenerSkill
- program-routerSkill
- parallel-dispatcherSkill
- blog-publisherSkill
- blog-screenshotSkill
- canary-deploymentSkill
- zoom-outSkill
- handoff-contextSkill
- post-deploy-canary-monitorSkill
- pattern-conformitySkill
- research-prepSkill
- context-budgetSkill
- direct-response-copySkill
- ux-researchSkill
- ui-polishSkill
- doubt-driven-reviewSkill
- video-analysisSkill
- marketing-reporting-analyticsSkill
- responsive-conversionSkill
- mobile-ux-foundationsSkill
- i18n-localizationSkill
- closed-loop-revenueSkill
- app-reference-architectureSkill
- The first 60 shown.
The file
Files
Cost Tracker
O Cost Tracker monitora e consolida os custos de cada sessao de trabalho. Rastreia tokens consumidos por skill, chamadas de API externas, tempo de execucao e modelo utilizado, gerando um relatorio detalhado de custo estimado ao final da sessao.
Governanca Global
Esta skill segue GLOBAL.md, policies/execution.md, policies/persistence.md, policies/token-efficiency.md, policies/tool-safety.md, policies/handoffs.md, policies/evals.md, policies/memory-tiers.md e policies/memory-consolidation.md (sugerir /consolidate-memory quando vault crescer demais).
Quando Usar
- ao final de uma sessao para consolidar custos
- quando o usuario perguntar quanto custou ou qual o consumo
- quando o pipeline for longo e envolver multiplas skills
- quando o objetivo for otimizar gastos e identificar skills mais caras
Quando Nao Usar
- para decisoes de negocio baseadas em custo real de infra
- para substituir billing real de provedores (fal.ai, Brave, Firecrawl)
- para estimar custo de infraestrutura de deploy ou hosting
Entradas Esperadas
- pipeline executado e skills acionadas
- chamadas de API externas realizadas (fal.ai, Brave, Firecrawl)
- metadata de respostas LLM (tokens de entrada/saida)
Saidas Esperadas
- relatorio em
docs/cost-reports/session-YYYY-MM-DD.md - resumo de custo por skill
- total estimado da sessao
Responsabilidades
- Rastrear tokens consumidos por skill durante o pipeline
- Contabilizar chamadas de API externa (fal.ai, Brave Search, Firecrawl)
- Calcular custo estimado com base no modelo usado e volume de tokens
- Gerar relatorio estruturado de custo da sessao
- Persistir historico de custos para comparacao entre sessoes
Metricas Rastreadas
| Metrica | Fonte | Exemplo |
| Tokens consumidos | LLM response metadata | 12.400 input / 3.200 output |
| Chamadas API fal.ai | Contagem por tool call | 3 chamadas (image gen) |
| Chamadas API Brave | Contagem por tool call | 5 chamadas (search) |
| Chamadas API Firecrawl | Contagem por tool call | 2 chamadas (scrape) |
| Tempo de execucao | Timestamps inicio/fim | 14min 32s |
| Modelo usado | Model Routing policy | claude-sonnet-4-20250514 |
Memory Tiers e Decay
O Cost Tracker também monitora a saúde dos tiers de memória ao final de cada sessão:
- Learned-skills com score baixo (< 0.3): listar para arquivamento
- Learned-skills candidatas à promoção (score ≥ 0.8): sinalizar para skill 35
- Tamanho do devkit_context_pack: alertar se exceder 500 tokens por entrada
Ver policies/memory-tiers.md para a lógica completa de score e decay.
Formato do Relatorio
# Relatorio de Custo — Sessao YYYY-MM-DD
## Pipeline Executado
[nome do pipeline ou descricao]
## Skills Acionadas
| Skill | Tokens (in/out) | API Calls | Custo Estimado |
|---|---|---|---|
| Repo Auditor | 8.000 / 2.100 | 0 | $0.03 |
| Frontend Integration | 15.000 / 5.200 | 2 fal.ai | $0.12 |
## Chamadas de API Externa
| Provedor | Quantidade | Custo Estimado |
|---|---|---|
| fal.ai | 2 | $0.08 |
| Brave Search | 5 | $0.01 |
## Resumo
- **Total de tokens**: 45.600 input / 14.300 output
- **Total de chamadas API**: 7
- **Custo total estimado**: $0.25
- **Duracao da sessao**: 14min 32sIntegracao com Outras Skills
- Orchestrator (09): aciona o Cost Tracker ao final do pipeline para gerar relatorio
- Model Routing (policy): fornece o tier de modelo usado por skill/subagent, impactando o calculo de custo. Ver
policies/model-routing.md - Todas as skills: reportam consumo de tokens e chamadas no handoff (bloco
tokens_in/tokens_out/api_callsno handoff estruturado da skill, seguindopolicies/handoffs.md) — sem isso o Cost Tracker não tem de onde puxar o número, e não deve inventar estimativa não-declarada
Checkpoint antes de gerar o relatório: somar os totais por skill e conferir contra o total geral — se a soma das partes não bater com o total (skill reportou tokens mas não entrou na soma, ou duplicou), corrigir a consolidação antes de persistir. Um relatório com totais que não fecham é pior que nenhum relatório.
Evidencia de Conclusao
- relatorio de custo gerado em
docs/cost-reports/ - metricas de tokens e chamadas API coletadas
- historico de custos atualizado
Handoff
Entregar:
- caminho do relatorio de custo
- highlight das skills mais caras da sessao
- recomendacao de otimizacao (ex: usar modelo menor, reduzir chamadas)
Seguir policies/handoffs.md.
Codigo Limpo
Manter relatorios concisos, metricas precisas e formatos consistentes entre sessoes.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

