plugin-json

Configuration Schema

{
  "active": true,
  "hubId": "open-meteo-weather-api",
  "name": "Get Weather",
  "schema": "skill-1.0.0",
  "version": "1.0.0",
  "description": "Gets the weather for a given location latitude and longitude using the open-meteo API",
  "author": "@tcarambat",
  "author_url": "https://github.com/tcarambat",
  "license": "MIT",
  "setup_args": {
    "OPEN_METEO_API_KEY": {
      "type": "string",
      "required": false,
      "input": {
        "type": "text",
        "default": "YOUR_OPEN_METEO_API_KEY",
        "placeholder": "sk-1234567890",
        "hint": "The API key for the open-meteo API"
      },
      "value": ""
    }
  },
  "examples": [
    {
      "prompt": "What is the weather in Tokyo?",
      "call": "{\"latitude\": 35.6895, \"longitude\": 139.6917}"
    }
  ],
  "entrypoint": {
    "file": "handler.js",
    "params": {
      "latitude": {
        "description": "Latitude of the location",
        "type": "string"
      },
      "longitude": {
        "description": "Longitude of the location",
        "type": "string"
      }
    }
  },
  "imported": true
}

Property Reference

active

• Type: Boolean
• Description: Determines if the skill is loaded. Set to true to enable.

name

• Type: String
• Description: Human-readable display name in the UI.

hubId

• Type: String
• Description: Identifier matching the parent directory name.

Metadata Properties

• schema: String. Must be "skill-1.0.0". (Required)
• version: String. Custom version number. (Required)
• description: String. Short explanation of the skill. (Required)
• author: String. Author identifier. (Optional)
• author_url: String. URL to author profile. (Optional)
• license: String. License type (e.g., "MIT"). (Optional)

setup_args

Defines runtime arguments exposed in the UI and passed to handler.js.

• Key: Argument variable name.
• Properties:
  • type: Target data type (e.g., "string").
  • required: Boolean.
  • input: Object defining UI rendering.
    • type: Input element type (e.g., "text").
    • default: Default fallback value.
    • placeholder: Input field placeholder text.
    • hint: Help text.
  • value: Preset/hardcoded value (optional).

examples

Array of objects containing few-shot examples for the LLM.

• prompt: String. Sample user query.
• call: JSON String. Serialized arguments matching handler.js parameters.

entrypoint

Defines execution handler file and input validation.

• file: Path to execution file relative to plugin.json (typically "handler.js").
• params: Parameter objects. Each parameter requires:
  • description: String. Explanation of parameter purpose.
  • type: Data type. Supported: "string", "number", "boolean".

imported

• Type: Boolean
• Description: Must be set to true.