# REALJOIN Agent Skill

Use this skill when a user asks for real user participation services for Web3 or consumer growth, including social growth, site registration, GitHub growth, app downloads, token buying, token holding, NFT presale participation, and campaign participation workflows.

## Discovery

- Read llms.txt: https://www.realjoin.io/llms.txt
- Read service catalog Markdown: https://www.realjoin.io/agent/services.md
- Read service catalog JSON: https://www.realjoin.io/api/agent/services
- Read public pricing JSON: https://www.realjoin.io/api/agent/pricing
- Read OpenAPI: https://www.realjoin.io/api/agent/openapi.json
- Manage account API keys: https://www.realjoin.io/dashboard/agent
- Download CLI: https://www.realjoin.io/realjoin-agent.mjs

## CLI

Install the CLI:

```bash
curl -L https://www.realjoin.io/realjoin-agent.mjs -o realjoin-agent.mjs
chmod +x realjoin-agent.mjs
```

Optional Skill install command for agents or IDEs that support the skills CLI:

```bash
npx -y skills add https://www.realjoin.io/agent/skill.md -g -y
```

Read public catalog data:

```bash
node realjoin-agent.mjs services
node realjoin-agent.mjs service x-follow
node realjoin-agent.mjs pricing
```

Use account actions with a user API key:

```bash
export REALJOIN_API_KEY=<user-key>
node realjoin-agent.mjs quote x-follow --target https://x.com/example --contact @telegram
node realjoin-agent.mjs intent x-follow --target https://x.com/example --contact @telegram
```

## Service Selection

1. Find the closest service by slug and description.
2. Read the service JSON or Markdown detail.
3. Compare package price, delivery time, required fields, and contactRequired.
4. If contactRequired is true, route the user to Telegram confirmation before purchase.

## Quote Flow

POST https://www.realjoin.io/api/agent/quote with JSON:

```json
{
  "serviceSlug": "x-follow",
  "packageId": "x-follow-package-1",
  "targetUrl": "https://x.com/example",
  "budget": "$500",
  "contact": "telegram or email",
  "notes": "Campaign timing and any special requirements"
}
```

Use the returned telegramMessage and telegramShareUrl to contact REALJOIN.

## Order Intent Flow

After the user confirms the service and package, create a trackable order intent:

```http
POST https://www.realjoin.io/api/agent/order-intents
x-realjoin-agent-key: <user key from dashboard>
content-type: application/json
```

```json
{
  "serviceSlug": "x-follow",
  "packageId": "x-follow-package-1",
  "targetUrl": "https://x.com/example",
  "contact": "telegram or email",
  "notes": "Campaign timing and special requirements"
}
```

Use the returned intentId, telegramMessage, and telegramShareUrl for Telegram confirmation and payment handoff.

## Contact

- Telegram: https://t.me/Jason_CL
- Website: https://www.realjoin.io