Plugin Skill

from webagents.agents.skills.local.plugin import PluginSkill

agent = BaseAgent(
    name="my-agent",
    skills={"plugin": PluginSkill()},
)

# Search for plugins
/plugin/search code review

# Install a plugin
/plugin/install code-review

# List installed plugins
/plugin/list

# Get plugin info
/plugin/info code-review

# Search with fuzzy matching
/plugin/search summarize text
# Finds: text-summarizer, summary-tool, summarization, etc.

# Install by name
/plugin/install text-summarizer

# Install from GitHub URL
/plugin/install https://github.com/user/my-plugin

# View installed plugin details
/plugin/info text-summarizer

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "My awesome plugin",
  "author": "Your Name",
  "license": "MIT",
  "commands": "./commands/",
  "skills": "./skills/",
  "agents": "./agents/",
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json",
  "dependencies": ["requests>=2.28"],
  "keywords": ["utility", "automation"],
  "repository": "https://github.com/user/my-plugin"
}

my-plugin/
├── plugin.json          # Plugin manifest (required)
├── commands/            # Python command scripts
│   ├── analyze.py
│   └── report.py
├── skills/              # SKILL.md files
│   └── review.md
├── hooks/               # Hook configurations
│   ├── hooks.json
│   └── on_message.py
└── .mcp.json           # MCP server configs (optional)

---
name: code-review
description: Review code for issues and improvements
disable-model-invocation: false
allowed-tools: [read_file, write_file]
context: inline
---

# Code Review Skill

Review the file at `$ARGUMENTS.file_path` for:

1. Code quality issues
2. Security vulnerabilities  
3. Performance improvements

Focus on: $ARGUMENTS.focus_areas

Review the repository at $ARGUMENTS.repo_path

Options:
- Include tests: $ARGUMENTS['include_tests']
- Max depth: $ARGUMENTS.depth

# commands/analyze.py
"""Analyze code for issues."""

import json
import os

def run(arguments):
    """Main entry point. Receives arguments dict."""
    file_path = arguments.get("file_path")
    
    # Do analysis...
    results = analyze_file(file_path)
    
    # Return dict for structured output
    return {
        "issues": results,
        "file": file_path
    }

if __name__ == "__main__":
    # For subprocess execution
    args = json.loads(os.environ.get("PLUGIN_ARGUMENTS", "{}"))
    result = run(args)
    print(json.dumps(result))

{
  "hooks": [
    {
      "event": "on_message",
      "handler": "./on_message.py",
      "priority": 50,
      "enabled": true
    },
    {
      "event": "on_tool_call",
      "handler": "./on_tool_call.py",
      "priority": 100
    }
  ]
}

# hooks/on_message.py
async def run(event_data):
    """Handle message event."""
    message = event_data.get("message")
    
    # Process message...
    
    return {
        "processed": True,
        "modified_message": message
    }

{
  "mcpServers": {
    "my-server": {
      "command": "python",
      "args": ["-m", "my_mcp_server"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

PluginSkill(config={
    # GitHub token for higher API rate limits
    "github_token": "ghp_...",
    
    # Custom plugins directory
    "plugins_dir": "/path/to/plugins",
    
    # Disable background refresh
    "auto_refresh": False,
})

from webagents.agents.skills.local.plugin import PluginLoader

loader = PluginLoader()

# Load from local path
plugin = loader.load_local(Path("./my-plugin"))

# Install from Git
plugin = await loader.install_from_repo("https://github.com/user/plugin")

# List installed
plugins = loader.list_installed()

# Uninstall
loader.uninstall("plugin-name")

from webagents.agents.skills.local.plugin import MarketplaceClient

client = MarketplaceClient(github_token="...")

# Load cached index
client.load_cached_index()

# Refresh from API
await client.refresh_index()

# Search plugins
results = client.search("code review", limit=10)

# Get by name
plugin = client.get("code-review")

mkdir my-plugin && cd my-plugin

# Create manifest
cat > plugin.json << 'EOF'
{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "My first plugin",
  "commands": "./commands/",
  "skills": "./skills/"
}
EOF

# Create a command
mkdir commands
cat > commands/hello.py << 'EOF'
"""Say hello."""
def run(args):
    name = args.get("name", "World")
    return {"message": f"Hello, {name}!"}
EOF

# Create a skill
mkdir skills
cat > skills/greet.md << 'EOF'
---
name: greet
description: Greet the user
---
Please greet $ARGUMENTS.name warmly.
EOF

rapidfuzz>=3.0     # Fuzzy search
pyyaml>=6.0        # YAML frontmatter parsing
gitpython>=3.1     # Git repository installation
httpx>=0.25        # HTTP client for marketplace API