{"id":"6abaa7ec-1bff-4224-b220-ebf3b3b00c40","shortId":"bcRRNy","kind":"skill","title":"share-agent","tagline":"Use this skill when the user wants to share their AI agent with someone, generate a shareable link, require sign-in, allow anonymous access, let others talk to their agent, configure write access for guests, or manage existing shared links. Triggers on: 'share link', 'agent link'","description":"# Share Agent\n\nCreate and manage secure, shareable links to a user's agent.\n\n## Prerequisites\n\n- `AICOO_API_KEY` must be set; legacy `PULSE_API_KEY` is also accepted\n- Base URL: `https://www.aicoo.io/api/v1`\n- User should sync context first\n- Command examples use `${AICOO_API_KEY:-$PULSE_API_KEY}` for backward compatibility\n\n## Core Workflow\n\n### 1) Check context exists\n\n```bash\ncurl -s -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  \"https://www.aicoo.io/api/v1/os/status\" | jq .\n```\n\nIf `contextCount` is 0, run `context-sync` first.\n\n### 2) Create a share link (OS endpoint)\n\n```bash\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/share\" \\\n  -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"scope\":\"all\",\n    \"access\":\"read\",\n    \"notesAccess\":\"read\",\n    \"label\":\"For investors\",\n    \"expiresIn\":\"7d\",\n    \"requireSignIn\":true\n  }' | jq .\n```\n\n### 3) Confirm to user\n\nAlways report:\n\n1. URL to share\n2. Scope and notes/calendar permissions\n3. Expiration\n4. Sign-in requirement\n5. Access is sandboxed\n\nDefault behavior: new links require sign-in (`requireSignIn:true`). Only set `requireSignIn:false` when the user explicitly asks for an anonymous public link.\n\n## Parameters\n\n| Parameter | Values | Description |\n|-----------|--------|-------------|\n| `scope` | `all` \\| `folders` | `folders` requires `folderIds` |\n| `folderIds` | number[] | folder scope ids |\n| `access` | `read` \\| `read_calendar` \\| `read_calendar_write` | calendar access |\n| `notesAccess` | `read` \\| `write` \\| `edit` | notes permission |\n| `label` | string | link label |\n| `expiresIn` | `1h` \\| `24h` \\| `7d` \\| `30d` \\| `90d` \\| `never` | expiration |\n| `requireSignIn` | boolean | Defaults to `true`. If true, `/a/<token>` and `/shared/<token>` require a signed-in Aicoo user. Signed-in guest sessions can track `guestUserId`, `guestName`, `guestUsername`, and `guestEmail`. Set `false` only for anonymous public links. |\n\n## Notes Access Matrix\n\n| Operation | read | write | edit |\n|-----------|------|-------|------|\n| Search/read notes | yes | yes | yes |\n| Create notes | no | yes | yes |\n| Edit notes | no | no | yes |\n| Snapshots | no | no | yes |\n\n## Manage Existing Links\n\n### List links + visitors + contacts\n\n```bash\ncurl -s -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  \"https://www.aicoo.io/api/v1/os/network\" | jq .\n```\n\n### Update/revoke link (canonical OS endpoints)\n\n```bash\n# update\ncurl -s -X PATCH \"https://www.aicoo.io/api/v1/os/share/{linkId}\" \\\n  -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"notesAccess\":\"write\",\"expiresIn\":\"30d\",\"requireSignIn\":true}' | jq .\n\n# revoke\ncurl -s -X DELETE \"https://www.aicoo.io/api/v1/os/share/{linkId}\" \\\n  -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" | jq .\n```\n\n### List links with analytics\n\n```bash\ncurl -s -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  \"https://www.aicoo.io/api/v1/os/share/list?status=active&limit=20\" | jq .\n```\n\n## Folder-Scoped Share Example\n\n```bash\n# inspect folders first\ncurl -s -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  \"https://www.aicoo.io/api/v1/os/folders\" | jq .\n\n# create folder-scoped link\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/share\" \\\n  -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"scope\":\"folders\",\"folderIds\":[5,12],\"access\":\"read\",\"notesAccess\":\"write\",\"label\":\"Team collaborator\",\"requireSignIn\":true}' | jq .\n```\n\n## Per-Link Policy Editing\n\nLink notes are stored in `links/` folder. Edit policy by searching notes then patching note content:\n\n```bash\n# find link policy note\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/notes/search\" \\\n  -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":\"For-Investors\"}' | jq .\n\n# edit policy note content\ncurl -s -X PATCH \"https://www.aicoo.io/api/v1/os/notes/123\" \\\n  -H \"Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"content\":\"...\\n\\n## Policy\\n\\nBe professional, concise, and do not disclose confidential numbers.\"}' | jq .\n```\n\n## Security Notes\n\n- Every link runs inside isolated scope\n- New links require sign-in by default unless `requireSignIn:false` is explicitly set\n- Signed-in visitors can appear in analytics with name, username, email, and user id; anonymous links only have guest-session/fingerprint metadata\n- Revoked/expired links lose access immediately\n- Default expiration is 30 days unless overridden\n- Use `notesAccess: \"edit\"` carefully","tags":["share","agent","aicoo","skills","aicoo-team","agent-skills","agentic-ai"],"capabilities":["skill","source-aicoo-team","skill-share-agent","topic-agent","topic-agent-skills","topic-agentic-ai"],"categories":["AICOO-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/Aicoo-Team/AICOO-Skills/share-agent","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 (4,708 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:07.398Z","embedding":null,"createdAt":"2026-05-09T01:05:25.854Z","updatedAt":"2026-05-18T19:07:07.398Z","lastSeenAt":"2026-05-18T19:07:07.398Z","tsv":"'/a':274 '/api/v1':82 '/api/v1/os/folders':450 '/api/v1/os/network':350 '/api/v1/os/notes/123':557 '/api/v1/os/notes/search':526 '/api/v1/os/share':145,463 '/api/v1/os/share/':365,396 '/api/v1/os/share/list?status=active&limit=20':426 '/api/v1/os/status':120 '/fingerprint':632 '/shared':276 '0':125 '1':102,181 '12':483 '1h':260 '2':131,185 '24h':261 '3':175,190 '30':642 '30d':263,385 '4':192 '5':197,482 '7d':171,262 '90d':264 'accept':77 'access':28,37,163,198,240,248,304,484,637 'agent':3,15,34,49,52,63 'ai':14 'aicoo':65,91,112,149,282,342,370,401,418,442,467,530,561 'allow':26 'also':76 'alway':179 'analyt':411,617 'anonym':27,222,300,625 'api':66,73,92,95,113,116,150,153,343,346,371,374,402,405,419,422,443,446,468,471,531,534,562,565 'appear':615 'application/json':159,380,477,540,571 'ask':219 'author':110,147,340,368,399,416,440,465,528,559 'backward':98 'base':78 'bash':106,138,336,357,412,433,515 'bearer':111,148,341,369,400,417,441,466,529,560 'behavior':202 'boolean':268 'calendar':243,245,247 'canon':354 'care':649 'check':103 'collabor':490 'command':88 'compat':99 'concis':580 'confidenti':585 'configur':35 'confirm':176 'contact':335 'content':157,378,475,514,538,550,569,573 'content-typ':156,377,474,537,568 'context':86,104,128 'context-sync':127 'contextcount':123 'core':100 'creat':53,132,315,452 'curl':107,139,337,359,390,413,437,457,520,551 'd':160,381,478,541,572 'day':643 'default':201,269,603,639 'delet':393 'descript':228 'disclos':584 'edit':252,309,320,498,506,547,648 'email':621 'endpoint':137,356 'everi':590 'exampl':89,432 'exist':42,105,330 'expir':191,266,640 'expiresin':170,259,384 'explicit':218,608 'fals':214,297,606 'find':516 'first':87,130,436 'folder':231,232,237,429,435,454,480,505 'folder-scop':428,453 'folderid':234,235,481 'for-investor':543 'generat':18 'guest':39,287,630 'guest-sess':629 'guestemail':295 'guestnam':292 'guestuserid':291 'guestusernam':293 'h':109,146,155,339,367,376,398,415,439,464,473,527,536,558,567 'id':239,624 'immedi':638 'insid':593 'inspect':434 'investor':169,545 'isol':594 'jq':121,174,351,388,407,427,451,493,546,587 'key':67,74,93,96,114,117,151,154,344,347,372,375,403,406,420,423,444,447,469,472,532,535,563,566 'label':167,255,258,488 'legaci':71 'let':29 'link':21,44,48,50,58,135,204,224,257,302,331,333,353,409,456,496,499,504,517,591,597,626,635 'linkid':366,397 'list':332,408 'lose':636 'manag':41,55,329 'matrix':305 'metadata':633 'must':68 'n':574,575,577 'name':619 'nbe':578 'never':265 'new':203,596 'note':253,303,311,316,321,500,510,513,519,549,589 'notes/calendar':188 'notesaccess':165,249,382,486,647 'number':236,586 'oper':306 'os':136,355 'other':30 'overridden':645 'paramet':225,226 'patch':362,512,554 'per':495 'per-link':494 'permiss':189,254 'polici':497,507,518,548,576 'post':142,460,523 'prerequisit':64 'profession':579 'public':223,301 'puls':72,94,115,152,345,373,404,421,445,470,533,564 'queri':542 'read':164,166,241,242,244,250,307,485 'report':180 'requir':22,196,205,233,277,598 'requiresignin':172,209,213,267,386,491,605 'revok':389 'revoked/expired':634 'run':126,592 'sandbox':200 'scope':161,186,229,238,430,455,479,595 'search':509 'search/read':310 'secur':56,588 'session':288,631 'set':70,212,296,609 'share':2,12,43,47,51,134,184,431 'share-ag':1 'shareabl':20,57 'sign':24,194,207,280,285,600,611 'sign-in':23,193,206,599 'signed-in':279,284,610 'skill':6 'skill-share-agent' 'snapshot':325 'someon':17 'source-aicoo-team' 'store':502 'string':256 'sync':85,129 'talk':31 'team':489 'topic-agent' 'topic-agent-skills' 'topic-agentic-ai' 'track':290 'trigger':45 'true':173,210,271,273,387,492 'type':158,379,476,539,570 'unless':604,644 'updat':358 'update/revoke':352 'url':79,182 'use':4,90,646 'user':9,61,83,178,217,283,623 'usernam':620 'valu':227 'visitor':334,613 'want':10 'workflow':101 'write':36,246,251,308,383,487 'www.aicoo.io':81,119,144,349,364,395,425,449,462,525,556 'www.aicoo.io/api/v1':80 'www.aicoo.io/api/v1/os/folders':448 'www.aicoo.io/api/v1/os/network':348 'www.aicoo.io/api/v1/os/notes/123':555 'www.aicoo.io/api/v1/os/notes/search':524 'www.aicoo.io/api/v1/os/share':143,461 'www.aicoo.io/api/v1/os/share/':363,394 'www.aicoo.io/api/v1/os/share/list?status=active&limit=20':424 'www.aicoo.io/api/v1/os/status':118 'x':141,361,392,459,522,553 'yes':312,313,314,318,319,324,328","prices":[{"id":"9ecc7141-5447-4dea-b503-2ffacd612f37","listingId":"6abaa7ec-1bff-4224-b220-ebf3b3b00c40","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.854Z"}],"sources":[{"listingId":"6abaa7ec-1bff-4224-b220-ebf3b3b00c40","source":"github","sourceId":"Aicoo-Team/AICOO-Skills/share-agent","sourceUrl":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/share-agent","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:25.854Z","lastSeenAt":"2026-05-18T19:07:07.398Z"}],"details":{"listingId":"6abaa7ec-1bff-4224-b220-ebf3b3b00c40","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"Aicoo-Team","slug":"share-agent","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":"e879d28b5c1cf49146191336097b5ce09584052b","skill_md_path":"skills/share-agent/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/share-agent"},"layout":"multi","source":"github","category":"AICOO-Skills","frontmatter":{"name":"share-agent","description":"Use this skill when the user wants to share their AI agent with someone, generate a shareable link, require sign-in, allow anonymous access, let others talk to their agent, configure write access for guests, or manage existing shared links. Triggers on: 'share link', 'agent link', 'share my agent', 'let them talk to my AI', 'require sign-in', 'anonymous link', 'write access', 'edit access', 'guest permissions', or wanting to create a link for investors, prospects, partners, or anyone else to interact with their AI assistant."},"skills_sh_url":"https://skills.sh/Aicoo-Team/AICOO-Skills/share-agent"},"updatedAt":"2026-05-18T19:07:07.398Z"}}