Skip to content

README.md

Latest commit

 

History

History
115 lines (80 loc) · 5.47 KB

README.md

File metadata and controls

115 lines (80 loc) · 5.47 KB

robotframework-agent-plugins

A curated Open Plugins marketplace for Robot Framework — Skills (and more plugin components over time) that extend AI coding agents like Claude Code, GitHub Copilot, and Codex with Robot Framework expertise.

Plugins in this marketplace

Plugin What it does
robotcode Teaches AI coding agents to drive robotcode properly in Robot Framework projects.

More plugins are planned — Browser Library, RequestsLibrary, and general Robot Framework patterns.

Before you install

Plugins from this marketplace follow the Open Plugin Specification. Check whether your agent currently supports the spec at https://open-plugins.com/supported-agents. If it doesn't, the marketplace files in this repo will not be discovered — even if the plugin contents themselves would work standalone.

Every agent uses its own command surface to add a marketplace and install a plugin. Pick the section for your agent below.

Install per agent

Claude Code

claude plugin marketplace add robotcodedev/robotframework-agent-plugins
claude plugin install robotcode@robotframework-agent-plugins

Update with claude plugin marketplace update once the marketplace is registered. See Claude Code plugin docs for version pinning (@<ref>) and uninstall.

GitHub Copilot CLI

copilot plugin marketplace add robotcodedev/robotframework-agent-plugins
copilot plugin install robotcode@robotframework-agent-plugins

See GitHub Copilot CLI plugin marketplaces.

GitHub Copilot Chat (VS Code)

Add the marketplace to your User Settings:

// settings.json
"chat.plugins.marketplaces": [
  "robotcodedev/robotframework-agent-plugins"
]

Then install plugins from the Extensions view's Chat Plugins section.

The RobotCode VS Code extension already ships the robotcode plugin built-in via contributes.chatPlugins — you only need this marketplace if you want to mix in future plugins from it.

Codex

codex plugin marketplace add robotcodedev/robotframework-agent-plugins
codex plugin add robotcode@robotframework-agent-plugins

See Codex plugin docs.

Other Open-Plugins-compliant agents

If your agent implements the Open Plugin spec but isn't listed above, the install pattern is usually the same shape:

  1. Register the marketplace by repository — <tool> plugin marketplace add robotcodedev/robotframework-agent-plugins (or via the agent's settings / UI).
  2. Install an individual plugin — <tool> plugin install <plugin>@robotframework-agent-plugins.

Consult your agent's documentation for the exact command name and any required preview/beta flags.

Repository layout

.plugin/marketplace.json          ← Open Plugins spec marketplace manifest
.claude-plugin/marketplace.json   ← Claude Code copy (same schema, tool-specific path)
.agents/plugins/marketplace.json  ← Codex copy (different schema, tool-specific path)
plugins/
└── robotcode/
    ├── .plugin/plugin.json       ← Open Plugins manifest
    ├── .codex-plugin/plugin.json ← Codex copy (same data, tool-specific path)
    └── skills/robotcode/
        ├── SKILL.md
        └── references/

Each plugin is its own directory under plugins/. The marketplace manifest and per-plugin manifest are duplicated at tool-specific paths because each agent reads only its own location:

Tool Marketplace path Plugin manifest path Schema
Open Plugins (Copilot CLI, …) .plugin/marketplace.json <plugin>/.plugin/plugin.json Open Plugins spec
Claude Code .claude-plugin/marketplace.json <plugin>/.claude-plugin/plugin.json (if present, else .plugin/) same as Open Plugins
Codex .agents/plugins/marketplace.json <plugin>/.codex-plugin/plugin.json Codex-specific (source object, policy, category, interface)

Contributing

Plugins are reviewed for quality, accurate documentation, and license compatibility with Apache-2.0. To submit a plugin:

  1. Add your plugin under plugins/<your-plugin>/ with at minimum:
    • .plugin/plugin.json (Open Plugins spec manifest, "license": "Apache-2.0").
    • A skill, agent, hook, or MCP/LSP config — whatever the plugin provides.
    • A README.md describing what it does, prerequisites, and how the agent activates it.
    • A LICENSE file (Apache-2.0 — copy the one at the repo root) so the plugin stays self-contained when an agent caches it independently of this marketplace.
  2. Register the plugin once in the source marketplace catalog .plugin/marketplace.json (Open Plugins schema).
  3. If your plugin needs a Codex category other than the default, add it to CODEX_PLUGIN_CATEGORIES in scripts/sync_manifests.py.
  4. Run the manifest generator to populate the Claude and Codex copies: 
    python scripts/sync_manifests.py
    This writes .claude-plugin/marketplace.json, .agents/plugins/marketplace.json, and each plugins/<name>/.codex-plugin/plugin.json. Run python scripts/sync_manifests.py --check in CI / before pushing to verify nothing drifted.
  5. Open a PR.

License

Apache-2.0