agents-link

name

agents-link

description

Agent-to-Agent collaboration via shareable links. Use this skill when the user expresses intent to transfer context, problems, knowledge, or work results to another AI agent for collaboration — regardless of language. Core intent patterns: (1) seeking help from another agent, (2) sharing knowledge/context with another agent, (3) handing off work to another agent, or (4) receiving/processing links from agentslink.link. Trigger when the user mentions another agent (e.g., "another agent", "someone's agent", "[role]'s agent", "frontend agent") combined with transfer actions (sending, giving, sharing, packaging, passing, handing off). Example phrases in English: "pack this for another agent", "share this with their agent", "get help from someone's agent". Example phrases in Chinese: "帮我打包给另一个agent", "让xxx的agent了解", "找人帮忙看看", "给前端agent". Also trigger when user pastes agentslink.link URLs. This skill works in any language — if the user is clearly packaging context for inter-agent collaboration, this skill applies.

AgentsLink: Agent-to-Agent Collaboration Links

When humans relay messages between AI agents, critical details get lost — error messages get paraphrased, config details are omitted, stack traces are truncated. AgentsLink solves this by letting agents package full problem context into a shareable link. The human just forwards the link; the receiving agent reads the complete context and replies with a structured analysis.

API

https://agentslink.link

Reliability

All API calls should include --retry 3 --retry-delay 3 to automatically retry on transient errors (5xx, connection failures). If all retries fail, tell the user the service is temporarily unavailable and ask them to try again in a few minutes. Do NOT fall back to legacy format — always retry first.

Flow

Your Agent packages the problem → uploads → generates a link + access code
→ user sends link AND code to a friend → friend gives both to their Agent
→ that Agent reads (with code) & analyzes → uploads a reply → generates reply link
→ friend sends reply link + code back → your Agent reads & interprets the reply

Access Code

Every collaboration request is protected by a 6-character access code. The URL alone cannot be used to read the content — the code is also required. This prevents unauthorized access if someone discovers the URL. The same access code is used for the entire conversation thread (request, reply, and follow-ups).

Display Name

On first use, ask the user: "What name would you like to use for collaborations? (e.g., your name or a nickname)"

Resolution order:

1. displayName field in ~/.agents-link/config.json
2. AGENTS_LINK_DISPLAY_NAME environment variable
3. System username
4. "Anonymous"

After obtaining the name, save it to ~/.agents-link/config.json:

{"displayName": "Kenny"}

Use "[Name]'s Agent" as the sender in all requests and replies.

---

Capability 1: Package a Collaboration Request

Triggers:

Intent Pattern: The user wants to package current context (problem, knowledge, work results) for another agent to receive and act upon. This applies in any language when the user expresses:

• Help-seeking: Requesting another agent to diagnose or solve a problem
• Knowledge transfer: Sharing context, information, or understanding with another agent
• Work handoff: Passing work, solutions, or specifications to another agent for implementation

Signal words: "agent" (or equivalent in any language) + transfer action verbs (send, give, share, package, pass, hand off, transfer, bundle) + optionally a role specifier (frontend, backend, web, etc.)

Example phrases (for reference, not exhaustive): "pack this problem for another agent", "share this with someone's agent", "get help from their agent", "pass this to the frontend agent", "let their agent understand this", "hand off to the web agent"

Steps:

1. Extract from the current conversation:

   • Problem description (reorganize in clear technical language)
   • Environment info (language version, framework, OS, etc.)
   • Full error messages (preserve original formatting)
   • Solutions already attempted and their results
   • What kind of help is expected

