# Skill

## @trustless-work/skill

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

Install AI skills and verify Trustless Work integrations directly from your terminal using Skills.sh.

***

## Installation

No global installation required.

Install the skill directly using:

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

This automatically installs the Trustless Work skill into your supported AI agent.

***

## Skills.sh

The Trustless Work skill is distributed through Skills.sh:

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

Skills.sh provides a standardized ecosystem for installing reusable AI agent skills across different coding assistants.

***

## Why are Skills Useful?

### Without a skill

You repeatedly explain the same integration details in every conversation:

> "Trustless Work is an escrow protocol on Stellar..."

> "The deploy endpoint returns an unsigned XDR transaction..."

> "The user must sign it with their wallet..."

> "The trustline uses the issuer address, not the contract address..."

This wastes time and often leads to integration mistakes.

***

### With a skill

The AI already understands all of this context.

You can immediately ask things like:

> "Generate the escrow deployment flow for my freelance marketplace."

And the assistant can produce accurate, idiomatic, production-ready code from the start.

Skills are especially useful for:

* Faster onboarding for new developers
* Reducing integration mistakes
* Maintaining consistency across projects
* Keeping AI assistants updated with the latest SDK/API changes

***

## The Trustless Work Skill

The Trustless Work Skill installs a curated knowledge base for building escrow integrations on Stellar using Trustless Work.

It teaches your AI assistant how to correctly integrate:

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

The skill includes architecture guidance, API references, integration patterns, lifecycle flows, and production best practices.

***

## What the Skill Teaches the AI

The skill helps the AI understand critical implementation details such as:

* Every write operation returns an unsigned XDR transaction that must be signed by the correct wallet
* Trustline fields require the Stellar issuer address (`G...`) — not the contract address (`C...`)
* Trustlines must be added directly from the user's wallet
* Correct provider nesting order: \<QueryClientProvider> \<TrustlessWorkConfig> \<WalletProvider>
* Milestone approvals are irreversible on-chain
* API rate limits and retry patterns
* Correct XDR signing workflows
* Recommended frontend architecture patterns
* Production integration checklists

***

## Supported AI Agents

Currently supported:

* Claude Code
* Gemini CLI

***

## Keeping the Skill Updated

To update installed skills to the latest version:

```
npx skills update
```

This refreshes all installed skill files and ensures your AI assistant stays aligned with the latest Trustless Work APIs and SDKs.

***

## Verifying Your Integration

The Trustless Work skill also includes integration verification capabilities.

The verifier statically analyzes your codebase and detects common integration mistakes before deployment.

It can validate:

### REST API integrations

* API key usage
* Environment variable configuration
* Correct XDR signing flows
* Proper base URLs
* Rate limit handling

### SDK integrations (`@trustless-work/escrow`)

* Provider setup
* Wallet integration
* QueryClient configuration
* Engagement handling
* Client component requirements

### Blocks integrations (`@trustless-work/blocks`)

* Dependency installation
* Provider nesting order
* Wallet configuration
* Approval UX patterns
* Trustline guidance flows


---

# 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/ai/skill.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.
