Skill Marketplace

The Ameba-Claw Skill Marketplace is the official open repository hosted on GitHub, providing downloadable Skill packages that extend device functionality on demand. marketplace_search and marketplace_downloader are built-in Skills that ship with the Ameba-Claw firmware and are independent of the Skills available in the marketplace repository itself — the former handles searching the marketplace index, and the latter handles downloading and installing Skills from it. Together, these two Skills allow the Agent to complete the full workflow — searching, compatibility checking, downloading, and activating — entirely through conversation, without any manual filesystem operations.

Marketplace repository: https://github.com/Ameba-AIoT/ameba-claw-skills-marketplace

Note

Both Skills access github.com via the http_request Capability. Before use, ensure that github.com has been added to the HTTP request allowlist in the device configuration; otherwise operations will fail with an allowlist error.

Searching the Marketplace

marketplace_search is a knowledge-type Skill. Once activated, the Agent fetches the marketplace index, filters it in context by keyword, tag, or category, and returns matching results — including the exact id, description, and tags — to the user. The id returned in search results can be used directly for installation.

Describe what you are looking for in conversation to trigger a search:

Find Skills related to temperature and humidity in the marketplace
Search for LCD game Skills in the marketplace
What sensor Skills are available in the marketplace?

Note

marketplace_search only searches Skills in the marketplace; it does not include Skills already built into the device. After displaying the results, the Agent will prompt the user to install using the exact id.

Downloading and Installing a Skill

marketplace_downloader is a script-type Skill that downloads a specified Skill from the marketplace and installs it into the vfs:/skills/ directory, then automatically activates it in the current session.

Name the Skill you want to install in conversation:

Install dht11_temp_humidity
Get a Snake game from the marketplace
Install the ws2812_led_strip Skill

After installation, the Skill appears under vfs:/skills/ alongside user-created Skills. It can be viewed and edited through the file management interface, or invoked directly through conversation.

Peripheral Compatibility Check

Before installing, marketplace_downloader reads the target Skill’s metadata to verify that its peripheral requirements match the current board:

The Agent fetches the target Skill’s metadata and retrieves its peripheral dependency list.
If any peripheral dependencies exist, the Agent automatically activates board_hardware_info and queries each required peripheral or device for availability.
If all checks pass, installation proceeds. If any peripheral is missing, installation stops and the Agent reports which hardware is absent and which boards support it.

For example, when installing a game Skill that requires a touchscreen and IMU, if the current board has no touchscreen, the Agent will report:

Installation failed: the current board is missing touch_i2c_gt911_st7701p and imu_i2c_bmi270.
Boards that support these peripherals: PKE8721FLM-VA4-N33-HMI-ST7701P.

Note

To force-install on a board that does not meet the peripheral requirements, explicitly tell the Agent to skip the compatibility check. Whether the Skill functions correctly after a forced install depends on the actual hardware connected.

Available Skill Categories

Marketplace Skills are organized into the following categories. The repository is continuously updated; refer to GitHub for the latest list.

Category	Description
`sensor`	Sensor reading Skills that interface with common sensor modules (e.g. temperature/humidity, ambient light) via GPIO or a bus, and return readings to the Agent for reasoning
`control`	Actuator control Skills, including servo angle driving and addressable RGB LED strip control for scenarios requiring precise timing output
`app`	Application Skills for boards with a display, such as NTP-synchronized clocks and alarm clock apps
`game`	Game Skills for boards with a touchscreen or buttons, covering both classic and original titles
`network`	Network information Skills that retrieve live data — weather, cryptocurrency prices, public IP geolocation — via HTTP with no additional hardware required

Note

Installation requires the exact id from the marketplace (letters, digits, underscores, and hyphens only). Do not guess the name from a description. If unsure, use marketplace_search to confirm the id before installing.