Add sample plugins for testing and training

[jpshackelford]

Summary

Add two sample plugins from jpshackelford/openhands-sample-plugins for testing plugin infrastructure and training users on the plugin format.

Added Plugins

city-weather

Get current weather, time, and precipitation forecast for any city using the free Open-Meteo API (no API key required).

Features:

• Provides slash command /city-weather:now <city>
• Shows temperature in both Fahrenheit and Celsius
• Displays precipitation forecast for next 4 hours

Usage:

/city-weather:now New York
/city-weather:now Tokyo
/city-weather:now London

magic-test

A simple test plugin for verifying plugin loading works correctly.

Features:

• Triggers on magic words: "alakazam", "abracadabra", "magic word"
• Returns a specific phrase to verify plugins are working correctly

Purpose:

• Verify that plugins are fetched correctly from the repository
• Confirm skill loading and merging into agent context
• Test that skill triggers are working properly

Testing

These plugins were originally developed and tested in the source repository and follow the Claude Code plugin marketplace format.

@jpshackelford can click here to continue refining the PR

[jpshackelford]

Note that the use of .claude-plugin folder here is intentional as the city-weather plugin is used to demonstrate Claude / OpenHands plugin compatibility.

[neubig]

Note that the use of .claude-plugin folder here is intentional as the city-weather plugin is used to demonstrate Claude / OpenHands plugin compatibility.

Are you sure that claude plugins need this though? I think they can also just support .plugin, which would be more natural here.

[juanmichelini]

LGTM

[jpshackelford]

I investigated this and unfortunately Claude Code only supports .claude-plugin - it does not recognize .plugin as an alternative.

Tested with Claude Code v2.1.62 using non-interactive validation:

# With .claude-plugin directory - works
claude plugin validate plugins/city-weather
# ✔ Validation passed

# With only .plugin directory (renamed .claude-plugin away) - fails
claude plugin validate plugins/city-weather
# ✘ Found 1 error:
#   ❯ directory: No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json

The CLI explicitly looks for .claude-plugin/plugin.json or .claude-plugin/marketplace.json - there's no fallback to .plugin.

So the current structure with .claude-plugin/plugin.json in each plugin directory is correct and required for Claude Code compatibility.