diff --git a/packages/connector-ui/public/skills/polygon-discovery/SKILL.md b/packages/connector-ui/public/skills/polygon-discovery/SKILL.md
index 6667596..27509bb 100644
--- a/packages/connector-ui/public/skills/polygon-discovery/SKILL.md
+++ b/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.
diff --git a/packages/polygon-agent-cli/skills/polygon-discovery/SKILL.md b/packages/polygon-agent-cli/skills/polygon-discovery/SKILL.md
index 6667596..27509bb 100644
--- a/packages/polygon-agent-cli/skills/polygon-discovery/SKILL.md
+++ b/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.
diff --git a/skills/polygon-discovery/SKILL.md b/skills/polygon-discovery/SKILL.md
index 6667596..27509bb 100644
--- a/skills/polygon-discovery/SKILL.md
+++ b/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.