---
title: Agent Skills Integration Guide
slug: ai/agent-skills/integration-guide
hidden: false
metadata:
  robots: index
  title: Install Agent Skills — CLI Integration Guide | Pine Labs
  description: >-
    Install Pine Labs Agent Skills via npm, configure GitHub Copilot, Cursor,
    Claude Code, Gemini CLI, Codex, and other assistants, and keep skills
    updated.
  keywords: >-
    Agent Skills install, pinelabs-agent-skills-cli, Copilot setup, Cursor
    rules, Claude Code skills, npx install
excerpt: >-
  Install Pine Labs Agent Skills into your project with a single command and
  configure any of the eight supported coding assistants.
sidebar_label: Integration Guide
sidebar_order: 3
---
Install Pine Labs Agent Skills into any project where you want payment-aware guidance available to your AI coding assistant.

## Prerequisites

Before installing, make sure you have:

1. Node.js **18** or newer
2. A project directory where you want Pine Labs guidance available
3. A supported AI coding assistant or framework configuration

## Install in one command

From your project root, run:

```bash
npx pinelabs-agent-skills-cli add skills
```

The command prompts for which assistant frameworks to configure, writes Pine Labs skill files into the project, and inserts or updates a managed manifest block for each selected framework.

## Install for a specific assistant

To skip the prompt and configure a single framework such as VS Code Copilot:

```bash
npx pinelabs-agent-skills-cli add skills --frameworks vscode-copilot --yes
```

Useful command variations:

```bash
# Preview the planned writes without modifying files
npx pinelabs-agent-skills-cli add skills --frameworks vscode-copilot --dry-run

# Install into a specific project path
npx pinelabs-agent-skills-cli add skills --path /path/to/project --frameworks cursor

# Refresh already installed Pine Labs skills
npx pinelabs-agent-skills-cli update

# Update a subset of installed frameworks
npx pinelabs-agent-skills-cli update --frameworks cursor,claude-code

# List supported frameworks and their install paths
npx pinelabs-agent-skills-cli list-frameworks

# Show which Pine Labs skills are installed in a project
npx pinelabs-agent-skills-cli doctor --path /path/to/project
```

## Get credentials and generate a token

`pinelabs-agent-skills-cli` installs local assistant guidance. It does not sign in to Pine Labs, create Dashboard accounts, or request OAuth tokens itself.

Before using the installed skills for API work:

1. Create a Pine Labs Online Dashboard account from the [Dashboard sign-up guide](/docs/dashboard/sign-up).
2. Verify your email address and sign in to the Dashboard. Two-factor authentication is required during login.
3. Open Dashboard Settings → API Keys and generate UAT or test credentials.
4. Use the Client ID as `PINELABS_CLIENT_ID` and the Client Secret as `PINELABS_CLIENT_SECRET`.

Set credentials in your server-side environment:

```bash
export PINELABS_CLIENT_ID=your_client_id
export PINELABS_CLIENT_SECRET=your_client_secret
export PINELABS_ENV=uat
```

To generate an OAuth access token, use Pine Labs CLI tooling with env-backed credentials. Do not pass client credentials in command arguments, inline JSON, screenshots, logs, or chat:

```bash
pinelabs generate-token --env uat
```

Keep credentials and access tokens out of browser code, mobile apps, committed files, screenshots, and logs.

## Commands

| Command | Purpose |
|---|---|
| `add skills` | Install Pine Labs skills and framework manifests. Prompts unless `--frameworks` is provided. |
| `update` | Refresh already installed Pine Labs skills. Defaults to detected installed frameworks. |
| `list-frameworks` | Print supported framework IDs, display names, skills paths, and manifest paths. |
| `doctor` | Show which Pine Labs skills are installed in a project and whether each install is current, stale, or legacy. |

## Common options

