# Habilidade

## @trustless-work/skill

[![skills.sh](https://skills.sh/b/trustless-work/trustless-work-dev-skill)](https://skills.sh/trustless-work/trustless-work-dev-skill)

Instale habilidades de IA e verifique integrações do Trustless Work diretamente do seu terminal usando o Skills.sh.

***

## Instalação

Nenhuma instalação global é necessária.

Instale a skill diretamente usando:

```
npx skills add trustless-work/trustless-work-dev-skill
```

Isso instala automaticamente a skill do Trustless Work no seu agente de IA compatível.

***

## Skills.sh

A skill do Trustless Work é distribuída por meio do Skills.sh:

* Registro de Skills: <https://www.skills.sh/trustless-work>

O Skills.sh oferece um ecossistema padronizado para instalar skills reutilizáveis de agentes de IA em diferentes assistentes de programação.

***

## Por que as Skills são úteis?

### Sem uma skill

Você explica repetidamente os mesmos detalhes de integração em toda conversa:

> "Trustless Work é um protocolo de escrow na Stellar..."

> "O endpoint de deploy retorna uma transação XDR não assinada..."

> "O usuário deve assiná-la com sua carteira..."

> "A trustline usa o endereço do emissor, não o endereço do contrato..."

Isso desperdiça tempo e muitas vezes leva a erros de integração.

***

### Com uma skill

A IA já entende todo esse contexto.

Você pode perguntar imediatamente coisas como:

> "Gere o fluxo de implantação do escrow para meu marketplace de trabalho freelancer."

E o assistente pode produzir código preciso, natural e pronto para produção desde o início.

Skills são especialmente úteis para:

* Onboarding mais rápido para novos desenvolvedores
* Redução de erros de integração
* Manutenção da consistência entre projetos
* Manter assistentes de IA atualizados com as mudanças mais recentes de SDK/API

***

## A Skill Trustless Work

A Skill Trustless Work instala uma base de conhecimento curada para criar integrações de escrow na Stellar usando o Trustless Work.

Ela ensina seu assistente de IA a integrar corretamente:

* API REST do Trustless Work
* `@trustless-work/escrow`
* `@trustless-work/blocks`

A skill inclui orientação de arquitetura, referências de API, padrões de integração, fluxos de ciclo de vida e melhores práticas de produção.

***

## O que a Skill ensina à IA

A skill ajuda a IA a entender detalhes críticos de implementação, como:

* Toda operação de escrita retorna uma transação XDR não assinada que deve ser assinada pela carteira correta
* Os campos de trustline exigem o endereço do emissor da Stellar (`G...`) — não o endereço do contrato (`C...`)
* As trustlines devem ser adicionadas diretamente da carteira do usuário
* Ordem correta de aninhamento dos provedores: \<QueryClientProvider> \<TrustlessWorkConfig> \<WalletProvider>
* As aprovações de marcos são irreversíveis on-chain
* Limites de taxa da API e padrões de repetição
* Fluxos corretos de assinatura de XDR
* Padrões recomendados de arquitetura de frontend
* Checklists de integração para produção

***

## Agentes de IA compatíveis

Atualmente compatíveis:

* Claude Code
* Gemini CLI

***

## Mantendo a Skill Atualizada

Para atualizar as skills instaladas para a versão mais recente:

```
npx skills update
```

Isso atualiza todos os arquivos das skills instaladas e garante que seu assistente de IA permaneça alinhado com as APIs e SDKs mais recentes do Trustless Work.

***

## Verificando Sua Integração

A skill do Trustless Work também inclui recursos de verificação de integração.

O verificador analisa estaticamente sua base de código e detecta erros comuns de integração antes da implantação.

Ele pode validar:

### Integrações com API REST

* Uso da chave de API
* Configuração de variáveis de ambiente
* Fluxos corretos de assinatura de XDR
* URLs base adequadas
* Tratamento de limite de taxa

### Integrações de SDK (`@trustless-work/escrow`)

* Configuração do provedor
* Integração da carteira
* Configuração do QueryClient
* Tratamento de engagement
* Requisitos de componentes cliente

### Integrações com Blocks (`@trustless-work/blocks`)

* Instalação de dependências
* Ordem de aninhamento dos provedores
* Configuração da carteira
* Padrões de UX de aprovação
* Fluxos de orientação de trustline


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trustlesswork.com/trustless-work/v1-pt/ia/habilidade.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
