From 44cf9930a9913c2f69a1db9fcd57b4d3d0501885 Mon Sep 17 00:00:00 2001 From: Sergio Date: Tue, 22 Sep 2026 15:36:47 -0300 Subject: [PATCH] =?UTF-8?q?docs(skill):=20encurta=20a=20descri=C3=A7=C3=A3?= =?UTF-8?q?o=20da=20skill=20nfeio-php-sdk=20para=20o=20roteamento?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A descrição tinha ~1.600 caracteres, acima do limite de 1.024 da spec de Agent Skills, com lista de sinônimos e fatos de comportamento que já estão no corpo da skill. Fica só o que decide quando acionar. Co-Authored-By: Claude Opus 5.5 --- skills/nfeio-php-sdk/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/nfeio-php-sdk/SKILL.md b/skills/nfeio-php-sdk/SKILL.md index 4de8dcc..ee0a154 100644 --- a/skills/nfeio-php-sdk/SKILL.md +++ b/skills/nfeio-php-sdk/SKILL.md @@ -1,6 +1,6 @@ --- name: nfeio-php-sdk -description: "NFE.io PHP SDK integration expert (Composer package: nfe/nfe, namespace Nfe\\). MUST trigger when: composer.json requires 'nfe/nfe' or code has `use Nfe\\Client`, `new Nfe\\Client(`, or references the Nfe\\ namespace; user mentions NFE.io, NFS-e, NF-e, NFC-e, CT-e, CFe-SAT, nota fiscal, nota fiscal eletronica, nota fiscal de servico, Brazilian invoice, fiscal document, electronic invoice Brazil, CNPJ lookup, CPF lookup, consulta CEP, service invoice, product invoice, consumer invoice, transportation invoice, tax calculation Brazilian taxes, SEFAZ, emissao de nota; user builds Brazilian electronic fiscal document automation or tax compliance in PHP/Laravel/Symfony/WHMCS/WooCommerce; user mentions polling for invoice status, async invoice processing, webhook signature validation, or certificate management for Brazilian fiscal documents. Covers all 17 SDK resources, async invoice creation via native union return types (instanceof), MANUAL polling (there is no createAndWait), method-aware retry (POST is NOT retried on 5xx — safety vs duplicate emission), idempotent NFS-e emission via externalId + findByExternalId reconciliation, typed ServiceInvoice fields (number/checkCode/borrower) with populated raw, the Nfe\\Exception hierarchy, 1-based pagination, string-byte downloads, the static Nfe\\Webhook signature helper, dual API keys (dataApiKey), CNPJ/CPF/CEP lookups, and tax calculation. Use this skill even if the user doesn't name the SDK -- if they build Brazilian fiscal document automation in PHP, it applies. Note: this is the PHP SDK; its idioms differ from the Node SDK (nfe-io) -- do NOT port Node patterns blindly." +description: "NFE.io PHP SDK (Composer nfe/nfe, namespace Nfe\\). MUST trigger when writing or reviewing PHP that integrates NFE.io: composer.json requires nfe/nfe or code references Nfe\\Client; or the user builds Brazilian fiscal-document automation in PHP (Laravel, Symfony, WHMCS, WooCommerce) — issuing or querying NFS-e/NF-e/NFC-e/CT-e/CFe-SAT, CNPJ/CPF/CEP lookups, tax calculation, webhook signature validation, certificate management, or invoice status polling. Applies even when the SDK isn't named. PHP idioms differ from the Node SDK (nfe-io)." --- # NFE.io PHP SDK Integration Guide