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 | $0.00019 | $0.01272 |
| Sonnet 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 9d 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.
- 9d 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 (19 stars, last pushed 4d ago), licensed MIT. It adds 39 tokens to every session and 2,543 once invoked, about $0.0002 per session on Opus 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
taiyi-ui-design
A design-planning guide for describing how an application's user interface should look and behave. It produces a UI-DESIGN.md document covering layouts, components, interactions, accessibility, and error states.
taiyi-evolve
A workflow skill that compares the implemented code with the frozen design after development and testing. It records architecture changes and proposes updates to DESIGN.md, the document describing the intended system structure.
taiyi-diagram-c4
A code-scanning tool that builds C4 architecture documents from a repository. It separates facts observed in the code from conclusions inferred about the design and uses Mermaid diagrams as the source format.
retrospective-audit
Stage B of /prflow:retrospective-weekly: given a most-recent-first subset of one recurring pattern's occurrence-PR context bundles (bounded by auditbundlecap), re-derive the root cause and return one JSON object carrying a ranked findings array (one to three sub-patterns) — no edits, no worktree. Invoked as a subagent…
docs
Use when documentation generally needs to catch up with a branch before pushing or merging, covering internal developer docs, external customer-facing docs, and release notes together — "update the docs", "do a docs pass before I merge", "make sure everything's documented". Prefer this when no single documentation…
tmux-lane-orchestrator
Manage one tmux agent lane from its matching ops pane, inspect live pane state and Codex logs on cold start, and produce concise manager summaries for OpenClaw and adjacent project work.