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/tray-tecnologia/tray-api-ai-pluginnpx agentmods add skills/tray-tecnologia/tray-api-ai-plugin/notas-fiscaisWrote 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/tray-tecnologia/tray-api-ai-plugin/notas-fiscais)<a href="https://agentmods.dev/skills/tray-tecnologia/tray-api-ai-plugin/notas-fiscais"><img src="https://agentmods.dev/badge/skills/tray-tecnologia/tray-api-ai-plugin/notas-fiscais/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/tray-tecnologia/tray-api-ai-plugin/notas-fiscais"><img src="https://agentmods.dev/badge/skills/tray-tecnologia/tray-api-ai-plugin/notas-fiscais.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 1 finding, up to medium
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 →
- medium Agent Snooping · line 30 Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
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.00088 | $0.02451 |
| Opus 5 | $0.00044 | $0.01226 |
| Sonnet 5 | $0.00018 | $0.00490 |
| Haiku 4.5 | $0.00009 | $0.00245 |
Grade A, and why
tray-notas-fiscais 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 12d 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 — 245 lines — stays where its author put it; the contents beside it link to each section on GitHub.
MANDATORY: Tool Call Required Before Answering
Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar qualquer código ou payload. Se você está respondendo sem ter chamado a ferramenta abaixo, pare e chame agora.
Buscar documentação atualizada (sempre)
node skills/tray-dev/scripts/search_docs.mjs --topic=notas-fiscais "<termo da pergunta>"
<TOPIC_SLUG>: ver tabela emskills/tray-dev/SKILL.md.- Use os trechos retornados como fonte primária; este SKILL.md é resumo.
Nota: este recurso ainda não tem
validate.mjslocal. Você é responsável por revisar campos obrigatórios contra a doc retornada e o resumo abaixo.
Antes de responder
Execute estas verificações antes de gerar qualquer payload ou código:
- Confirme o método HTTP e endpoint correto para a operação solicitada.
- Identifique os campos obrigatórios listados neste documento — não omita nenhum.
- Verifique que
access_tokennão aparece como literal string no código gerado. - Confirme que esta é a skill correta para o recurso (leia
when_not_to_useno frontmatter).
API de Notas Fiscais (NF-e) — Tray
Documentação oficial: https://developers.tray.com.br/#api-de-nota-fiscal
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /invoices |
Listagem de notas fiscais com paginação e filtros |
| GET | /invoices/:id |
Consultar nota fiscal por ID |
| GET | /orders/:order_id/invoices |
Consultar notas fiscais de um pedido |
| POST | /orders/:order_id/invoices |
Cadastrar nota fiscal para um pedido |
| PUT | /invoices/:id |
Atualizar dados da nota fiscal |
Autenticação: ?access_token={token} em todas as chamadas.
Campos da Nota Fiscal
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id |
number | — | ID da nota fiscal (retornado pela API) |
order_id |
number | — | ID do pedido associado (definido na URL no POST) |
number |
string | Sim | Número da nota fiscal |
series |
string | Sim | Série da nota fiscal (ex: "1", "001") |
issue_date |
date | Sim | Data de emissão (formato: YYYY-MM-DD) |
key |
string | Sim | Chave de acesso da NF-e (44 dígitos) |
cfop |
string | Não | Código Fiscal de Operações e Prestações (ex: "5102", "6102") |
link |
string | Não | URL do DANFE (PDF da nota fiscal) |
total_amount |
decimal | Não | Valor total da nota fiscal |
created_at |
datetime | — | Data de criação do registro |
updated_at |
datetime | — | Data da última atualização |
What ships with it
12 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.
- examples/nota-fiscal-atualizar.curl.sh 825 B runs code
- examples/nota-fiscal-atualizar.fixture.json 107 B
- examples/nota-fiscal-atualizar.node.mjs 1.2 KB runs code
- examples/nota-fiscal-consultar.curl.sh 624 B runs code
- examples/nota-fiscal-consultar.node.mjs 895 B runs code
- examples/nota-fiscal-criar.curl.sh 822 B runs code
- examples/nota-fiscal-criar.fixture.json 261 B
- examples/nota-fiscal-criar.node.mjs 1.2 KB runs code
- examples/nota-fiscal-listar-por-pedido.curl.sh 639 B runs code
- examples/nota-fiscal-listar-por-pedido.node.mjs 921 B runs code
- examples/nota-fiscal-listar.curl.sh 562 B runs code
- examples/nota-fiscal-listar.node.mjs 861 B runs code
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.
- 12d ago First seen · 245 lines · 88 tokens per session scan A b255c798292e
tray-notas-fiscais is a skill published in the GitHub repository tray-tecnologia/tray-api-ai-plugin (15 stars, last pushed 1mo ago), licensed MIT. It adds 88 tokens to every session and 2,451 once invoked, about $0.0004 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-08-30.
Other skills, from other repositories
billing-automation
Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.
helius-jupiter
Skill "helius-jupiter" from helius-labs/core-ai, covering helius x jupiter — build defi apps on solana, mcp router surface, prerequisites, 1. helius mcp server and 2. jupiter api key.
helius-okx
Skill "helius-okx" from helius-labs/core-ai, covering helius x okx — build trading & intelligence apps on solana, mcp router surface, prerequisites, 1. helius mcp server and 2. okx skill library (required).
api-commerce-stripe
Stripe payment processing — Checkout Sessions, Payment Intents, subscriptions, webhooks, Connect, customer management, error handling.
llm-cost-advisor
WHAT — Recommend the most cost-effective LLM provider for a given task type. Shows estimated cost per run across available providers and integrates with devcompanion llm-status to show what is actually available.
lemon-squeezy
Lemon Squeezy simplifies global tax compliance and recurring billing. The official @lemonsqueezy/lemonsqueezy.js SDK handles interactions cleanly.