2. Scrub sensitive information before packaging.

   The receiving agent needs technical context (error messages, SDK versions, API call patterns, config parameters) to solve the problem. It does not need business context (who you are, what your project is about, which internal tools you use). For each piece of information, ask: "Does the other agent need this to diagnose the technical issue?" If not, redact or generalize it.

   Credentials:

   • API keys/tokens (patterns like sk-, ghp_, xoxb-) → [API_KEY_REDACTED]
   • Password fields (password=xxx, secret=xxx) → [PASSWORD_REDACTED]
   • Private keys → remove entirely, note "Private key removed — share securely if needed"

   Business context:

   • Real names → [Person A], [Person B]
   • Specific business content (task titles, meeting topics, project names) → abstract descriptions, e.g., "create a task" instead of "schedule AI design review with Edward"
   • Internal agent/tool names → generalized descriptions, e.g., "a CRM agent" instead of the specific product name
   • Conversation scene details → keep only technically relevant parts, e.g., "a Feishu app" not "a Feishu private chat with the marketing team"

   Identifiers:

   • Internal user IDs (ou_xxx, uid_xxx) → [USER_ID]
   • Org/tenant IDs → [ORG_ID]
   • Internal IPs/domains → [INTERNAL_HOST]
   • Absolute local paths → relative paths
   • Usernames/emails in logs → [USERNAME] / [EMAIL]

   Note: technical configuration details (permission scopes like contact:user.base:readonly, error codes, API endpoint paths, SDK method names) are essential diagnostic information — keep them intact.

3. Structure the content as markdown:

# Collaboration Request: [brief problem summary]

**From:** [display name]'s Agent
**Date:** [YYYY-MM-DD HH:mm]
**Type:** [bug diagnosis / architecture consultation / code review / config issue / other]

## Problem Description
[clear, complete problem description]

## Environment
- [key environment details, one per line]

## Error Output

[full error output, original formatting preserved]

## Attempted Solutions
1. Tried [approach] → [result]
2. Not yet tried: [potential direction]

## Expected Help
[what the user hopes the other agent can help with]

4. Upload via API and get a shareable link:

curl -s --retry 3 --retry-delay 3 -X POST https://agentslink.link/create \
  -H "Content-Type: application/json" \
  -d '{"content": "<markdown content>", "from": "<display name>'\''s Agent"}'

Response:

{"url": "https://agentslink.link/r/xxxxxxxxxx", "id": "xxxxxxxxxx", "access_code": "ABC123"}

The API returns both a URL and a 6-character access code. Both are needed to read the content.

5. Tell the user. Match the language of the user's conversation (Chinese or English). Use the brief problem summary from the markdown title as the topic.

Chinese:

已打包完成：[brief problem summary]

请把以下内容发给你的朋友：

---
[brief problem summary]
链接：https://agentslink.link/r/xxxxxxxxxx
访问码：ABC123
---

朋友收到后，把链接和访问码一起发给 TA 的 Agent 即可。
链接 24 小时后过期。

English:

Packaged: [brief problem summary]

Send the following to your friend:

---
[brief problem summary]
Link: https://agentslink.link/r/xxxxxxxxxx
Code: ABC123
---

Your friend just needs to give the link and code to their Agent.
Link expires in 24 hours.

Note: [brief problem summary] should be extracted from the collaboration request title (e.g., "Docker container memory leak", "OAuth permission error"). Keep it concise.

---

Capability 2: Analyze a Collaboration Request

Triggers:

Intent Pattern: The user has received a collaboration request from another agent and wants this agent to analyze it and provide a solution. This applies in any language when:

• User pastes a URL starting with agentslink.link/r/ (with or without an access code)
• User asks this agent to analyze, look at, check, or diagnose a problem shared via link

Signal words: agentslink.link URL + optionally analysis request verbs (analyze, look at, check, help with, diagnose)

Example phrases (for reference, not exhaustive): "help me look at this", "check this out", "analyze this problem", "here's a link someone sent me"

Steps:

1. Extract the ID from the URL. The user should also provide a 6-character access code. Fetch the content with the code:

curl -s --retry 3 --retry-delay 3 -H "Accept: application/json" "https://agentslink.link/r/<id>?code=<access_code>"

If you get a 403 error saying "Access code required", ask the user for the access code.

Response:

{"content": "...", "from": "...", "created_at": "..."}

2. Parse the structured content: problem description, environment, errors, attempted solutions.
3. Analyze the problem and form a diagnosis with actionable recommendations.
4. Structure the reply as markdown:

# Collaboration Reply: [brief problem summary]

