X-Agents/account/admin/skills/system/install-hub-agent/SKILL.md

name, description, system, handler, tool-name, category

name	description	system	handler	tool-name	category
install-hub-agent	Download and install an Agent from the OpenAkita Platform Agent Store	true	agent_hub	install_hub_agent	Platform

install-hub-agent

Download and install an Agent from the OpenAkita Platform Agent Store to the local system.

When to Use

• User wants to install a specific Agent from the hub
• User says "安装这个 Agent" after browsing search results
• User provides an Agent ID to install

Workflow

1. (Optional) Call search_hub_agents first to find the Agent
2. (Optional) Call get_hub_agent_detail to preview Agent details
3. Call install_hub_agent with the agent_id
4. The system will:
   • Download the .akita-agent package from the platform
   • Extract and install bundled skills (version-aware, skips if same/newer exists locally)
   • Fetch required external skills from their original GitHub repos
   • Register the Agent profile locally
   • Auto-reload skills so the Agent is immediately usable

Tools

install_hub_agent

Parameter	Required	Description
agent_id	Yes	The platform Agent ID (from search results)
force	No	Force overwrite if local ID conflict (default: false)

get_hub_agent_detail

Parameter	Required	Description
agent_id	Yes	The platform Agent ID to inspect

Important Notes

• Installed Agents appear in the local Agent list immediately
• Bundled skills go to skills/custom/, external skills go to skills/community/
• Skills are version-deduplicated: if a newer version already exists locally, it is kept
• Each installed skill gets a .openakita-origin.json tracking its source and version
• The Agent's hub_source field records where it came from

Fallback

If the platform is unavailable, the user can still:

• Import Agents from .akita-agent files using import_agent
• Export local Agents using export_agent