Genkit skills: instalar competências de desenvolvimento do enquadramento por linguagem

Para quem

Este guia é para quem vai escrever aplicações Genkit com um agente e aceita escolher um diretório de competências por linguagem. O enquadramento Genkit está em

https://genkit.dev/

O repositório está em

https://github.com/genkit-ai/skills

Estas competências seguem a especificação Agent Skills, descrita em

https://agentskills.io/specification

O material existente desenvolve developing-genkit-js: desenvolver aplicações Genkit com Node.js e TypeScript. O ficheiro da competência está em

https://github.com/genkit-ai/skills/blob/main/skills/developing-genkit-js/SKILL.md

Há também um comando de instalação Go que aponta para developing-genkit-go. O material pede para apontar o ambiente do agente ao diretório de competência correspondente para ligar capacidades Genkit.

Serve quando a linguagem do repositório já está decidida e vai executar npx skills add. Não serve quem quer todas as linguagens de uma vez sem --skill. Não infira dos nomes de linguagem no título que competências sem comando de instalação já são instaláveis.

Primeira tentativa em 3 minutos

Siga só o caminho oficial recomendado de JavaScript/TypeScript.

Pré-condições: esta máquina consegue executar npx e pretende escrever Genkit com Node.js e TypeScript. Antes de executar, confirme que o projeto atual é onde a competência deve ser gravada.

Local de instalação: gravado pelo npx skills add; o material também diz para apontar o agente ao diretório de competência correspondente. O material não nomeia o pouso por defeito do npx; não complete um caminho que não aparece. Se o agente não encontrar a competência, aponte o ambiente a esse diretório como diz o texto oficial.

Copie e execute:

npx skills add genkit-ai/skills --skill developing-genkit-js

Sinal de sucesso: o comando termina normalmente e o agente consegue citar developing-genkit-js. Faça primeiro uma confirmação só de leitura: pergunte que ficheiros mudaria para acrescentar uma capacidade Genkit mínima neste repositório, sem ainda gravar no disco. Se apontar a competência e nomear ficheiros propostos, está carregada.

Escrever código de aplicação muda o repositório. Não autorize uma gravação real até confirmar caminhos e risco de sobrescrita.

Casos de uso

Caso 1: desenvolver uma aplicação Genkit em TypeScript. Corresponde a developing-genkit-js. Serve um projeto Node.js existente ou um projeto TS novo. Peça primeiro um plano e depois permita gravar. Em sucesso, as alterações seguem o uso do enquadramento dado por essa competência. O material não expande API concretas nem modelos de diretório.

Caso 2: instalar a competência correspondente para um projeto Go. Corresponde a npx skills add genkit-ai/skills --skill developing-genkit-go. Serve quando a linguagem principal é Go. Instale primeiro e peça só como mudaria o código Go, ainda sem gravar ficheiros. Sinal de sucesso: carrega developing-genkit-go e não usa por engano a competência JS. Além deste comando, o material não expande passos do lado Go.

Limites de uso

Não misture os dois valores --skill como uma só instalação. Não invente nomes de competência que não aparecem. O título da página também menciona Dart, mas o material existente não tem comando de instalação Dart; não reutilize os comandos JS ou Go.

Não nomeia clientes obrigatórios. Não assuma que as capacidades estão ligadas até apontar o agente ao diretório de competência. Pré-visualize antes de escrever código. Mais pormenor no repositório oficial:

https://github.com/genkit-ai/skills