Built-in Skills

Moxxy comes with a comprehensive set of built-in skills that enable agents to interact with systems, fetch data, and accomplish real tasks.

System Skills

host_shell

Execute shell commands on the host system.

<invoke name="host_shell">["ls -la"]</invoke>

Description: Run any bash/shell command natively on the host operating system.

Parameters:

• command (string): The shell command to execute

Capabilities Required:

• needs_fs_read (for read operations)
• needs_fs_write (for write operations)
• needs_network (for network commands)

Examples:

<invoke name="host_shell">["ls -la ~/Downloads"]</invoke>
<invoke name="host_shell">["mkdir -p /tmp/myproject"]</invoke>
<invoke name="host_shell">["curl -s https://api.example.com/data"]</invoke>

Security Note: This skill has full access to the host system. Use WASM mode for untrusted operations.

---

host_python

Execute Python scripts.

<invoke name="host_python">["print('Hello, World!')"]</invoke>

Description: Run Python code directly.

Parameters:

• code (string): Python code to execute
• args (array, optional): Arguments to pass

Examples:

<invoke name="host_python">["import json; print(json.dumps({'key': 'value'}))"]</invoke>
<invoke name="host_python">["import sys; print(sys.version)"]</invoke>

---

computer_control

macOS accessibility automation.

<invoke name="computer_control">["open", "Safari"]</invoke>

Description: Control macOS applications via accessibility APIs.

Parameters:

• action (string): Action to perform
• target (string, optional): Target application

Availability: macOS only

---

Network Skills

web_crawler

Fetch and parse web content.

<invoke name="web_crawler">["https://example.com"]</invoke>

Description: Crawl a URL using a headless browser and return extracted Markdown.

Parameters:

• url (string): URL to fetch
• selector (string, optional): CSS selector for content

Examples:

<invoke name="web_crawler">["https://news.ycombinator.com"]</invoke>
<invoke name="web_crawler">["https://example.com", "article"]</invoke>

---

browse_network

Network operations.

<invoke name="browse_network">["https://api.example.com/health"]</invoke>

Description: Perform HTTP requests and network operations.

---

Git Skills

git

Perform Git operations.

<invoke name="git">["status"]</invoke>

Description: Execute Git commands.

Parameters:

• command (string): Git command to run
• args (array, optional): Additional arguments

Examples:

<invoke name="git">["clone", "https://github.com/user/repo.git"]</invoke>
<invoke name="git">["status"]</invoke>
<invoke name="git">["commit", "-m", "Initial commit"]</invoke>
<invoke name="git">["push", "origin", "main"]</invoke>

---

Communication Skills

telegram_notify

Send Telegram notifications.

<invoke name="telegram_notify">["Alert: Server is down!"]</invoke>

Description: Send a message via Telegram to the connected user.

Parameters:

• message (string): Message to send

Requirements: Telegram channel must be configured

---

delegate_task

Delegate work to other agents.

<invoke name="delegate_task">["researcher", "Investigate the API documentation"]</invoke>

Description: Send a task to another agent and receive the result.

Parameters:

• agent_name (string): Target agent name
• task (string): Task description

Examples:

<invoke name="delegate_task">["analyst", "Analyze this CSV file for patterns"]</invoke>
<invoke name="delegate_task">["coder", "Review the pull request #42"]</invoke>

---

Scheduling Skills

scheduler

Schedule recurring jobs.

<invoke name="scheduler">["daily_report", "0 9 * * *", "Generate and send daily report"]</invoke>

Description: Create a cron-based scheduled task.

Parameters:

• name (string): Job name
• cron (string): Cron expression
• prompt (string): What to execute

Examples:

<invoke name="scheduler">["morning_brief", "0 8 * * *", "Send morning brief"]</invoke>
<invoke name="scheduler">["hourly_check", "0 * * * *", "Check server health"]</invoke>

---

modify_schedule

Modify an existing scheduled job.

<invoke name="modify_schedule">["daily_report", "0 10 * * *"]</invoke>

---

remove_schedule

Remove a scheduled job.

<invoke name="remove_schedule">["daily_report"]</invoke>

---

Skill Management Skills

create_skill

Create a new skill.

<invoke name="create_skill">["my_skill", "Does something useful", "#!/bin/bash\necho 'Hello'"]</invoke>

Parameters:

• name (string): Skill name
• description (string): Skill description
• code (string): Skill code/script

---

install_skill

Install a skill from source.

<invoke name="install_skill">["https://github.com/user/moxxy-skills/tree/main/custom_skill"]</invoke>

---

modify_skill

Modify an existing skill.

<invoke name="modify_skill">["my_skill", "#!/bin/bash\necho 'Updated'"]</invoke>

---

remove_skill

Remove a skill.

<invoke name="remove_skill">["my_skill"]</invoke>

---

upgrade_skill

Upgrade a skill to latest version.

<invoke name="upgrade_skill">["web_crawler"]</invoke>

---

list_skills

List all available skills.

<invoke name="list_skills">[]</invoke>

---

read_skill

Read a skill's source code.

<invoke name="read_skill">["web_crawler"]</invoke>

---

Vault Skills

manage_vault

Manage encrypted secrets.

<invoke name="manage_vault">["set", "API_KEY", "secret123"]</invoke>

Parameters:

• action (string): "get", "set", "delete", "list"
• key (string): Secret key
• value (string, optional): Secret value (for set)

Examples:

<invoke name="manage_vault">["set", "DB_PASSWORD", "mypass123"]</invoke>
<invoke name="manage_vault">["get", "DB_PASSWORD"]</invoke>
<invoke name="manage_vault">["delete", "OLD_KEY"]</invoke>
<invoke name="manage_vault">["list"]</invoke>

---

MCP Skills

mcp

Call Model Context Protocol server tools.

<invoke name="mcp">["server_name", "tool_name", {"param": "value"}]</invoke>

Description: Call tools from connected MCP servers.

Parameters:

• server (string): MCP server name
• tool (string): Tool name
• params (object): Tool parameters

Example:

<invoke name="mcp">["filesystem", "read_file", {"path": "/tmp/data.txt"}]</invoke>

---

Dev Mode Skills

evolve_core

Self-modify framework code.

<invoke name="evolve_core">["Add a new logging function"]</invoke>

Description: Allow the agent to modify its own codebase.

Availability: Development mode only (moxxy dev)

DANGER

This skill allows agents to modify framework code. Use with extreme caution.

---

Skill Summary Table

Skill	Description	Network	FS Read	FS Write
host_shell	Execute commands	✅	✅	✅
host_python	Run Python	✅	✅	✅
computer_control	macOS automation	-	-	-
web_crawler	Fetch web content	✅	-	-
browse_network	HTTP requests	✅	-	-
git	Git operations	✅	✅	✅
telegram_notify	Telegram messages	✅	-	-
delegate_task	Agent delegation	-	-	-
scheduler	Schedule tasks	✅	✅	-
modify_schedule	Modify schedule	-	-	-
remove_schedule	Remove schedule	-	-	-
create_skill	Create skill	-	-	✅
install_skill	Install skill	✅	-	✅
modify_skill	Modify skill	-	✅	✅
remove_skill	Remove skill	-	-	✅
upgrade_skill	Upgrade skill	✅	✅	✅
list_skills	List skills	-	-	-
read_skill	Read skill code	-	✅	-
manage_vault	Manage secrets	-	✅	✅
mcp	MCP tools	✅	✅	✅
evolve_core	Self-modify	✅	✅	✅