| Option | Applies to | Purpose |
|---|---|---|
| `--frameworks <ids>` | `add skills`, `update` | Comma-separated framework IDs such as `vscode-copilot,claude-code`. |
| `--path <path>` | `add skills`, `update`, `doctor` | Project path to inspect or modify. Defaults to current directory. |
| `--dry-run` | `add skills`, `update` | Print planned writes without modifying files. |
| `--yes` | `add skills` | Use detected framework defaults without prompting. Falls back to VS Code Copilot when no likely framework is detected. |


## Framework install paths with Supported coding agents

| Framework ID | Coding Agents | Skills path | Manifest path |
|---|---|---|---|
| `claude-code` | Claude Code | `.claude/skills/pinelabs-skills` | `CLAUDE.md` |
| `cursor` | Cursor | `.cursor/pinelabs-skills` | `.cursor/rules/pinelabs.mdc` |
| `vscode-copilot` | VS Code Copilot | `.github/skills/pinelabs-skills` | `.github/copilot-instructions.md` |
| `gemini-cli` | Gemini CLI | `.gemini/skills/pinelabs-skills` | `GEMINI.md` |
| `kiro` | Kiro | `.kiro/skills/pinelabs-skills` | `.kiro/steering/pinelabs-agent-skills.md` |
| `opencode` | OpenCode | `.opencode/skills/pinelabs-skills` | `AGENTS.md` |
| `github-copilot-cli` | GitHub Copilot CLI | `.github/skills/pinelabs-skills` | `.github/copilot-instructions.md` |
| `codex-cli` | OpenAI Codex CLI | `.agents/skills/pinelabs-skills` | `AGENTS.md` |
| `antigravity` | Antigravity | `.agent/skills/pinelabs-skills` | `AGENTS.md` |

<Callout type="info" title="Supported aliases">
  The CLI also recognises the aliases `claude`, `copilot`, `github-copilot`, `gemini`, `kiro-ide`, `kiro-cli`, `copilot-cli`, and `codex`.
</Callout>

## How compatibility works

Compatibility is broad but not universal or automatic. The CLI installs Pine Labs skill files and updates the manifest or instruction format expected by each supported assistant.

Examples:

- **VS Code Copilot:** `.github/skills/pinelabs-skills` and `.github/copilot-instructions.md`
- **Cursor:** `.cursor/pinelabs-skills` and `.cursor/rules/pinelabs.mdc`
- **Claude Code:** `.claude/skills/pinelabs-skills` and `CLAUDE.md`

## What the package installs

Each selected framework receives a `pinelabs-skills` directory plus a managed manifest block. Content outside the managed block is preserved. Re-running `add skills` or `update` replaces the Pine Labs block and skill files in place, so installs are idempotent.

```Structure
pinelabs-skills/
├── SKILL.md                          # Root router, global safety rules
├── .pinelabs-skills-version.json     # Version marker for doctor/update
├── validation-and-testing.md         # UAT, negative testing checklist
├── validation-and-testing/           # Focused test guides
│   ├── checkout-orders.md
│   ├── refunds.md
│   ├── webhooks.md
│   ├── mobile-web-sdks.md
│   ├── subscriptions.md
│   └── settlements.md
├── go-live.md                        # Production readiness gates
├── webhooks.md                       # Signature verification guidance
├── common-mistakes.md                # Unsafe pattern review checklist
├── upgrade-advisor.md                # Update flow for installed skills
├── migration-guides/                 # Provider migration routing
│   ├── README.md
│   └── razorpay-reference.md
├── getting-started/                  # Onboarding and auth
│   ├── README.md
│   ├── authentication.md
│   └── dashboard-signup-and-token.md
├── payments/                         # Payment gateway domain
│   ├── README.md
│   ├── orders.md
│   ├── checkout.md
│   ├── card-payments.md
│   ├── upi-payments.md
│   ├── payment-links.md
│   ├── mobile-sdks/                  # Native mobile SDK guidance
│   │   ├── android.md
│   │   ├── ios.md
│   │   └── flutter.md
│   └── web-sdks/                     # WebView SDK guidance
│       ├── android.md
│       ├── ios.md
│       ├── flutter.md
│       └── react-native.md
├── settlements/                      # Refunds, payouts, settlements
│   ├── refunds.md
│   ├── payouts.md
│   └── settlements.md
├── subscriptions/                    # Recurring payments
│   ├── subscriptions-plans.md
│   ├── subscriptions-subscriptions.md
│   └── subscriptions-presentations.md
└── p3p/                              # P3P x402 and UPI ReservePay
    ├── README.md
    ├── pay.md                        # CLI-driven mandate and debit
    └── sdk-integration.md            # x402 SDK integration
```

