Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add andregusman-raiz/a-gusman-claude --skill ag-referencia-stack-decisionsgit clone --depth 1 https://github.com/andregusman-raiz/a-gusman-claudeWrote 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/andregusman-raiz/a-gusman-claude/ag-referencia-stack-decisions)<a href="https://agentmods.dev/skills/andregusman-raiz/a-gusman-claude/ag-referencia-stack-decisions"><img src="https://agentmods.dev/badge/skills/andregusman-raiz/a-gusman-claude/ag-referencia-stack-decisions/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/andregusman-raiz/a-gusman-claude/ag-referencia-stack-decisions"><img src="https://agentmods.dev/badge/skills/andregusman-raiz/a-gusman-claude/ag-referencia-stack-decisions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 8 findings, up to high
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- high Privilege Escalation · line 229 Code accesses credential files (SSH keys, AWS credentials, etc.). This could indicate credential theft attempts.Fix: Remove references to credential paths. Use environment variables or secrets managers. For docs, use placeholder paths (e.g., /path/to/config). Never load .env or token files in production code paths.
- medium MCP Rug Pull · line 10 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
- medium MCP Rug Pull · line 158 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
- medium Excessive Agency · line 39 Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
- medium MCP Rug Pull · line 127 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
- medium MCP Rug Pull · line 162 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
- medium MCP Rug Pull · line 163 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
- medium MCP Rug Pull · line 176 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
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.00039 | $0.02543 |
| Opus 5.5 | $0.00016 | $0.01017 |
| Sonnet 5.5 | $0.00008 | $0.00509 |
| Haiku 4.5 | $0.00004 | $0.00254 |
Grade A, and why
ag-referencia-stack-decisions 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 1mo ago.
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 — 258 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Stack Decisions — rAIz Educação
Vercel + Supabase first. Libs avulsas só quando a plataforma nativa não resolve. Baseado em 24 repos e 9 projetos ativos (Mar/2026).
Princípio: Plataforma > Biblioteca
Vercel (deploy, cache, analytics, functions, blob) + Supabase (auth, DB, storage, realtime)
= 80% das necessidades resolvidas com ZERO libs extras.
Só adicionar dependência quando Vercel+Supabase genuinamente não resolvem.
Tier 1 — OBRIGATÓRIO (sem exceção)
| Área | Escolha | Justificativa | NUNCA usar |
|---|---|---|---|
| Framework | Next.js 16 App Router | Server Components default, ISR, streaming | Remix, SvelteKit, Pages Router |
| Linguagem | TypeScript 5 strict | --max-warnings=0, zero any |
JavaScript |
| Validação | Zod 4 | Schema = source of truth (DB, API, forms) | Yup, Joi |
| Deploy | Vercel (Git Integration) | PR → preview → merge → auto-deploy | AWS, Azure, vercel --prod direto |
| Banco | Supabase PostgreSQL | Auth + DB + Storage + RLS integrados | MongoDB, Firebase, DynamoDB |
| Auth | Supabase Auth | 2FA, RLS nativo, Magic Link, Google SSO | NextAuth |
| Storage | Supabase Storage | Buckets privados, signed URLs, RLS | AWS S3 |
| CI/CD | Vercel Git Integration | buildCommand: pre-deploy-gate.sh && npm run build |
Jenkins, CircleCI |
| RLS | ATIVO em TODAS as tabelas | Desde a primeira migration | Tabela sem RLS = dados expostos |
Tier 2 — RECOMENDADO (usar por padrão)
| Área | Escolha | Quando NÃO usar |
|---|---|---|
| Styling | Tailwind 4 + shadcn/ui + Lucide + next-themes | Nunca desviar |
| Cache | Vercel Runtime Cache (per-region KV) | Se precisa Redis full (pub/sub, streams) → Upstash |
| Charts | Recharts 3.8 | Se precisa heatmap/treemap → Nivo. Se milhões de pontos → ECharts |
| Resend + React Email | Vercel não tem email nativo | |
| Testes | Vitest + Playwright E2E | Jest só em projeto legacy |
| Package mgr | npm | bun não adotado em produção |
| Icons | Lucide React | Consistência cross-projetos |
| Fonts | IBM Plex Sans / Mono | Design system rAIz |
| Analytics | Vercel Web Analytics + Speed Insights | Sentry só se precisa stack completa |
| Observability | Vercel Logs + Drains | OTel só para raiz-platform |
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.
- 1mo ago First seen · 258 lines · 39 tokens per session scan A 120bdf1ddc81
ag-referencia-stack-decisions is a skill published in the GitHub repository andregusman-raiz/a-gusman-claude (18 stars, last pushed 1mo ago), licensed MIT. It adds 39 tokens to every session and 2,543 once invoked, about $0.0002 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-09-03.
Other skills, from other repositories
local-ai-agents
Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
next-cache-components-adoption
Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…
chat-pet-sprite-creation
Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.
cpu-profile-analysis
Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…
insight-error-page
Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…