Skip to content

wmendes/trustless-work-skill

Repository files navigation

Trustless Work Skill

Agent Skills Compatible

Comprehensive Claude Code skill for integrating Trustless Work Escrow-as-a-Service (EaaS).

Overview

Trustless Work is an Escrow-as-a-Service platform built on Stellar (Soroban) for stablecoin escrow. This skill provides complete integration guidance for building non-custodial escrow flows with milestones, approvals, and disputes.

Platform Compatibility

This skill uses the open Agent Skills standard and works with:

  • Claude Code - Install via claude install <repo-url> or place in ~/.claude/skills/
  • OpenAI Codex CLI - Install via codex install <repo-url> or place in .agents/skills/
  • Google Gemini CLI - Install via gemini install skill <repo-url> or place in .agents/skills/
  • Cursor - Place in .cursor/skills/ directory
  • GitHub Copilot (VS Code) - Enable agent skills
  • Windsurf, Cline, Roo Code, and other compatible agents

Installation

Claude Code:

claude install https://github.com/wmendes/trustless-work-skill

OpenAI Codex CLI / Gemini CLI:

cd ~/.agents/skills
git clone https://github.com/wmendes/trustless-work-skill

Cursor:

cd .cursor/skills
git clone https://github.com/wmendes/trustless-work-skill

Skill Structure

.claude/skills/trustless-work/
├── SKILL.md                 # Main skill file with quick start
├── README.md                # This file
├── escrow-types.md          # Single vs Multi-Release comparison
├── roles-reference.md       # Complete role permissions guide
├── lifecycle-guide.md       # Detailed lifecycle phases
├── api-reference.md         # REST API documentation
├── examples.md              # Complete integration examples
└── stellar-guide.md         # Stellar network integration

What This Skill Covers

Core Concepts

  • Escrow Types: Single-Release vs Multi-Release
  • Roles System: 6 roles (Service Provider, Approver, Release Signer, Dispute Resolver, Receiver, Platform Address)
  • Escrow Lifecycle: Initiation → Funding → Milestone Updates → Approval → Release → (Dispute Resolution)
  • Stellar Integration: Trustlines, wallets, USDC on Stellar

Technical Integration

  • REST API: Complete endpoint reference
  • React SDK: Hooks and components
  • JavaScript/TypeScript Examples: Production-ready code
  • Wallet Integration: Freighter and others

Use Cases

  • Freelance/gig marketplaces
  • DAO grant programs
  • Security deposits (rentals, bookings)
  • Crowdfunding platforms
  • E-commerce escrow
  • B2B payment automation

Using This Skill

Invoke with Claude Code

# General help
/trustless-work

# Specific use case
/trustless-work create a freelance marketplace escrow

# With escrow type
/trustless-work single-release
/trustless-work multi-release

When Claude Uses This Skill

Claude will automatically use this skill when you:

  • Ask about implementing escrow flows
  • Mention marketplace payments, milestones, or disputes
  • Want to integrate stablecoin payments with approval logic
  • Need non-custodial payment infrastructure
  • Ask about Trustless Work specifically

Quick Reference

Key Resources

USDC on Stellar

Issuer: GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5

Fees

  • Protocol Fee: 0.3% (automatic)
  • Platform Fee: Configurable (you set it)

Networks

Supporting Files

1. escrow-types.md

Complete comparison of Single-Release vs Multi-Release escrows:

  • Structure differences
  • Use case recommendations
  • JSON examples
  • Decision guide

2. roles-reference.md

Full role permissions and interaction patterns:

  • What each role can do
  • Common role assignment patterns
  • Multi-role addresses
  • Security considerations

3. lifecycle-guide.md

Step-by-step guide through all lifecycle phases:

  • Initiation (define schema)
  • Funding (lock assets)
  • Milestone Updates (mark progress)
  • Approval (validate work)
  • Release (execute payout)
  • Dispute Resolution (handle conflicts)

4. api-reference.md

Complete REST API documentation:

  • All endpoints with examples
  • Authentication
  • Request/response formats
  • Error codes
  • Rate limits
  • SDK usage

5. examples.md

Production-ready code examples:

  • Freelance marketplace
  • DAO grant program
  • Security deposit (rental)
  • Crowdfunding platform
  • E-commerce escrow
  • React components

6. stellar-guide.md

Stellar network integration guide:

  • Why Stellar for escrow
  • Trustline management
  • Wallet integration (Freighter)
  • Sending USDC
  • Testing on Testnet
  • Security best practices

Example Queries

Creating escrows:

  • "How do I create a single-release escrow for a freelance job?"
  • "Help me build a multi-release escrow for a grant program"
  • "What's the difference between single and multi-release?"

Understanding roles:

  • "What can each role do in an escrow?"
  • "How should I assign roles for a marketplace?"
  • "Can one address have multiple roles?"

Lifecycle management:

  • "Walk me through the complete escrow lifecycle"
  • "How does milestone approval work?"
  • "What happens during dispute resolution?"

API integration:

  • "Show me how to fund an escrow with the API"
  • "How do I update milestone status?"
  • "Give me a complete freelance escrow example"

Stellar/USDC:

  • "How do trustlines work on Stellar?"
  • "How do I set up USDC for my users?"
  • "What wallets work with Trustless Work?"

Testing

Always test on Testnet first:

  1. Create testnet account via https://friendbot.stellar.org
  2. Add USDC trustline
  3. Get testnet USDC
  4. Create test escrow on dev.api.trustlesswork.com
  5. Walk through full lifecycle
  6. Verify on https://viewer.trustlesswork.com

Security Notes

  • All role addresses must have the trustline enabled
  • Never commit private keys to Git
  • Use hardware wallets for platform accounts
  • Test with small amounts on Mainnet first
  • Set up multi-signature for critical roles

License & Attribution

This skill is based on the official Trustless Work documentation.

For the most up-to-date information, always refer to:

Support

For Trustless Work support:

Updates

This skill was created on 2026-03-11 based on Trustless Work documentation version English.

Check the original PDF for the latest updates and features.

About

Trustless Work skill package for AI agents

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors