Merge pull request #87 from 0xPolygon/fix/polygon-discovery-prerequisites

feat(skill): add prerequisites check to polygon-discovery skill

Author: JamesLawton

packages/connector-ui/public/skills/polygon-discovery/SKILL.md

@@ -11,6 +11,28 @@ Pay-per-call APIs accessible via `x402-pay`. No API keys or subscriptions — ea
 
 ---
 
+## Prerequisites — Check Before Any x402 Call
+
+Before running any `x402-pay` command, verify the wallet session exists and is funded:
+
+```bash
+# Check if a wallet is configured
+polygon-agent wallet list
+```
+
+**If no wallet is listed**, the smart session has not been created. Run through the complete setup flow before proceeding:
+
+1. `polygon-agent setup --name "MyAgent"` — creates EOA and Sequence project
+2. `polygon-agent wallet create --usdc-limit 100` — opens browser for session approval; enter the 6-digit code when prompted
+3. `polygon-agent wallet address` — get address, then fund via https://agentconnect.polygon.technology
+4. `polygon-agent balances` — confirm USDC is available before calling any x402 endpoint
+
+**If a wallet exists but `balances` shows 0 USDC**, direct the user to fund it via the UI — `x402-pay` will fail with an EOA funding error otherwise.
+
+Once a funded wallet is confirmed, proceed with the x402 calls below.
+
+---
+
 ## Read Twitter/X Profile
 
 $0.005 USDC per call.

packages/polygon-agent-cli/skills/polygon-discovery/SKILL.md

@@ -11,6 +11,28 @@ Pay-per-call APIs accessible via `x402-pay`. No API keys or subscriptions — ea
 
 ---
 
+## Prerequisites — Check Before Any x402 Call
+
+Before running any `x402-pay` command, verify the wallet session exists and is funded:
+
+```bash
+# Check if a wallet is configured
+polygon-agent wallet list
+```
+
+**If no wallet is listed**, the smart session has not been created. Run through the complete setup flow before proceeding:
+
+1. `polygon-agent setup --name "MyAgent"` — creates EOA and Sequence project
+2. `polygon-agent wallet create --usdc-limit 100` — opens browser for session approval; enter the 6-digit code when prompted
+3. `polygon-agent wallet address` — get address, then fund via https://agentconnect.polygon.technology
+4. `polygon-agent balances` — confirm USDC is available before calling any x402 endpoint
+
+**If a wallet exists but `balances` shows 0 USDC**, direct the user to fund it via the UI — `x402-pay` will fail with an EOA funding error otherwise.
+
+Once a funded wallet is confirmed, proceed with the x402 calls below.
+
+---
+
 ## Read Twitter/X Profile
 
 $0.005 USDC per call.

skills/polygon-discovery/SKILL.md

@@ -11,6 +11,28 @@ Pay-per-call APIs accessible via `x402-pay`. No API keys or subscriptions — ea
 
 ---
 
+## Prerequisites — Check Before Any x402 Call
+
+Before running any `x402-pay` command, verify the wallet session exists and is funded:
+
+```bash
+# Check if a wallet is configured
+polygon-agent wallet list
+```
+
+**If no wallet is listed**, the smart session has not been created. Run through the complete setup flow before proceeding:
+
+1. `polygon-agent setup --name "MyAgent"` — creates EOA and Sequence project
+2. `polygon-agent wallet create --usdc-limit 100` — opens browser for session approval; enter the 6-digit code when prompted
+3. `polygon-agent wallet address` — get address, then fund via https://agentconnect.polygon.technology
+4. `polygon-agent balances` — confirm USDC is available before calling any x402 endpoint
+
+**If a wallet exists but `balances` shows 0 USDC**, direct the user to fund it via the UI — `x402-pay` will fail with an EOA funding error otherwise.
+
+Once a funded wallet is confirmed, proceed with the x402 calls below.
+
+---
+
 ## Read Twitter/X Profile
 
 $0.005 USDC per call.