---
name: polymer-pay-api-finder
description: 'USE THIS SKILL WHEN: the user wants to find, explore, or install Polymer Pay
  API skills. Searches the local api catalog, fetches skill metadata, and installs
  skills to .claude folder.'
metadata:
  polymer-pay-skill:
    emoji: 🔧
    requires:
      env:
      - POLYMER_PAY_API_KEY
      primaryEnv: POLYMER_PAY_API_KEY
provider: polymer-pay
---

# Polymer Pay API Finder

Manage Polymer Pay API skills - search, fetch, and install locally.

## Overview

This skill provides tools to:
- **Search** the API catalog by keyword or use case
- **Preview** skill details with "When to Use" extraction
- **Fetch** skill metadata and documentation
- **Install** skills to `~/.claude/skills/` for immediate use

## Commands

### Search APIs

Find APIs by keyword, category, or use case:

```bash
node scripts/search.js "scrape website"
node scripts/search.js "find email"
node scripts/search.js "crypto price"
```

Returns: Matching APIs with name, category, description, and skill path.

### Preview Skill

Get structured preview with "When to Use" use cases:

```bash
node scripts/preview.js polymer-pay-firecrawl
node scripts/preview.js polymer-pay-apollo
```

Returns: JSON with name, description, and whenToUse array. Great for understanding when to invoke a skill.

### Fetch Skill Info

Get detailed skill metadata from SKILL.md:

```bash
node scripts/fetch.js polymer-pay-firecrawl
node scripts/fetch.js polymer-pay-apollo
```

Returns: YAML header (name, description, requirements) + documentation preview.

### Install Skill

Copy a skill to `~/.claude/skills/`:

```bash
node scripts/install.js polymer-pay-firecrawl
node scripts/install.js polymer-pay-apollo
```

After install, the skill is immediately available in Claude Code.

### List All Skills

Browse all available skills by category:

```bash
node scripts/list.js
node scripts/list.js "web-scraping"
```

## Example Workflow

```bash
# 1. Search for what you need
$ node scripts/search.js "scrape"
[
  {
    "name": "firecrawl",
    "category": "web-scraping",
    "skill": "polymer-pay-firecrawl",
    "description": "Scrape URLs, crawl websites, extract structured data"
  }
]

# 2. Preview to see when to use it
$ node scripts/preview.js polymer-pay-firecrawl
{
  "name": "polymer-pay-firecrawl",
  "description": "USE THIS SKILL WHEN: ...",
  "whenToUse": [
    "Web scraping — Scrape any URL to clean markdown...",
    "Site discovery — Map all URLs on a website...",
    "Bulk content ingestion — Crawl entire websites..."
  ]
}

# 3. Install it
$ node scripts/install.js polymer-pay-firecrawl
✓ Installed polymer-pay-firecrawl to ~/.claude/skills/polymer-pay-firecrawl

# 4. Use in Claude
/polymer-pay-firecrawl:scrape https://example.com
```

## File Locations

| File | Purpose |
|------|---------|
| `scripts/search.js` | Search apis.json catalog |
| `scripts/preview.js` | Preview skill with When to Use extraction |
| `scripts/fetch.js` | Parse SKILL.md YAML header |
| `scripts/install.js` | Copy skill to ~/.claude/skills/ |
| `scripts/list.js` | List all skills by category |

## Data Sources

- **API Catalog**: `../../apis.json` (all 50+ APIs)
- **Skill Docs**: `../../skills/{skill-name}/SKILL.md`
- **Install Target**: `~/.claude/skills/{skill-name}/`

## Best Practices

- **For errors** — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting