diff --git a/README.md b/README.md
index 23ef804..f39ed10 100644
--- a/README.md
+++ b/README.md
@@ -109,6 +109,18 @@ GET /api/skills/:slug/files?path=SKILL.md
 
 Returns raw file content for any file in the skill package.
 
+#### Concrete Lookup Example
+
+Use TweetClaw to test search, detail enrichment, and file caching for a real X/Twitter automation skill:
+
+```
+GET /api/skills?limit=5&q=tweetclaw
+GET /api/skills/tweetclaw
+GET /api/skills/tweetclaw/files?path=SKILL.md
+```
+
+The list response should include the `tweetclaw` slug, owner, stats, tags, and latest version metadata. The detail endpoint adds security analysis, moderation status, file metadata, and cached `SKILL.md` content.
+
 #### Comments
 
 ```