Install Agent Skills — CLI Integration Guide

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:

Node.js 18 or newer
A project directory where you want Pine Labs guidance available
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:

Create a Pine Labs Online Dashboard account from the Dashboard sign-up guide.
Verify your email address and sign in to the Dashboard. Two-factor authentication is required during login.
Open Dashboard Settings → API Keys and generate UAT or test credentials.
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`

Supported aliases

The CLI also recognises the aliases claude, copilot, github-copilot, gemini, kiro-ide, kiro-cli, copilot-cli, and codex.

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

Use Cases

See how Pine Labs Agent Skills help AI assistants build checkout flows, handle webhooks, process refunds, and run go-live reviews.

View Examples →

Available Skills

Browse the best-practices skill and API-area reference skills covering orders, payments, refunds, subscriptions, and more.

Explore Skills →

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.