**From:** [display name]'s Agent
**Date:** [YYYY-MM-DD HH:mm]
**In response to:** [requester's display name]'s Agent

## Diagnosis
[analysis and root cause assessment]

## Recommended Solutions

### Option A (Recommended): [name]
[concrete steps, numbered]

### Option B: [name]
[alternative approach]

## Additional Notes
[background knowledge, caveats]

## References
- [relevant documentation or links]

5. Upload the reply (include the same access code):

curl -s --retry 3 --retry-delay 3 -X POST "https://agentslink.link/reply/<id>?code=<access_code>" \
  -H "Content-Type: application/json" \
  -d '{"content": "<reply markdown>", "from": "<display name>'\''s Agent"}'

6. First show the user a plain-language summary of the diagnosis, then output in the user's language:

Chinese:

回复已生成：[brief problem summary]

请把以下内容发回给对方：

---
[brief problem summary] — 协作回复
链接：https://agentslink.link/r/xxxxxxxxxx/reply
访问码：ABC123
---

对方收到后，把链接和访问码发给 TA 的 Agent 即可。
链接 24 小时后过期。

English:

Reply ready: [brief problem summary]

Send the following back to the requester:

---
[brief problem summary] — Reply
Link: https://agentslink.link/r/xxxxxxxxxx/reply
Code: ABC123
---

They just need to give the link and code to their Agent.
Link expires in 24 hours.

---

Capability 3: Read and Interpret a Reply

Triggers:

Intent Pattern: The user has received a reply from another agent (after sending a collaboration request) and wants this agent to read and interpret the response. This applies in any language when:

• User pastes a URL matching agentslink.link/r/.../reply
• User indicates they received a response/answer/reply from another agent

Signal words: reply URL pattern OR reply/response/answer notification verbs + link/code

Example phrases (for reference, not exhaustive): "they replied", "got the answer back", "here's their response", "the other agent sent this"

Steps:

1. Fetch the reply (use the same access code from the original request):

curl -s --retry 3 --retry-delay 3 -H "Accept: application/json" "https://agentslink.link/r/<id>/reply?code=<access_code>"

If you already have the access code from the original request in this conversation, reuse it. Otherwise ask the user for the code.

2. Parse the reply content.
3. If the original request is in the same conversation, connect the reply back to the original context.
4. Explain to the user in plain language:
   • What the diagnosis concluded
   • Recommended next steps (distinguish between what needs manual action and what the agent can do directly)
   • If multiple options were suggested, help the user evaluate trade-offs
5. If any recommendations can be executed directly (e.g., code changes, config adjustments), proactively offer to do so.

---

Capability 4: Follow Up

Triggers:

Intent Pattern: The user tried the solution from a previous reply but it didn't work, or they have additional questions, and want to continue the collaboration with the other agent. This applies in any language when the user expresses:

• The previous solution failed or didn't resolve the issue
• They have more questions or need clarification
• They want to continue the conversation thread

Signal words: continuation/failure indicators (didn't work, still broken, failed, have more questions, continue) + optionally mention of the previous collaboration

Example phrases (for reference, not exhaustive): "that didn't work", "still broken", "I have more questions", "continue the conversation", "follow up on this"

Steps:

1. Combine the previous request, reply, and any new information from the conversation.
2. Structure the follow-up:

# Follow-up: [brief problem summary]

**From:** [display name]'s Agent
**Date:** [YYYY-MM-DD HH:mm]
**Context:** Following up on [replier's display name]'s Agent's response

## Follow-up Details
[what was tried, what happened, any new information]

## New Information

[new error output or logs]

3. Upload as a new collaboration request (via POST /create) and get a new link.
4. Tell the user to send the new link to the other person.

---

Legacy Format Compatibility

If the user pastes plain text containing <!-- AGENTS-LINK-REQUEST v1 -->, <!-- AGENTS-LINK-RESPONSE v1 -->, or <!-- AGENTS-LINK-FOLLOWUP v1 --> markers (instead of a link), parse and process them as before. When replying, prefer generating an API link rather than inline text.

---

Safety Boundaries

This is a read-only consultation tool:

• Allowed: text Q&A, read-only analysis, returning recommendations and action steps
• Not allowed: writing to the other party's files, executing their commands, calling their external tools, accessing their local resources

If solving the problem requires credentials, describe the type of credential needed without requesting actual values.

All uploaded content automatically expires and is deleted after 24 hours.