manage-bills

Search and retrieve vendor bill details and attachments in Ramp via CLI.

45|6|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/ramp-public/ramp-cli --skill manage-bills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-bills
Source: https://github.com/ramp-public/ramp-cli/tree/main/src/ramp_cli/skills/manage-bills
Command: npx skills add https://github.com/ramp-public/ramp-cli --skill manage-bills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly find the right vendor bills, understand their status and details, and review attachments so you can decide what needs attention in Ramp without manually browsing every record.

Core Features & Use Cases

  • Bill discovery and filtering: Search bills by vendor name, invoice number, or payment-related identifiers and paginate through results to locate the specific bills you care about.
  • Deep bill inspection: Retrieve submitted or draft bill details in a single call, including key metadata like amounts (in cents), due dates, vendor info, approval status, and line items.
  • Attachment retrieval: Pull invoice attachment information for a bill so you can verify supporting documents.
  • Approval triage (read-only): List bills pending your approval to support review workflows, while routing approvals to the appropriate approval experience.

Quick Start

Ask the agent to search for Acme bills and include clickable Ramp deep links when available by running the bills search for vendor name Acme with JSON output enabled.

Frequently Asked Questions about manage-bills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search vendor bills in Ramp by vendor name or invoice number?

Search vendor bills in Ramp by providing a vendor name or invoice number to retrieve matching records. The tool paginates through results and returns JSON-friendly output containing bill details, enabling fast bill discovery without manual browsing.

How do I retrieve bill details and attachments for a specific vendor invoice?

Retrieve bill details and attachments by supplying the correct bill_id UUID. The tool fetches key metadata including amounts in cents, due dates, vendor info, approval status, and line items, alongside invoice attachment listings for document verification.

Can I view pending bill approvals in Ramp without leaving the CLI?

View pending bill approvals through a read-only list of bills awaiting your review. The tool supports approval triage workflows by surfacing pending items, while routing actual approvals to the appropriate Ramp approval experience for action.

Does the Ramp bill search tool provide deep links to individual vendor bills?

The tool provides environment-aware deep links via bill_url with safe fallbacks. It generates clickable Ramp deep links when available, allowing you to navigate directly to specific vendor bills from the JSON output for further inspection.

How do I filter Ramp vendor bills by submitted versus draft status?

Filter Ramp vendor bills by requesting submitted or draft bill details in a single call. The tool inspects the approval status metadata within the retrieved records to distinguish between submitted and draft bills for targeted review.

What limitations exist when inspecting vendor bills through the CLI?

Inspecting vendor bills through the CLI is limited to read-only actions and cannot process approvals directly. It requires correct handling of bill_id UUIDs and environment-aware deep linking, routing approval actions to the appropriate Ramp interface.