# Install the skill pack

This page shows how to install the AgentPay SDK skill pack into a supported host.

The most important detail is this:

* the host loads the skill pack
* the local machine still runs `agentpay`

Do not treat those as the same install step.

## Quick install (skills only)

If you only want the AI skill pack and adapters without installing the local AgentPay runtime:

```bash
curl -fsSL https://wlfi.sh | bash -s -- --skills-only
```

You can also pin a version:

```bash
curl -fsSL https://wlfi.sh/latest | bash -s -- --skills-only
curl -fsSL https://wlfi.sh/0.1.0 | bash -s -- --skills-only
```

This mode:

* downloads the same macOS AgentPay bundle used by the full installer and only applies the embedded skill files
* auto-detects supported AI agent paths and already-installed destinations
* presents a toggleable target list and lets you add custom skill-pack or adapter destinations
* supports Codex, Claude, Cline, Goose, Windsurf, OpenClaw, portable/legacy `.agents`, Cursor, and workspace adapters (`AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, Copilot instructions)
* installs the Cursor adapter when `AGENTPAY_SETUP_CURSOR_WORKSPACE` is set or the current directory is already a Cursor workspace
* does **not** install `agentpay`, Node.js, shell PATH exports, or wallet runtime files

After the script finishes, skip to [After install](#after-install) to verify.

The sections below cover manual installation for operators who installed from source or need to copy files to a custom location.

## What the skill pack contains

The skill pack folder includes:

* `SKILL.md` - the main skill definition loaded by compatible hosts
* `agents/` - host adapter files (`AGENTS.md` for Codex/OpenClaw, `CLAUDE.md` for Claude Code, `cursor-agentpay-sdk.mdc` for Cursor, `openai.yaml` for OpenAI-compatible hosts)
* `references/` - the playbooks the agent host actually follows:
  * `capabilities.md` - what the SDK can and cannot do
  * `install-and-workflows.md` - setup, funding, and transfer recipes
  * `intents-and-policies.md` - intent mapping and policy configuration
* `scripts/` - helper scripts for agent-driven workflows:
  * `prepare-funding-request.mjs` - generates funding instructions, QR codes, and formatted output for wallet top-up requests
  * `vendor/qrcodegen.mjs` - QR code generation library used by the funding request script

Operators should review the files in `references/` to understand what their agent host is doing on their behalf.

## What you copy

Clone the repository if you have not already:

```bash
git clone https://github.com/worldliberty/agentpay-sdk.git
```

The skill pack is the [`skills/agentpay-sdk/`](https://github.com/worldliberty/agentpay-sdk/tree/main/skills/agentpay-sdk) folder inside the checkout. Do not copy the whole repository into the host's skills directory.

If you reinstall or update the pack, replace the existing destination folder instead of copying into it repeatedly.

## Codex

```bash
mkdir -p ~/.codex/skills
cp -R agentpay-sdk/skills/agentpay-sdk ~/.codex/skills/
```

## OpenClaw

```bash
mkdir -p ~/.openclaw/skills
cp -R agentpay-sdk/skills/agentpay-sdk ~/.openclaw/skills/
```

## Claude Code

```bash
mkdir -p ~/.claude/skills
cp -R agentpay-sdk/skills/agentpay-sdk ~/.claude/skills/
```

## Cursor

Cursor has a purpose-built `.mdc` adapter file. Use it instead of `AGENTS.md`:

```bash
cp agentpay-sdk/skills/agentpay-sdk/agents/cursor-agentpay-sdk.mdc ./.cursor/rules/agentpay-sdk.mdc
```

The `.mdc` file includes `alwaysApply: false` front-matter so Cursor only invokes it when relevant.

## After install

Open a new host session and try:

```
What can you do with AgentPay SDK?
```

A correct install should let the host speak concretely about wallet setup, funding, policy, transfers, and approvals without needing extra pasted instructions.

## Next step

With the skill pack installed, continue to [Workflows](/agentpay-sdk/workflows.md) for the end-to-end operator flow.


---

# 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.worldlibertyfinancial.com/agentpay-sdk/install/skill-pack-install.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.