Marketplace - PauloCarv/drupalclaw-project GitHub Wiki

Marketplace

The Marketplace tab lets you browse and install skills from any external skill catalog — directly from the workspace, without leaving the browser.

DrupalClaw is catalog-agnostic: it works with any source that exposes skills in the open drupalclaw-marketplace.json format, whether public or private.

Using the Marketplace

Adding a catalog

  1. Open the Marketplace tab in the main area
  2. Paste a catalog URL into the input field and click Fetch
  3. The catalog name and available skills appear below

Installing a skill

  1. Browse or search the catalog
  2. Click Install next to any skill
  3. Send /restart in the chat to reload the agent with the new skill

Installed skills appear immediately in the Skills panel and in chat autocomplete, alongside built-in ones. They can also be used as steps in Flows.

Removing a skill

Delete the skill directory from /workspace/.pi/skills/<catalog-slug>-<skill-name>/ and send /restart.

Catalog format

A catalog is a JSON file served at a public or private URL. Minimal structure:

{
  "name": "My Skill Catalog",
  "slug": "my-catalog",
  "version": "1.0",
  "description": "A collection of skills for DrupalClaw.",
  "auth": "none",
  "skills": [
    {
      "name": "my-skill",
      "description": "Does something useful.",
      "url": "https://example.com/skills/my-skill/SKILL.md",
      "format": "skill.md"
    }
  ]
}

Fields

Field Required Description
name yes Display name shown in the Marketplace UI
slug yes Short identifier, lowercase, no spaces — used as skill name prefix
version no Catalog version string
description no One-line description shown in the catalog header
auth no "none" (default) or "token" for private catalogs
skills yes Array of skill entries (see below)

Skill entries

Field Required Description
name yes Skill name — installed as <slug>-<name>
description yes One-line description shown in the catalog list
url yes Direct URL to the SKILL.md file
format yes Always "skill.md" for SKILL.md format skills

Private catalogs

If "auth": "token" is set, DrupalClaw prompts once for a bearer token and stores it in /workspace/.pi/marketplace-<slug>.env as MARKETPLACE_TOKEN=<value>. The file matches the existing *.env gitignore glob and is never committed.

Installed skill location

Skills are written to /workspace/.pi/skills/<catalog-slug>-<skill-name>/SKILL.md. They are treated identically to built-in skills by the agent.

After a /restart, the skill is available as:

  • A chat command: type the skill name or /skill:<catalog-slug>-<skill-name>
  • A step type in Flows
  • An entry in the Skills panel sidebar

Related

⚠️ **GitHub.com Fallback** ⚠️