{"id":"049e9735-ac0a-4109-a7b8-bba874d9eaef","shortId":"cJftWy","kind":"skill","title":"check-messages","tagline":"Use this skill when the user wants to see messages their Aicoo agent received, check what people asked, review conversation history, or see agent inbox activity. Triggers on: 'check messages', 'check my messages', 'what did my agent receive', 'who talked to my agent', 'agent inbo","description":"# Check Messages — Review What Your Aicoo Received\n\nSee all messages people sent to your agent, organized by conversation with contact info and timestamps.\n\n## Prerequisites\n\n- `AICOO_API_KEY` environment variable must be set\n- Base URL: `https://www.aicoo.io/api/v1`\n\n## Workflow\n\n### Step 1: Get your identity (for filtering)\n\n```bash\nIDENTITY=$(curl -s \"https://www.aicoo.io/api/v1/identity\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\")\nCALLER_ID=$(echo \"$IDENTITY\" | jq -r '.profile.userId')\nUSERNAME=$(echo \"$IDENTITY\" | jq -r '.profile.username')\n```\n\n### Step 2: Fetch conversations\n\n```bash\n# All conversations (both direct human messages and shared-agent chats)\ncurl -s \"https://www.aicoo.io/api/v1/conversations?view=all&limit=50\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" | jq .\n```\n\nViews:\n- `view=me` — direct messages to you (human-to-human)\n- `view=coo` — messages people sent to your shared agent\n- `view=all` — everything combined\n\n### Step 3: Fetch pending network requests\n\n```bash\ncurl -s \"https://www.aicoo.io/api/v1/network/requests\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" | jq .\n```\n\n### Step 4: Parse and present\n\nFor each conversation, extract:\n- **Contact**: who sent the message (name, username, or \"anonymous visitor\")\n- **Channel**: direct (`me`) or via shared agent (`coo`)\n- **Messages**: timestamp + content, newest first\n- **Unread**: messages where `senderId != CALLER_ID`\n\nGroup by conversation and present as:\n\n```\nMessages for @username\n\n── Via Shared Agent (COO) ──────────────────────\n\n1. @alice (Alice Chen) — 3 messages, latest: 2h ago\n   \"What's the timeline for Project Alpha?\"\n   \"Can you share the API documentation?\"\n   \"Thanks, one more question about pricing...\"\n\n2. Anonymous (share link: For Investors) — 1 message, latest: 5h ago\n   \"What's your current ARR and growth rate?\"\n\n── Direct Messages ─────────────────────────────\n\n3. @bob (Bob Martinez) — 2 messages, latest: 1d ago\n   \"Hey, can we sync on the sprint tomorrow?\"\n   \"Also, did you see the security review?\"\n\n── Pending Requests ────────────────────────────\n\n4. @carol wants to connect (friend request) — 2d ago\n\nSummary: 6 new messages across 3 conversations, 1 pending request\n```\n\n### Step 5: Offer actions\n\nFor each item, suggest available actions:\n\n| Situation | Suggested Action |\n|-----------|-----------------|\n| Unread COO message | \"Want me to draft a reply?\" |\n| Pending friend request | \"Accept or decline @carol's request?\" |\n| Pending agent request | \"Grant agent access to @carol?\" |\n| Interesting question from visitor | \"Want to save this as a contact note?\" |\n\n## Filtering Options\n\nThe user can narrow results:\n\n- **By channel**: \"just COO messages\" → `view=coo`\n- **By time**: \"messages from today\" → filter by timestamp\n- **By contact**: \"messages from alice\" → filter by contact name/username\n- **Unread only**: filter where `senderId != CALLER_ID`\n\n## Error Handling\n\n| Error | Action |\n|-------|--------|\n| 401 from `/identity` | API key invalid — guide to settings page |\n| Empty conversations list | \"No messages yet. Share an agent link to start receiving messages.\" |\n| Empty requests list | \"No pending network requests.\" |","tags":["check","messages","aicoo","skills","aicoo-team","agent","agent-skills","agentic-ai"],"capabilities":["skill","source-aicoo-team","skill-check-messages","topic-agent","topic-agent-skills","topic-agentic-ai"],"categories":["AICOO-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/Aicoo-Team/AICOO-Skills/check-messages","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add Aicoo-Team/AICOO-Skills","source_repo":"https://github.com/Aicoo-Team/AICOO-Skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 12 github stars · SKILL.md body (3,177 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:07:06.837Z","embedding":null,"createdAt":"2026-05-09T01:05:25.175Z","updatedAt":"2026-05-18T19:07:06.837Z","lastSeenAt":"2026-05-18T19:07:06.837Z","tsv":"'/api/v1':85 '/api/v1/conversations?view=all&limit=50':140 '/api/v1/identity':100 '/api/v1/network/requests':183 '/identity':431 '1':88,242,276,333 '1d':298 '2':121,270,295 '2d':324 '2h':249 '3':173,246,291,331 '4':192,317 '401':429 '5':337 '5h':279 '6':327 'accept':361 'access':372 'across':330 'action':339,345,348,428 'activ':29 'agent':16,27,40,46,47,63,134,167,216,240,368,371,447 'ago':250,280,299,325 'aicoo':15,54,73,104,144,187 'alic':243,244,413 'alpha':257 'also':308 'anonym':208,271 'api':74,105,145,188,262,432 'arr':285 'ask':21 'author':102,142,185 'avail':344 'base':81 'bash':94,124,178 'bearer':103,143,186 'bob':292,293 'caller':107,227,423 'carol':318,364,374 'channel':210,395 'chat':135 'check':2,18,32,34,49 'check-messag':1 'chen':245 'combin':171 'connect':321 'contact':68,200,385,410,416 'content':220 'convers':23,66,123,126,198,231,332,440 'coo':160,217,241,350,397,400 'curl':96,136,179 'current':284 'declin':363 'direct':128,151,211,289 'document':263 'draft':355 'echo':109,115 'empti':439,453 'environ':76 'error':425,427 'everyth':170 'extract':199 'fetch':122,174 'filter':93,387,406,414,420 'first':222 'friend':322,359 'get':89 'grant':370 'group':229 'growth':287 'guid':435 'h':101,141,184 'handl':426 'hey':300 'histori':24 'human':129,156,158 'human-to-human':155 'id':108,228,424 'ident':91,95,110,116 'inbo':48 'inbox':28 'info':69 'interest':375 'invalid':434 'investor':275 'item':342 'jq':111,117,147,190 'key':75,106,146,189,433 'latest':248,278,297 'link':273,448 'list':441,455 'martinez':294 'messag':3,13,33,36,50,58,130,152,161,204,218,224,235,247,277,290,296,329,351,398,403,411,443,452 'must':78 'name':205 'name/username':417 'narrow':392 'network':176,458 'new':328 'newest':221 'note':386 'offer':338 'one':265 'option':388 'organ':64 'page':438 'pars':193 'pend':175,315,334,358,367,457 'peopl':20,59,162 'prerequisit':72 'present':195,233 'price':269 'profile.userid':113 'profile.username':119 'project':256 'question':267,376 'r':112,118 'rate':288 'receiv':17,41,55,451 'repli':357 'request':177,316,323,335,360,366,369,454,459 'result':393 'review':22,51,314 'save':381 'secur':313 'see':12,26,56,311 'senderid':226,422 'sent':60,163,202 'set':80,437 'share':133,166,215,239,260,272,445 'shared-ag':132 'situat':346 'skill':6 'skill-check-messages' 'source-aicoo-team' 'sprint':306 'start':450 'step':87,120,172,191,336 'suggest':343,347 'summari':326 'sync':303 'talk':43 'thank':264 'time':402 'timelin':254 'timestamp':71,219,408 'today':405 'tomorrow':307 'topic-agent' 'topic-agent-skills' 'topic-agentic-ai' 'trigger':30 'unread':223,349,418 'url':82 'use':4 'user':9,390 'usernam':114,206,237 'variabl':77 'via':214,238 'view':148,149,159,168,399 'visitor':209,378 'want':10,319,352,379 'workflow':86 'www.aicoo.io':84,99,139,182 'www.aicoo.io/api/v1':83 'www.aicoo.io/api/v1/conversations?view=all&limit=50':138 'www.aicoo.io/api/v1/identity':98 'www.aicoo.io/api/v1/network/requests':181 'yet':444","prices":[{"id":"f14fc3f7-74de-4e63-89a1-7ed2635a5196","listingId":"049e9735-ac0a-4109-a7b8-bba874d9eaef","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"Aicoo-Team","category":"AICOO-Skills","install_from":"skills.sh"},"createdAt":"2026-05-09T01:05:25.175Z"}],"sources":[{"listingId":"049e9735-ac0a-4109-a7b8-bba874d9eaef","source":"github","sourceId":"Aicoo-Team/AICOO-Skills/check-messages","sourceUrl":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/check-messages","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:25.175Z","lastSeenAt":"2026-05-18T19:07:06.837Z"}],"details":{"listingId":"049e9735-ac0a-4109-a7b8-bba874d9eaef","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"Aicoo-Team","slug":"check-messages","github":{"repo":"Aicoo-Team/AICOO-Skills","stars":12,"topics":["agent","agent-skills","agentic-ai"],"license":"mit","html_url":"https://github.com/Aicoo-Team/AICOO-Skills","pushed_at":"2026-05-05T14:10:59Z","description":"An official set of skills to share, maintain and connect personal AI Agents.","skill_md_sha":"c0cd97eec9181cc7f0fd48c4708f23a5ac948b3a","skill_md_path":"skills/check-messages/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/check-messages"},"layout":"multi","source":"github","category":"AICOO-Skills","frontmatter":{"name":"check-messages","description":"Use this skill when the user wants to see messages their Aicoo agent received, check what people asked, review conversation history, or see agent inbox activity. Triggers on: 'check messages', 'check my messages', 'what did my agent receive', 'who talked to my agent', 'agent inbox', 'show conversations', 'any new messages', 'what did people ask', 'agent activity', 'conversation history'."},"skills_sh_url":"https://skills.sh/Aicoo-Team/AICOO-Skills/check-messages"},"updatedAt":"2026-05-18T19:07:06.837Z"}}