Agent Skill Pack
13 min
start building with voltage in the coding agent you already use the voltage agent skill pack gives your agent the api reference, product context, and payment workflows it needs to help you write an integration, create a lightning invoice, check a wallet balance, or add hosted checkout it works with claude code, codex, hermes agent, opencode, cursor, gemini cli , and other supported agent harnesses install it first, then describe what you want to build one command install for most agent harnesses with your coding agent and node js/npm already installed, run this in your terminal npx skills add voltagecloud/agent skills global yes this installs the pack globally for supported agents detected on your computer, using shared skill locations where supported global installation makes the skill available across projects the command installs skill files; it does not install the agent applications or connect to your voltage account if your harness is not detected, use its command below to choose agents interactively, run the same command without yes claude code npx skills add voltagecloud/agent skills global agent claude code yes codex npx skills add voltagecloud/agent skills global agent codex yes hermes agent npx skills add voltagecloud/agent skills global agent hermes agent yes opencode npx skills add voltagecloud/agent skills global agent opencode yes cursor npx skills add voltagecloud/agent skills global agent cursor yes gemini cli npx skills add voltagecloud/agent skills global agent gemini cli yes for additional harnesses, see the supported agents in the skills installer https //github com/vercel labs/skills#supported agents ask your agent to get started open a new session in your agent after installation mention the voltage api skill and describe the result you want you can start writing an integration before supplying credentials use the voltage api skill to help me build an application that accepts lightning payments start with the integration plan and code, and explain what i need to configure in voltage before testing or try a specific task “use voltage api to write code that creates a lightning invoice for 150 sats and tracks whether it has been paid ” “use voltage api to add hosted checkout to this application ” “use voltage api to build a webhook receiver that verifies signatures and reconciles payment state ” “explain which parts of this integration apply to my credit backed or node backed wallet ” the pack currently includes the voltage api skill it covers wallets, payments, usd quotes, webhooks, balances, and checkout, with the voltage openapi contract as the authoritative api source your agent can generate application code and, with configured credentials and your direction, make api requests using curl connect a development wallet to make api calls, you need a voltage organization, environment, wallet, and an api key for that environment if these are not set up yet, follow the wallet setup guide docid\ alpqa ayg179ccwgf2ija , then the api key instructions in the developer guide docid\ l4sp3ernfdbslxqajxoeg for local agent use, the pack can read configuration from / voltage/ env create the directory and file with private permissions mkdir p / voltage chmod 700 / voltage (umask 077; touch / voltage/ env) chmod 600 / voltage/ env edit the file locally and replace these placeholders with your development environment's values voltage api key=your environment api key voltage organization id=your organization uuid voltage environment id=your environment uuid voltage wallet id=your development wallet uuid the wallet id is an optional default keep api keys out of agent conversations and source control the optional request helpers require python 3 9+ and curl start with a read only check use voltage api to check my configured wallet's network and available balance do not create a payment then try a test invoice verify that my configured wallet is on mutinynet, then create a lightning invoice for 150 sats and give me the invoice to pay from another test wallet creating an invoice does not mean it has been paid after paying it with test funds, ask your agent to check the payment status see staging environment docid\ ukhb7 3ektubbv hblw1t for development testing guidance keep the pack up to date npx skills update voltage api global find the skill source, configuration details, and examples in the voltage agent skill pack repository https //github com/voltagecloud/agent skills you can continue through the developer guide whenever you want to inspect the api or follow the manual setup steps yourself