# Send Splitwise to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "splitwise",
    "name": "Splitwise",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/richieforeman/splitwise",
    "canonicalUrl": "https://clawhub.ai/richieforeman/splitwise",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/splitwise",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=splitwise",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/api.md",
      "scripts/add_expense.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "splitwise",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T10:07:28.587Z",
      "expiresAt": "2026-05-08T10:07:28.587Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=splitwise",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=splitwise",
        "contentDisposition": "attachment; filename=\"splitwise-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "splitwise"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/splitwise"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/splitwise",
    "downloadUrl": "https://openagent3.xyz/downloads/splitwise",
    "agentUrl": "https://openagent3.xyz/skills/splitwise/agent",
    "manifestUrl": "https://openagent3.xyz/skills/splitwise/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/splitwise/agent.md"
  }
}
```
## Documentation

### Splitwise Skill

This skill allows an agent to interact with the Splitwise API to automate shared expenses.

### Requirements

SPLITWISE_API_KEY: A Long-lived User Token obtained from the Splitwise Developer Console.

### External Endpoints

URLPurposeData Senthttps://secure.splitwise.com/api/v3.0/create_expenseCreate a new expenseCost, description, user IDs, shares, and group ID.

### Security & Privacy

Data Outbound: This skill sends expense details (cost, description, user IDs) to the Splitwise API.
Credentials: Your SPLITWISE_API_KEY is sent in the Authorization header to Splitwise. It never leaves the machine except to communicate with the official Splitwise API.
Input: User input for cost and description is handled safely by the Python urllib.request and argparse libraries.

### Logging an Expense

The primary script handles creating a 50/50 split between two users.

python3 {baseDir}/scripts/add_expense.py \\
  --cost "10.00" \\
  --desc "Lunch" \\
  --payer_id "12345" \\
  --other_id "67890" \\
  --via "whisker"

### Parameters

--cost: Total amount (e.g., "45.00")
--desc: Brief description of the expense.
--payer_id: The Splitwise User ID of the person who paid.
--other_id: The Splitwise User ID of the person being split with.
--group_id: (Optional) The ID of a specific Splitwise group.
--via: (Optional) Appends "(via name)" to the description.

### Setup for Agents

Create a Splitwise App at https://secure.splitwise.com/apps.
Generate a "Long-lived User Token".
Store it as SPLITWISE_API_KEY.
Use the API to find your User IDs and Group IDs.

### Model Invocation Note

This skill is designed for autonomous invocation by AI models. The model will automatically determine when to call these tools based on user requests (e.g., "split the $20 lunch with Nancy").

### Trust Statement

By using this skill, data is sent to Splitwise. Only install this skill if you trust Splitwise with your expense data.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: richieforeman
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T10:07:28.587Z
- Expires at: 2026-05-08T10:07:28.587Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/splitwise)
- [Send to Agent page](https://openagent3.xyz/skills/splitwise/agent)
- [JSON manifest](https://openagent3.xyz/skills/splitwise/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/splitwise/agent.md)
- [Download page](https://openagent3.xyz/downloads/splitwise)