primocode 9.8.0-beta.2 → 9.8.0-beta.21

package/skills/criar-skill/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Anthropic, PBC.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/skills/criar-skill/SKILL.md

@@ -0,0 +1,49 @@
+---
+nome: Criar skill
+descricao: transformar um jeito de trabalhar numa skill do PrimoCode — cabeçalho certo, gatilho preciso, texto curto e testado
+quando: criar skill, criar uma skill, cria uma skill, crie uma skill, nova skill, new skill, escrever uma skill, skill.md, minha skill, transforma isso em skill, vira skill, virar skill, melhorar a skill, a skill não dispara
+autor: adaptado de "skill-creator" (Anthropic, anthropics/skills, Apache-2.0 — ver LICENSE.txt); resumido, traduzido e ajustado ao formato do PrimoCode
+---
+Uma skill do PrimoCode é um arquivo `SKILL.md`: um cabeçalho e um texto que vai
+para o modelo quando o pedido bate. É só texto — nada de script, nada que rode.
+
+**1. Entenda o que a pessoa quer** (se a conversa já mostrou o jeito dela de
+trabalhar, tire as respostas dali e só confirme):
+- o que a skill faz o agente fazer diferente;
+- em que pedidos ela deve entrar — e em quais NÃO;
+- como fica o resultado quando dá certo.
+
+**2. O cabeçalho**
+```
+---
+nome: Revisão com lint
+descricao: roda o lint e corrige antes de dizer que terminou
+quando: lint, eslint, terminar, entregar
+autor: você
+---
+```
+O `quando:` decide tudo. São palavras ou expressões separadas por vírgula,
+casadas por PALAVRA INTEIRA no pedido (acento e maiúscula não importam). Sem uma
+palavra que bata, a skill nunca entra. Palavra comum demais ("fazer", "tudo",
+"bem") faz ela entrar em conversa que não tem nada a ver.
+
+**3. O corpo**
+- CURTO: até uns 2.500 caracteres. Cada pedido leva no máximo 6.000 caracteres
+  de skills somadas; a longa demais fica de fora quando outra também bate.
+- No imperativo, e explicando o PORQUÊ ("rode o lint: erro de lint quebra o
+  deploy") — regra com motivo é seguida em caso que ela não previu; MAIÚSCULA
+  sem motivo, não.
+- Um exemplo do resultado esperado vale mais que três parágrafos.
+- Nada que a pessoa estranharia se lesse: nada de esconder ação, mandar dado
+  para fora ou mexer onde ninguém pediu.
+
+**4. Teste antes de dar por pronta**
+- Escreva 2 ou 3 pedidos de verdade, do jeito que a pessoa fala. Cada um tem de
+  conter uma palavra do `quando:`; "oi, tudo bem?" não pode conter nenhuma.
+- Faça a tarefa com a skill e compare com o que sairia sem ela. Não mudou
+  nada? O texto está genérico demais — reescreva.
+- Ajuste com o que a pessoa disser, e teste de novo.
+
+**5. Instale.** Salve em `<pasta>/SKILL.md` e diga à pessoa para rodar
+`/install-skill <caminho da pasta>`. Ou ela cria direto pelo `/marketplace` →
+"New Skill". Com `/skills` ela vê a lista e confirma que a nova está ligada.

package/skills/depurar-de-verdade/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Pocock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/depurar-de-verdade/SKILL.md

@@ -2,23 +2,29 @@
 nome: Depurar de verdade
 descricao: achar a causa do defeito em vez de tentar consertos no escuro
 quando: bug, erro, defeito, quebrado, não funciona, nao funciona, falha, corrigir, consertar, debug, depurar, travando
-autor: PrimoCode
+autor: PrimoCode; com ideias de "diagnosing-bugs" (Matt Pocock, mattpocock/skills, MIT — ver LICENSE.txt)
 ---
 Não conserte antes de reproduzir. Conserto sem reprodução é chute, e chute que
 "parece ter resolvido" esconde o defeito para ele voltar depois.
 
 **A ordem**:
 
-1. **Reproduza.** Qual entrada, qual passo, o que aconteceu, o que deveria ter
-   acontecido. Se não reproduz, o defeito não está onde você acha.
+1. **Reproduza, com UM comando.** Qual entrada, qual passo, o que aconteceu, o
+   que deveria ter acontecido — e um comando (teste, `curl`, script) que você
+   já rodou e que FALHA neste defeito, com o sintoma que a pessoa viu. Esse é o
+   trabalho mais importante: com ele o resto é mecânico. Defeito que só às
+   vezes aparece: rode 50 vezes até a falha aparecer o bastante para estudar.
+   Se não reproduz, o defeito não está onde você acha.
 2. **Leia o erro inteiro.** A primeira linha diz o sintoma; a pilha diz o
    lugar. A linha que importa costuma ser a primeira que é do PROJETO, não da
    biblioteca.
 3. **Isole.** Metade de cada vez: o dado está errado ao entrar ou ao sair?
    Antes ou depois desta função? Cada medição corta o espaço de busca pela
    metade.
-4. **Entenda a causa.** "Adicionei um try/catch e parou de aparecer" não é
-   causa, é mordaça.
+4. **Entenda a causa.** Liste de 3 a 5 hipóteses, da mais provável para a
+   menos, cada uma com a sua previsão ("se for X, mudar Y faz sumir") — e teste
+   uma de cada vez. "Adicionei um try/catch e parou de aparecer" não é causa, é
+   mordaça.
 5. **Conserte** o menor pedaço possível, e **prove** rodando a reprodução do
    passo 1.
 
@@ -27,3 +33,6 @@ depois veja-o passar. Assim o defeito não volta sem ninguém ver.
 
 Quando a suspeita for de ambiente (versão, variável, caminho), confira em vez
 de supor: rode `--version`, imprima a variável, liste a pasta.
+
+Log de depuração leva uma marca única (`[DEPURA-7f3]`): no fim, procure a marca e
+apague todos. E diga qual hipótese era a certa — é o que ensina quem vier depois.

package/skills/design-de-verdade/LICENSE.txt

@@ -0,0 +1,177 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/skills/design-de-verdade/SKILL.md

@@ -0,0 +1,42 @@
+---
+nome: Design de verdade
+descricao: cada site com identidade própria, e não a cara de "feito por IA"
+quando: landing, landing page, site, página, pagina, design, interface, tela, layout, visual, bonito, bonita, identidade, marca
+autor: adaptado de "frontend-design" (Anthropic, anthropics/skills, Apache-2.0 — ver LICENSE.txt); resumido e traduzido pelo PrimoCode
+---
+Trabalhe como o diretor de arte de um estúdio conhecido por dar a cada cliente uma identidade que
+ninguém confunde. O cliente já recusou propostas com cara de modelo pronto.
+
+**Não existe modelo.** Toda página começa do zero, e nenhuma sai com a estrutura da anterior.
+
+**Comece pelo assunto.** O ramo, os materiais e o vocabulário do negócio são de onde vem a escolha
+visual. Um brinquedo para meninas de 8 anos e um painel de analista financeiro não se parecem em nada.
+Use o conteúdo real do pedido em tudo, e não texto genérico.
+
+**Planeje antes de escrever código**, em poucas linhas:
+- cor: 4 a 6 cores com nome e hex;
+- tipo: 1 ou 2 fontes escolhidas para ESTE negócio (não as de sempre), com papéis claros;
+- layout: a ideia em uma frase, e se o conteúdo alinha à esquerda ou ao centro;
+- o único elemento memorável da página.
+Depois releia o plano. O que você faria igual para qualquer página parecida, troque, e diga o que trocou.
+
+**As marcas de página gerada por IA.** Evite estas, a não ser que o pedido peça:
+- fundo creme com serifa e destaque terracota; ou fundo quase preto com um único destaque neon;
+- conteúdo picado em cards idênticos, com o mesmo arredondado e a mesma sombra em tudo;
+- rótulo em CAIXA ALTA espaçada acima de todo título, e textos "A · B · C" com ponto no meio;
+- uma única palavra do título em itálico ou em outra cor;
+- números 01 / 02 / 03 quando o conteúdo não é uma sequência de verdade;
+- a mesma entrada com fade subindo em toda seção, e hover em todo card;
+- uma seta "→" em todo botão.
+
+**Contenção.** Gaste a ousadia num lugar só: um elemento marcante, o resto calmo. Antes de entregar,
+tire um enfeite. Movimento só num momento orquestrado (a abertura, por exemplo) ou em resposta a uma
+ação da pessoa.
+
+**Piso de qualidade, sem anunciar:** funciona no celular, foco de teclado visível, respeita "reduzir
+movimento", contraste acessível, linhas de texto com menos de 80 caracteres.
+
+**Texto é design.** Escreva do ponto de vista de quem usa, com palavras simples. O botão diz o que
+acontece ("Agendar horário", e não "Enviar"). Específico vence esperto. Voz ativa, sem enrolação.
+
+**Confira com os olhos:** abra a página, tire um print e critique o que viu antes de dizer que terminou.

package/skills/documento-word/SKILL.md

@@ -0,0 +1,57 @@
+---
+nome: Documento Word
+descricao: gerar e editar arquivo .docx de verdade (contrato, relatório, currículo) com python-docx, e conferir antes de entregar
+quando: word, docx, documento word, arquivo do word, em word, no word, currículo, contrato, ofício, relatório em word
+autor: PrimoCode
+---
+Um .docx é um pacote de XML. Não escreva esse XML à mão: use `python-docx`.
+
+**1. Prepare.** `python3 --version`. Instale num ambiente só do projeto — o
+Python do sistema costuma recusar `pip install` direto:
+`python3 -m venv .venv && .venv/bin/pip install python-docx`, e rode os scripts
+com `.venv/bin/python`. Tem `pandoc`? Texto simples em Markdown vira .docx com
+`pandoc texto.md -o saida.docx`.
+
+**2. Escreva um script** (`gerar_documento.py`), não comandos soltos: dá para
+rodar de novo depois de cada ajuste.
+```python
+from docx import Document
+from docx.shared import Pt, Cm
+doc = Document()
+s = doc.sections[0]
+s.page_width, s.page_height = Cm(21), Cm(29.7)          # A4
+s.left_margin = s.right_margin = Cm(2.5)
+doc.styles['Normal'].font.name = 'Calibri'
+doc.styles['Normal'].font.size = Pt(11)
+doc.add_heading('Contrato de prestação de serviço', level=1)
+doc.add_paragraph('Texto do parágrafo.')
+t = doc.add_table(rows=1, cols=3, style='Table Grid')
+doc.save('contrato.docx')
+```
+
+**3. Estrutura com ESTILO, não com negrito.** Título é `add_heading` (Título 1,
+2, 3). Assim o Word monta o sumário e o painel de navegação sozinho. Negrito
+manual num parágrafo comum parece título, mas não é.
+- Lista: `style='List Bullet'` ou `'List Number'`.
+- Quebra de página: `doc.add_page_break()`.
+- Imagem: `doc.add_picture('logo.png', width=Cm(4))`.
+- Fonte que a outra pessoa tem (Calibri, Arial, Georgia, Times New Roman). Fonte
+  que falta na máquina dela é trocada e o documento muda de tamanho.
+- Número de página precisa de um campo PAGE no rodapé (um trecho de XML
+  `fldSimple`); só coloque se pedirem.
+
+**4. Editar um .docx que já existe:** `Document('original.docx')`, e salve com
+OUTRO nome — o original fica intacto. O texto de um parágrafo vem quebrado em
+pedaços (`runs`) com formatação diferente; troque dentro do pedaço certo para
+não perder negrito e cor.
+
+**5. Confira antes de entregar.**
+- Reabra com o próprio `python-docx` e imprima os títulos e a contagem de
+  parágrafos e tabelas: prova que o arquivo abre e tem o conteúdo.
+- Tem LibreOffice (`soffice`)? `soffice --headless --convert-to pdf
+  contrato.docx` e abra o PDF para OLHAR as páginas: tabela estourando a
+  margem e título órfão no pé da página só aparecem assim.
+- Procure texto de exemplo esquecido ("Lorem", "[NOME]", "XXX").
+
+Contrato e documento legal: escreva o que a pessoa pediu, e diga em uma linha
+que vale a leitura de um advogado antes de assinar.

package/skills/interface-revisada/SKILL.md

@@ -0,0 +1,47 @@
+---
+nome: Interface revisada
+descricao: a lista de conferência de uma interface web — clique, formulário, estados, celular, texto, tema e movimento
+quando: revisa a interface, revisar a interface, revise a interface, revisão de interface, revisão de ux, ux, usabilidade, revisa a tela, revisa o layout, formulário, dark mode, modo escuro, responsivo, no celular
+autor: PrimoCode
+---
+Revise com a tela FUNCIONANDO no navegador, não só lendo o código. Para cada
+problema diga onde está (arquivo:linha ou a tela), o que acontece com quem usa e
+a correção. Primeiro o que impede alguém de usar; acabamento vai no fim.
+
+**Clique e toque**
+- O que é clicável é `button` ou `a`, com hover, estado pressionado e foco
+  visível (`:focus-visible`).
+- Alvo de toque de pelo menos 44×44px. Nada importante escondido só no hover.
+- Ação que demora mostra que está trabalhando e não pode ser enviada duas vezes.
+- Ação que apaga pede confirmação ou oferece desfazer.
+- O endereço guarda o estado (aba, filtro, página): o voltar do navegador e o
+  link compartilhado levam ao mesmo lugar.
+
+**Formulário**
+- Todo campo tem `label` ligado a ele. Placeholder não é label.
+- `type`, `inputmode` e `autocomplete` certos (email, tel, one-time-code): o
+  teclado do celular muda e o preenchimento automático funciona.
+- Nunca bloqueie colar. Enter envia.
+- O erro aparece ao lado do campo, em texto, dizendo como resolver; o foco vai
+  para o primeiro erro, e o que a pessoa digitou continua lá.
+
+**Os quatro estados de toda tela**: carregando (esqueleto do tamanho do conteúdo,
+sem a tela pular), vazio (o que fazer agora), erro (o que houve e como tentar de
+novo) e cheio (texto longo quebra ou termina em `…`; mil itens não travam).
+
+**Layout**
+- De 360px a 1440px sem rolagem para o lado; respeita a área segura do celular
+  (`env(safe-area-inset-bottom)`).
+- Imagem com `width`/`height` ou `aspect-ratio`, para a página não pular.
+- Número em coluna com `tabular-nums`; título com `text-wrap: balance`.
+
+**Texto**: o botão diz o que acontece ("Salvar endereço", não "OK"). Data e
+dinheiro no jeito brasileiro: `Intl` com `'pt-BR'`, `R$ 1.234,56`.
+
+**Tema e movimento**: modo escuro com `color-scheme: dark` (campo e barra de
+rolagem acompanham) e contraste de 4.5:1 nos dois temas. Animação só em
+`transform` e `opacity`, curta (150 a 300ms) e desligada em
+`prefers-reduced-motion`. Nunca `transition: all`.
+
+**Feche com a contagem**: quantos impedem o uso, quantos atrapalham, quantos são
+acabamento. E conserte nessa mesma ordem.