rf-agentskills

Robot Framework Agent Skills for Claude Code

A Claude Code plugin marketplace providing AI agent skills for Robot Framework test automation. Includes skills for web testing (Browser/Selenium), API testing (Requests/RESTinstance), mobile testing (Appium), asset generation, and RF analysis tools.

Quick Install

Claude Code Plugin

# Install as Claude Code Plugin
claude plugin add github:manykarim/robotframework-agentskills

# Or install skills directly to your project
cp -r skills/robotframework-browser-skill .claude/skills/

VS Code Extension

# Install from VSIX
code --install-extension vscode-extension/robotframework-agentskills-1.0.0.vsix

Standalone (Without Plugin System)

# Load the plugin directory directly
claude --plugin-dir ./plugins/rf-agentskills

Or copy individual skills from skills/ to your project's .claude/skills/ for standalone usage without the plugin system.

What You Get

11 Skills

Skill	Type	Command	Description
Browser Library	library-reference	/rf-agentskills:browser	Web testing with Playwright (auto-waiting, assertions, Shadow DOM)
SeleniumLibrary	library-reference	/rf-agentskills:selenium	Web testing with Selenium WebDriver
AppiumLibrary	library-reference	/rf-agentskills:appium	Mobile testing for iOS and Android
RequestsLibrary	library-reference	/rf-agentskills:requests	REST API testing with HTTP methods
RESTinstance	library-reference	/rf-agentskills:restinstance	REST API testing with JSON Schema validation
Keyword Builder	script-based	/rf-agentskills:keyword-builder	Generate RF user keywords from structured input
Test Case Builder	script-based	/rf-agentskills:testcase-builder	Generate RF test cases from structured input
Resource Architect	script-based	/rf-agentskills:resource-architect	Design resource/variable file layouts
Libdoc Search	script-based	/rf-agentskills:libdoc-search	Search library keywords by use case
Libdoc Explain	script-based	/rf-agentskills:libdoc-explain	Explain keyword arguments and documentation
Results	script-based	/rf-agentskills:results	Parse output.xml into JSON summaries (requires robotframework)

The 5 library-reference skills provide documentation and usage guidance. The 6 script-based skills execute Python scripts to generate code or analyze artifacts. Library-reference skills cross-reference their companion script-based skills (e.g., the Browser skill suggests using Keyword Builder and Libdoc Search).

4 Specialized Agents

Agent	Purpose
RF Test Architect	Plan test suites, select libraries, design project structure
RF Debug Expert	Diagnose test failures, analyze output.xml, fix flaky tests
RF Keyword Consultant	Find, explain, and compare keywords across libraries
RF Migration Guide	Upgrade RF versions, migrate between libraries

Automated Hooks

• Post-save validation: Automatically validates .robot files after every write/edit
• Skill routing: Routes RF-related prompts to the appropriate skill or agent
• Environment check: Checks for installed RF packages at session start
• Test reminder: Reminds you to run tests when the session ends

Prerequisites

• Claude Code 1.0.33 or later
• Python 3.8+ (for builder and tool scripts)
• robotframework Python package (required for libdoc-search, libdoc-explain, and results skills)

pip install robotframework

All scripts handle a missing robotframework package gracefully -- script-based skills that do not require it (keyword-builder, testcase-builder, resource-architect) work with the Python standard library alone.

Optional libraries (for their respective skills):

pip install robotframework-browser    # Browser skill
pip install robotframework-seleniumlibrary  # Selenium skill
pip install robotframework-appiumlibrary    # Appium skill
pip install robotframework-requests   # Requests skill
pip install RESTinstance              # RESTinstance skill

Team Distribution

Add to your project's .claude/settings.json to auto-configure for your team:

{
  "extraKnownMarketplaces": {
    "robotframework-agentskills": {
      "source": {
        "source": "github",
        "repo": "manykarim/robotframework-agentskills",
        "ref": "stable"
      }
    }
  },
  "enabledPlugins": {
    "rf-agentskills@robotframework-agentskills": true
  }
}

What is an Agent Skill?

Agent Skills are modular, self-contained packages that include a SKILL.md file (instructions) plus optional scripts, references, and assets. AI agents load a skill when its name or description matches the user request. Skills use progressive disclosure: only metadata is loaded initially; the full skill body and references are loaded on demand.

Project Structure