Skills

Ligue o InsForge por três caminhos: CLI, SDK e OpenRouter

Para quem quer que um agente faça aplicações backend com InsForge. Instale primeiro o skills add oficial. O backend vai por skills CLI, os clientes pelo SDK, as funções IA novas exigem primeiro ai setup; o diagnóstico localiza e não dá reparações.

Official source · insforge-skills

Install

npx -y skills add insforge/insforge-skills

Para quem

Use este conjunto quando quiser que um agente IA construa aplicações com InsForge, um Backend-as-a-Service. A fonte escreve que ajudam os programadores a construir aplicações através de um agente. Página de produto:

https://insforge.dev/

Repositório de skills:

https://github.com/insforge/insforge-skills

A fonte dá uma distinção-chave: a infraestrutura backend usa skills CLI; a maioria das integrações de cliente usa @insforge/sdk; as funções IA novas usam a OpenRouter API, as chaves configuram-se com npx -y @insforge/cli ai setup. Sem intenção de executar a instalação oficial nesta máquina, ou sem aceitar escrever ficheiros de skill, não continue ainda.

Há também uma skill de diagnóstico: orienta a execução de comandos de diagnóstico para localizar problemas e não dá sugestões de reparação. Não espere que altere o código diretamente. A fonte não alarga as capacidades backend a um inventário de funções; não invente operações de negócio concretas. Quem só quer clicar no InsForge no browser e não está pronto a deixar um agente cablar via skills CLI ou SDK não precisa de começar aqui.

Conclua a primeira tentativa em 3 minutos

Abra primeiro o repositório oficial e verifique:

https://github.com/insforge/insforge-skills

A instalação recomendada é só esta. Instalar skills altera o diretório local de skills; antes de executar, confirme que quer deixar aqui as skills InsForge:

npx -y skills add insforge/insforge-skills

Sinal de sucesso: este comando termina normalmente. A fonte não escreve um caminho de aterragem; não invente um diretório. A fonte também tem instalações de marketplace de plugins voltadas a certos clientes; na primeira vez, não as ponha ao lado como segundo caminho principal nem aplique comandos de marketplace a ambientes não explicados.

Na primeira vez no agente, só verifique; não execute ainda ai setup nem invente subcomandos de diagnóstico. Peça ao agente que recite a distinção-chave: infraestrutura backend por skills CLI, integração de cliente sobretudo @insforge/sdk, funções IA novas por OpenRouter, e o diagnóstico só localiza problemas sem dar sugestões de reparação. O ponto de observação: consegue dizer estes três caminhos com clareza, não configurou chaves e não executou reparações ausentes.

ai setup configura uma chave API e é um efeito secundário. Execute-o só quando confirmar que quer uma chave OpenRouter para funções IA novas:

npx -y @insforge/cli ai setup

A fonte não escreve um nome de campo de chave; não escreva uma chave de preenchimento. Na primeira vez, não trate a skill de diagnóstico como reparação automática. Se o agente propuser executar um comando de diagnóstico que nunca apareceu, faça-o primeiro dizer que a fonte só escreve orientação para localizar e não dá um inventário de comandos, depois pare.

Casos de uso

Caso 1: Primeiro instale as skills pela entrada oficial. Num agente que possa receber skills add, depois de aceitar escrever ficheiros de skill, só execute npx -y skills add insforge/insforge-skills. Serve a quem só quer ligar skills InsForge a um agente e ainda não está pronto a configurar chaves. Sinal de sucesso: o comando de instalação termina normalmente e o agente consegue dizer que é para InsForge Backend-as-a-Service. Se a instalação falhar, pare; não passe ao caminho de marketplace como caminho principal de reserva.

Caso 2: Primeiro verifique a cablagem e depois decida se configura uma chave IA. Depois de instalar, faça o agente recitar: a infraestrutura backend usa skills CLI, a maioria das integrações de cliente usa @insforge/sdk, as funções IA novas usam a OpenRouter API, as chaves configuram-se com npx -y @insforge/cli ai setup; a skill de diagnóstico só localiza problemas e não dá sugestões de reparação. Serve a quem receia que o agente saia logo para a rede ou altere o backend ao acaso. Sinal de sucesso: a distinção dos três caminhos e o limite do diagnóstico ficam claros. Antes de executar ai setup a sério, confirme que quer deixar a chave. A fonte não dá um inventário de comandos de diagnóstico; não o invente. Não trate «ajudar os programadores a construir aplicações» como se já desse passos concretos de criação ou migração.

Limites de uso

O caminho principal é só npx -y skills add insforge/insforge-skills. A fonte também escreveu instalação de marketplace de plugins; isso não é o caminho principal da primeira tentativa. Não as ponha lado a lado. Página de produto:

https://insforge.dev/

A distinção dos três caminhos tem de se manter: infraestrutura backend por skills CLI, integração de cliente sobretudo @insforge/sdk, funções IA novas por OpenRouter e terminar ai setup primeiro. A skill de diagnóstico só orienta a localização e não dá sugestões de reparação. A fonte não alarga um inventário concreto de operações backend e não escreve diretório de skills, campos de chave nem passos de desinstalação. Não complete ações de negócio, comandos de reparação nem lista de clientes não escritos. O sucesso da primeira vez é só a instalação acabada e o agente a recitar a distinção; antes de configurar uma chave ou executar diagnóstico confirme os efeitos secundários. Se o agente começar a dar passos de reparação, pare primeiro e volte a «só localizar problemas». Não finja que o OpenRouter já está ligado para funções IA novas antes de ai setup acabar. Não contorne @insforge/sdk na integração de cliente nem invente outro nome de SDK. Também não mude a infraestrutura backend para um instalador que nunca apareceu. A evidência não escreve caminhos de desinstalação ou atualização; não invente comandos. O sucesso da primeira vez só exige a instalação acabada, mais o agente a dizer com clareza os três caminhos skills CLI, SDK e OpenRouter.