Agent skill

ui-links

Use this skill when users ask to view, display, or open attachments (images, files), or need to navigate to Wegent pages. Supports attachment:// and wegent:// protocols for clickable links that the frontend renders as previews or navigation.

View SKILL.md on GitHub Repository
Stars 518
Forks 84

Install this agent skill to your Project

npx add-skill https://github.com/wecode-ai/Wegent/tree/main/backend/init_data/skills/ui-links

SKILL.md

UI Links

This skill enables you to output special protocol links that the Wegent frontend renders as interactive elements. Use these links to display attachments or provide navigation to Wegent pages.

When to Use

Use this skill when:

  • User asks to "show", "view", "display", or "open" an attachment (image, file, etc.)
  • User wants to navigate to a specific Wegent page (settings, chat, knowledge base, etc.)
  • User needs quick actions like creating tasks, sending messages, or exporting data
  • You need to provide clickable navigation within your response

Important: You do NOT need to call any tools. Simply output the markdown links directly in your response.

Protocol Reference

1. Attachment Protocol (attachment://)

Display attachments (images, files) that exist in the conversation.

Format:

markdown
![description](attachment://ID)

Parameters:

  • ID (required): The numeric attachment ID (positive integer)

Example:

markdown
![Project Screenshot](attachment://106)

How it works:

  • The frontend automatically renders the attachment as a clickable preview
  • For images: displays an inline preview that can be expanded
  • For files: displays a file card with download option

2. Wegent Protocol (wegent://)

Navigate to Wegent pages or trigger actions.

Format:

markdown
[link text](wegent://type/path?params)

Structure:

  • type: Category of operation (open, form, action)
  • path: Specific target within the type
  • params: Optional query parameters

Available Routes

Navigation Routes (wegent://open/*)

Open Wegent pages directly.

Route Description Parameters
wegent://open/chat Open chat page team (optional): Team ID
wegent://open/code Open code page team (optional): Team ID
wegent://open/settings Open settings page tab (optional): integrations, bot, team, models
wegent://open/knowledge Open knowledge base Path parameter for project ID
wegent://open/feed Open activity feed None
wegent://open/feedback Open feedback dialog None

Examples:

markdown
[Open Settings](wegent://open/settings)
[Configure Integrations](wegent://open/settings?tab=integrations)
[Go to Chat](wegent://open/chat?team=123)
[View Knowledge Base](wegent://open/knowledge/456)

Form Routes (wegent://form/*)

Open dialogs to create resources.

Route Description Parameters
wegent://form/create-task Open create task dialog team (optional): Pre-select team
wegent://form/create-team Open create agent dialog None
wegent://form/create-bot Open create bot dialog None
wegent://form/add-repository Open add repository dialog None
wegent://form/create-subscription Open create subscription dialog data (optional): JSON-encoded form data

Examples:

markdown
[Create New Task](wegent://form/create-task)
[Create Task for Team 123](wegent://form/create-task?team=123)
[Add New Agent](wegent://form/create-team)
[Add Repository](wegent://form/add-repository)

Action Routes (wegent://action/*)

Trigger actions directly.

Route Description Parameters
wegent://action/send-message Send a message automatically text (required), team (optional)
wegent://action/prefill-message Prefill message input text (required), team (optional)
wegent://action/share Generate and copy share link type, id (optional, uses current task)
wegent://action/export-chat Export chat history taskId (optional, uses current task)
wegent://action/export-task Export task details taskId (optional, uses current task)
wegent://action/export-code Export code file taskId, fileId (optional)

Examples:

markdown
[Send Hello](wegent://action/send-message?text=Hello)
[Try this prompt](wegent://action/prefill-message?text=Explain%20this%20code)
[Share Task](wegent://action/share)
[Export Chat](wegent://action/export-chat)

Usage Examples

Example 1: Display an Attachment

When user says "show me attachment 106":

markdown
Here is the attachment you requested:

![Attachment 106](attachment://106)

Example 2: Navigate to Settings

When user asks "how do I configure integrations":

markdown
You can configure integrations in the settings page:

[Open Integrations Settings](wegent://open/settings?tab=integrations)

Example 3: Help User Create a Task

When user wants to start a new task:

markdown
Click below to create a new task:

[Create New Task](wegent://form/create-task)

Example 4: Provide Quick Action

When user wants to try a specific prompt:

markdown
Click to try this prompt:

[Explain this code](wegent://action/prefill-message?text=Please%20explain%20this%20code%20in%20detail)

Example 5: Export Current Conversation

When user wants to save the chat:

markdown
You can export this conversation:

[Export Chat History](wegent://action/export-chat)

Best Practices

  1. Use descriptive link text: Make it clear what clicking will do

    • Good: [Open Settings Page](wegent://open/settings)
    • Bad: [Click here](wegent://open/settings)

  2. URL-encode special characters: Use %20 for spaces in parameters

    • wegent://action/prefill-message?text=Hello%20World

  3. Provide context: Explain what the link does before showing it

  4. Use appropriate protocol:

    • attachment:// for files/images
    • wegent://open/* for navigation
    • wegent://form/* for creating resources
    • wegent://action/* for triggering actions

Troubleshooting

Issue Possible Cause Solution
Link not rendering Incorrect markdown format Ensure format is [text](url) or ![alt](url)
Attachment not found Invalid attachment ID Verify the ID exists in the conversation
Action not working Missing required parameter Check that required params like text are provided
Navigation fails Invalid route Verify the route exists in the reference above
Special characters breaking URL Not URL-encoded Encode spaces as %20, etc.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

wecode-ai/Wegent

wiki_submit

Submit wiki documentation sections to Wegent backend API. Simplifies the HTTP POST process for wiki content submission.

518 84
Explore
wecode-ai/Wegent

subscription-manager

Create and manage scheduled subscription tasks. Use when the user wants to set up recurring reminders, periodic reports, scheduled checks, or any automated tasks that run on a schedule. Supports cron expressions, fixed intervals, and one-time executions.

518 84
Explore
wecode-ai/Wegent

conversation_to_prompt

Convert the current conversation into a reusable system prompt draft with strict structure and quality checks.

518 84
Explore
wecode-ai/Wegent

mermaid-diagram

Use this skill when you need to draw diagrams including: Flowchart, Sequence Diagram, Class Diagram, State Diagram, ER Diagram, User Journey, Gantt Chart, Pie Chart, Quadrant Chart, Requirement Diagram, Gitgraph, Mindmap, Timeline, Sankey, XY Chart (Bar/Line), Block Diagram, Packet Diagram, Kanban, Architecture Diagram, C4 Diagram, Radar Chart, Treemap, and ZenUML. You MUST use this skill BEFORE outputting any mermaid code block.

518 84
Explore
wecode-ai/Wegent

wegent-knowledge

Knowledge base management tools for Wegent. Provides capabilities to list, create, and update knowledge bases and documents. Use this skill when the user wants to manage knowledge bases or documents programmatically.

518 84
Explore
wecode-ai/Wegent

sandbox

Provides read_file/write_file/exec/list_files/read_file/write_file for running process and managing filesystems in the sandbox. Ideal for code testing, file management, and command execution. The sub_claude_agent tool is available for advanced use cases. You MUST load this skill BEFORE use sandbox tools.

518 84
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results