diff --git a/README.md b/README.md
index 520e2be..c9a6356 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](https://www.typescriptlang.org/)
 [![Base · x402](https://img.shields.io/badge/Base-x402-fc6f6f.svg)](https://x402.org)
 
-Open-source toolkit for **h402 — the x402 router for agent capabilities**. One endpoint per task: h402 routes each call to the best API provider and settles per call in Base USDC over x402.
+Open-source toolkit for **h402 — the x402 router for agent capabilities**. One endpoint per task: providers compete behind each capability, h402 auto-pins the best one per call, and settles in Base USDC over x402.
 
 > x402 is the rail. h402 is the router.
 
diff --git a/SKILL.md b/SKILL.md
index 6866951..b5e72c3 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -12,8 +12,10 @@ description: >-
 
 h402 is the **x402 router for agent capabilities**: one canonical endpoint per task.
 You call the *task* (e.g. `web/search`), and h402 routes the call to the best provider
-and returns a free result or settles a payable challenge in Base USDC. No per-vendor API
-keys or subscriptions; a funded wallet is needed only for a payable challenge.
+and returns a free result or settles a payable challenge in Base USDC. Behind each
+capability, providers compete on price and live quality; h402 auto-pins the best one
+to your call. No per-vendor API keys or subscriptions; a funded wallet is needed only
+for a payable challenge.
 
 ## When to use this