The generated manifest tells the assistant to start with `SKILL.md` for routing and safety rules. For validation, webhook, go-live, or migration work, the assistant reads the matching workflow guide. For API-specific work, it reads the domain router, then the matching area guidance file.

## P3P skills

The installer also bundles Pine Labs P3P skills:

- `p3p/pay.md` guides CLI-driven UPI ReservePay flows for agent payments: mandate creation, PPT token creation, debit execution, webhook listening, and sandbox checks.
- `p3p/sdk-integration.md` guides application integration for x402 payment middleware using the P3P server/client SDKs, framework templates, and sandbox test data.

These are guidance assets only. The installer does not install runtime packages. Install the needed P3P runtime dependency in the target project when the assistant asks for it:

```bash
npm install -g @pine-labs-online/p3p-cli
npm install p3p-server-sdk p3p-client-sdk
```

## Explore use cases and available skills

<div className="not-prose grid grid-cols-1 md:grid-cols-2 gap-4 my-6">
  <div className="card-grid-item">
    <div className="inline-flex items-center justify-center w-10 h-10 rounded-lg bg-[#D0F6E5]/60 mb-3">
      <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="#003434" strokeWidth="1.8" strokeLinecap="round" strokeLinejoin="round"><path d="M14.5 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7.5L14.5 2z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/></svg>
    </div>
    <h3>Use Cases</h3>
    <p>See how Pine Labs Agent Skills help AI assistants build checkout flows, handle webhooks, process refunds, and run go-live reviews.</p>
    <a href="use-cases">View Examples →</a>
  </div>
  <div className="card-grid-item">
    <div className="inline-flex items-center justify-center w-10 h-10 rounded-lg bg-[#D0F6E5]/60 mb-3">
      <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="#003434" strokeWidth="1.8" strokeLinecap="round" strokeLinejoin="round"><line x1="8" y1="6" x2="21" y2="6"/><line x1="8" y1="12" x2="21" y2="12"/><line x1="8" y1="18" x2="21" y2="18"/><line x1="3" y1="6" x2="3.01" y2="6"/><line x1="3" y1="12" x2="3.01" y2="12"/><line x1="3" y1="18" x2="3.01" y2="18"/></svg>
    </div>
    <h3>Available Skills</h3>
    <p>Browse the best-practices skill and API-area reference skills covering orders, payments, refunds, subscriptions, and more.</p>
    <a href="available-skills">Explore Skills →</a>
  </div>
</div>

## Troubleshooting

| Issue | Guidance |
|---|---|
| Unsupported framework | Run `npx pinelabs-agent-skills-cli list-frameworks` and use one of the listed IDs. |
| No installed Pine Labs skills were found during update | Run `add skills` first, or pass `--frameworks` to update a specific framework. |
| Partial managed block error | Open the manifest file, remove or repair the incomplete `BEGIN`/`END` block, then rerun the command. |
| `--dry-run` did not write files | Expected behavior. Remove `--dry-run` after reviewing planned writes. |
| Multiple frameworks use the same manifest file | Each framework writes a separate managed block keyed by framework ID. Reruns update only the matching block. |

## Package footprint

The published npm package is lightweight. Version `0.5.2` has an unpacked size of approximately `722 kB` across `15` published files. Inside a project, it adds a `pinelabs-skills` directory and updates one framework-specific manifest file per selected framework.