robotframework-plugins 2026.11.0.dev1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- robotframework_plugins/__init__.py +14 -0
- robotframework_plugins/_assets/catalog.json +143 -0
- robotframework_plugins/_assets/plugins/rf-agentskills/.claude-plugin/plugin.json +25 -0
- robotframework_plugins/_assets/plugins/rf-agentskills/CHANGELOG.md +198 -0
- robotframework_plugins/_assets/plugins/rf-agentskills/README.md +27 -0
- robotframework_plugins/_assets/plugins/rf-agentskills/catalog.yaml +25 -0
- robotframework_plugins/_assets/plugins/rf-api/.claude-plugin/plugin.json +25 -0
- robotframework_plugins/_assets/plugins/rf-api/CHANGELOG.md +9 -0
- robotframework_plugins/_assets/plugins/rf-api/README.md +27 -0
- robotframework_plugins/_assets/plugins/rf-api/catalog.yaml +27 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/SKILL.md +110 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/authentication-patterns.robot +39 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/basic-crud.robot +46 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/file-upload.robot +28 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/session-handling.robot +48 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/authentication.md +58 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/install.md +10 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/request-options.md +90 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/response-validation.md +64 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/troubleshooting.md +64 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/SKILL.md +119 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/basic-rest.robot +51 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schema-validation.robot +38 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schemas/user.json +10 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/authentication.md +61 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/install.md +11 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/json-handling.md +89 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/migrate-from-requests.md +15 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/schema-validation.md +85 -0
- robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/troubleshooting.md +68 -0
- robotframework_plugins/_assets/plugins/rf-core/.claude-plugin/plugin.json +19 -0
- robotframework_plugins/_assets/plugins/rf-core/CHANGELOG.md +11 -0
- robotframework_plugins/_assets/plugins/rf-core/README.md +38 -0
- robotframework_plugins/_assets/plugins/rf-core/agents/rf-debug-expert.md +104 -0
- robotframework_plugins/_assets/plugins/rf-core/agents/rf-migration-guide.md +73 -0
- robotframework_plugins/_assets/plugins/rf-core/agents/rf-test-architect.md +98 -0
- robotframework_plugins/_assets/plugins/rf-core/catalog.yaml +19 -0
- robotframework_plugins/_assets/plugins/rf-core/hooks/README.md +435 -0
- robotframework_plugins/_assets/plugins/rf-core/hooks/hooks.json +70 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/_hook_input.mjs +101 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/_pending_errors.mjs +65 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/_python_env.mjs +181 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/check_rf_environment.mjs +181 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_inject_rf_context.mjs +74 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_remind_robot_tests.mjs +108 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/report_pending_errors.mjs +72 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/rf_error_hints.mjs +126 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot.mjs +509 -0
- robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot_project.mjs +103 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/SKILL.md +313 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/api.resource +30 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/calc.resource +23 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/embedded.resource +20 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/keywords.resource +26 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/login.resource +10 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/01__keyword_driven.robot +15 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/02__data_driven.robot +10 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/03__templates.robot +17 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/04__bdd.robot +10 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/05__embedded.robot +13 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/__init__.robot +6 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/__init__.robot +7 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/users.robot +18 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/env.robot +15 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/common.py +11 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/dev.yaml +3 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/staging.yaml +3 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/arguments.md +139 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/control-structures.md +175 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/embedded-arguments.md +135 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/migration.md +90 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/resources-and-variable-files.md +127 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/styles.md +92 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/suites-and-init.md +96 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/tags-and-selection.md +104 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/templates.md +124 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/variables-and-scopes.md +129 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/scripts/rf_conventions.py +883 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/SKILL.md +216 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ExampleLibrary.py +61 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ResultListener.py +60 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.py +48 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.robot +20 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/example_library.robot +31 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/listener.robot +12 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/api-variants.md +291 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/communication.md +248 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/conversion.md +347 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/listeners.md +150 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/packaging-and-docs.md +155 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/scripts/check_library.py +842 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/SKILL.md +159 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/github-actions-robot.yml +32 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/gitignore.txt +22 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.poetry.toml +28 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.uv.toml +20 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/requirements.txt +9 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/robot.toml +16 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/smoke.robot +22 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/ci.md +61 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/cli-tools.md +33 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/libraries.md +47 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/poetry.md +77 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/project-layout.md +86 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/troubleshooting.md +73 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/uv.md +108 -0
- robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/venv-pip.md +71 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-debug-expert.toml +103 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-migration-guide.toml +72 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-test-architect.toml +97 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-debug-expert.md +107 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-migration-guide.md +76 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-test-architect.md +101 -0
- robotframework_plugins/_assets/plugins/rf-core/variants/opencode/plugins/rf-core.js +93 -0
- robotframework_plugins/_assets/plugins/rf-desktop/.claude-plugin/plugin.json +24 -0
- robotframework_plugins/_assets/plugins/rf-desktop/CHANGELOG.md +9 -0
- robotframework_plugins/_assets/plugins/rf-desktop/README.md +26 -0
- robotframework_plugins/_assets/plugins/rf-desktop/catalog.yaml +23 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/SKILL.md +266 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/calculator.robot +45 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/mock-deterministic.robot +33 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/cli-and-inspector.md +82 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/install.md +14 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/keywords-reference.md +102 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/locators-and-queries.md +95 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/platform-setup.md +65 -0
- robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/status-and-migration.md +41 -0
- robotframework_plugins/_assets/plugins/rf-mobile/.claude-plugin/plugin.json +24 -0
- robotframework_plugins/_assets/plugins/rf-mobile/CHANGELOG.md +9 -0
- robotframework_plugins/_assets/plugins/rf-mobile/README.md +26 -0
- robotframework_plugins/_assets/plugins/rf-mobile/catalog.yaml +23 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/SKILL.md +134 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/android-basic.robot +60 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/gestures-example.robot +59 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/hybrid-app.robot +54 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/ios-basic.robot +48 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/capabilities.md +117 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/gestures-touch.md +84 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/install.md +21 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/locators-mobile.md +74 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/platform-specific.md +105 -0
- robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/troubleshooting.md +70 -0
- robotframework_plugins/_assets/plugins/rf-web/.claude-plugin/plugin.json +25 -0
- robotframework_plugins/_assets/plugins/rf-web/CHANGELOG.md +9 -0
- robotframework_plugins/_assets/plugins/rf-web/README.md +27 -0
- robotframework_plugins/_assets/plugins/rf-web/catalog.yaml +27 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/SKILL.md +132 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/authentication-flow.robot +34 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/basic-web-test.robot +29 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/form-handling.robot +49 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/iframe-shadow-dom.robot +31 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/assertion-engine.md +79 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/authentication-storage.md +86 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/browser-context-page.md +110 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/downloads-uploads.md +51 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/iframes-shadow-dom.md +67 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/install.md +67 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/locators.md +83 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/migrate-from-selenium.md +22 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/troubleshooting.md +100 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/SKILL.md +123 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/basic-web-test.robot +64 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/multi-window.robot +55 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/wait-patterns.robot +53 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/browser-setup.md +103 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/frames-windows.md +84 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/install.md +12 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/javascript-execution.md +65 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/locators.md +86 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/troubleshooting.md +122 -0
- robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/waiting-strategies.md +84 -0
- robotframework_plugins/_assets.py +120 -0
- robotframework_plugins/_catalog.py +123 -0
- robotframework_plugins/_snapshot.py +230 -0
- robotframework_plugins/adapters/__init__.py +53 -0
- robotframework_plugins/adapters/_base.py +400 -0
- robotframework_plugins/adapters/claude_code.py +312 -0
- robotframework_plugins/adapters/claude_desktop.py +129 -0
- robotframework_plugins/adapters/codex.py +276 -0
- robotframework_plugins/adapters/copilot.py +87 -0
- robotframework_plugins/adapters/cursor.py +295 -0
- robotframework_plugins/adapters/goose.py +240 -0
- robotframework_plugins/adapters/opencode.py +170 -0
- robotframework_plugins/bundle.py +85 -0
- robotframework_plugins/cli.py +1311 -0
- robotframework_plugins/detect.py +121 -0
- robotframework_plugins/manifest.py +338 -0
- robotframework_plugins/py.typed +0 -0
- robotframework_plugins/skillzip.py +39 -0
- robotframework_plugins/transforms.py +725 -0
- robotframework_plugins-2026.11.0.dev1.dist-info/METADATA +178 -0
- robotframework_plugins-2026.11.0.dev1.dist-info/RECORD +195 -0
- robotframework_plugins-2026.11.0.dev1.dist-info/WHEEL +4 -0
- robotframework_plugins-2026.11.0.dev1.dist-info/entry_points.txt +2 -0
- robotframework_plugins-2026.11.0.dev1.dist-info/licenses/LICENSE +201 -0
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
"""robotframework-plugins — cross-agent installer for Robot Framework agent plugins.
|
|
2
|
+
|
|
3
|
+
The package bundles the plugin tree (skills, subagents, hooks, scripts)
|
|
4
|
+
inside ``robotframework_plugins/_assets/`` and provides per-agent adapters that
|
|
5
|
+
copy / transform that tree into each target's expected install paths.
|
|
6
|
+
|
|
7
|
+
See ``docs/installer/proposal.md`` (in the source repo) for the full
|
|
8
|
+
design and compatibility matrix.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
__version__ = "2026.11.0.dev1"
|
|
14
|
+
__all__ = ("__version__",)
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
{
|
|
2
|
+
"format": 1,
|
|
3
|
+
"plugins": [
|
|
4
|
+
{
|
|
5
|
+
"name": "rf-agentskills",
|
|
6
|
+
"version": "4.0.0",
|
|
7
|
+
"tier": "verified",
|
|
8
|
+
"status": "active",
|
|
9
|
+
"summary": "All Robot Framework plugins in one install (rf-core, rf-web, rf-api, rf-mobile, rf-desktop), as one plugin.",
|
|
10
|
+
"libraries": [],
|
|
11
|
+
"robotframework": ">=7.0",
|
|
12
|
+
"dependencies": [],
|
|
13
|
+
"bundle": true,
|
|
14
|
+
"bundled": [
|
|
15
|
+
"rf-core",
|
|
16
|
+
"rf-web",
|
|
17
|
+
"rf-api",
|
|
18
|
+
"rf-mobile",
|
|
19
|
+
"rf-desktop"
|
|
20
|
+
]
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"name": "rf-api",
|
|
24
|
+
"version": "1.0.0",
|
|
25
|
+
"tier": "verified",
|
|
26
|
+
"status": "active",
|
|
27
|
+
"summary": "RequestsLibrary and RESTinstance skills for API tests.",
|
|
28
|
+
"libraries": [
|
|
29
|
+
{
|
|
30
|
+
"name": "RequestsLibrary",
|
|
31
|
+
"package": "robotframework-requests",
|
|
32
|
+
"versions": ">=0.9.7",
|
|
33
|
+
"skills": [
|
|
34
|
+
"rf-requests"
|
|
35
|
+
]
|
|
36
|
+
},
|
|
37
|
+
{
|
|
38
|
+
"name": "RESTinstance",
|
|
39
|
+
"package": "RESTinstance",
|
|
40
|
+
"versions": ">=1.8,<2",
|
|
41
|
+
"skills": [
|
|
42
|
+
"rf-restinstance"
|
|
43
|
+
]
|
|
44
|
+
}
|
|
45
|
+
],
|
|
46
|
+
"robotframework": ">=7.0",
|
|
47
|
+
"dependencies": [
|
|
48
|
+
"rf-core"
|
|
49
|
+
],
|
|
50
|
+
"bundle": false,
|
|
51
|
+
"bundled": []
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
"name": "rf-core",
|
|
55
|
+
"version": "1.0.0",
|
|
56
|
+
"tier": "verified",
|
|
57
|
+
"status": "active",
|
|
58
|
+
"summary": "Robot Framework syntax, environment setup, Python keyword libraries, test design and debugging subagents, and the validation hooks.",
|
|
59
|
+
"libraries": [],
|
|
60
|
+
"robotframework": ">=7.0",
|
|
61
|
+
"dependencies": [],
|
|
62
|
+
"bundle": false,
|
|
63
|
+
"bundled": []
|
|
64
|
+
},
|
|
65
|
+
{
|
|
66
|
+
"name": "rf-desktop",
|
|
67
|
+
"version": "1.0.0",
|
|
68
|
+
"tier": "verified",
|
|
69
|
+
"status": "active",
|
|
70
|
+
"summary": "PlatynUI skill for desktop UI tests.",
|
|
71
|
+
"libraries": [
|
|
72
|
+
{
|
|
73
|
+
"name": "PlatynUI",
|
|
74
|
+
"package": "robotframework-PlatynUI",
|
|
75
|
+
"versions": ">=0.12.0.dev0",
|
|
76
|
+
"skills": [
|
|
77
|
+
"rf-platynui"
|
|
78
|
+
]
|
|
79
|
+
}
|
|
80
|
+
],
|
|
81
|
+
"robotframework": ">=7.0",
|
|
82
|
+
"dependencies": [
|
|
83
|
+
"rf-core"
|
|
84
|
+
],
|
|
85
|
+
"bundle": false,
|
|
86
|
+
"bundled": []
|
|
87
|
+
},
|
|
88
|
+
{
|
|
89
|
+
"name": "rf-mobile",
|
|
90
|
+
"version": "1.0.0",
|
|
91
|
+
"tier": "verified",
|
|
92
|
+
"status": "active",
|
|
93
|
+
"summary": "AppiumLibrary skill for Android and iOS tests.",
|
|
94
|
+
"libraries": [
|
|
95
|
+
{
|
|
96
|
+
"name": "AppiumLibrary",
|
|
97
|
+
"package": "robotframework-appiumlibrary",
|
|
98
|
+
"versions": ">=3,<4",
|
|
99
|
+
"skills": [
|
|
100
|
+
"rf-appium"
|
|
101
|
+
]
|
|
102
|
+
}
|
|
103
|
+
],
|
|
104
|
+
"robotframework": ">=7.0",
|
|
105
|
+
"dependencies": [
|
|
106
|
+
"rf-core"
|
|
107
|
+
],
|
|
108
|
+
"bundle": false,
|
|
109
|
+
"bundled": []
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"name": "rf-web",
|
|
113
|
+
"version": "1.0.0",
|
|
114
|
+
"tier": "verified",
|
|
115
|
+
"status": "active",
|
|
116
|
+
"summary": "Browser Library and SeleniumLibrary skills for web tests.",
|
|
117
|
+
"libraries": [
|
|
118
|
+
{
|
|
119
|
+
"name": "Browser",
|
|
120
|
+
"package": "robotframework-browser",
|
|
121
|
+
"versions": ">=20,<21",
|
|
122
|
+
"skills": [
|
|
123
|
+
"rf-browser"
|
|
124
|
+
]
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"name": "SeleniumLibrary",
|
|
128
|
+
"package": "robotframework-seleniumlibrary",
|
|
129
|
+
"versions": ">=6.9,<7",
|
|
130
|
+
"skills": [
|
|
131
|
+
"rf-selenium"
|
|
132
|
+
]
|
|
133
|
+
}
|
|
134
|
+
],
|
|
135
|
+
"robotframework": ">=7.0",
|
|
136
|
+
"dependencies": [
|
|
137
|
+
"rf-core"
|
|
138
|
+
],
|
|
139
|
+
"bundle": false,
|
|
140
|
+
"bundled": []
|
|
141
|
+
}
|
|
142
|
+
]
|
|
143
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "rf-agentskills",
|
|
3
|
+
"version": "4.0.0",
|
|
4
|
+
"description": "All Robot Framework plugins in one install: rf-core, rf-web, rf-api, rf-mobile and rf-desktop.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "manykarim",
|
|
7
|
+
"email": "manykarim@users.noreply.github.com"
|
|
8
|
+
},
|
|
9
|
+
"homepage": "https://github.com/MarketSquare/robotframework-plugins",
|
|
10
|
+
"repository": "https://github.com/MarketSquare/robotframework-plugins",
|
|
11
|
+
"license": "Apache-2.0",
|
|
12
|
+
"keywords": [
|
|
13
|
+
"robotframework",
|
|
14
|
+
"testing",
|
|
15
|
+
"automation",
|
|
16
|
+
"web-testing",
|
|
17
|
+
"api-testing",
|
|
18
|
+
"mobile-testing",
|
|
19
|
+
"playwright",
|
|
20
|
+
"selenium",
|
|
21
|
+
"appium",
|
|
22
|
+
"requests",
|
|
23
|
+
"restinstance"
|
|
24
|
+
]
|
|
25
|
+
}
|
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
This is the version of the `rf-agentskills` plugin: since 4.0.0 a bundle of
|
|
4
|
+
the five Robot Framework plugins, before that the plugin with all the content. The `rf-agentskills` Python
|
|
5
|
+
installer is versioned independently; see `RELEASING.md` at the repo root
|
|
6
|
+
for the policy. (Until 2.0.0 this file lived in `vscode-extension/`.)
|
|
7
|
+
|
|
8
|
+
## 4.0.0 (unreleased)
|
|
9
|
+
|
|
10
|
+
The split: the content now lives in five plugins, `rf-core`, `rf-web`, `rf-api`, `rf-mobile` and `rf-desktop` (each 1.0.0), and `rf-agentskills` ships a copy of all five, generated for each release. Existing installs keep the same nine skills, three subagents and hooks, under the same `rf-agentskills:` prefix.
|
|
11
|
+
|
|
12
|
+
- **Install only what you test.** Install `rf-core` plus the technology plugins you need instead of this bundle. Their skills carry their own prefix, for example `rf-web:rf-browser` instead of `rf-agentskills:rf-browser`.
|
|
13
|
+
- **Not both.** With the bundle and a technology plugin installed, each of its skills appears twice.
|
|
14
|
+
- **Content changes**, the same as in the five plugins (see their changelogs): each library skill now has `references/install.md` with its install steps, which used to be in `rf-setup`. The SeleniumLibrary → Browser and RequestsLibrary → RESTinstance keyword maps moved from `rf-migration-guide` to `rf-browser` and `rf-restinstance`.
|
|
15
|
+
- **Why a copy and not plugin dependencies:** Claude Code doesn't install the dependencies that an update adds, so a 3.0.0 install would have lost every skill on update. Copilot CLI and Codex don't install plugin dependencies at all.
|
|
16
|
+
|
|
17
|
+
## 3.0.0 (2026-11-07)
|
|
18
|
+
|
|
19
|
+
Breaking content release: robotcode is now a documented prerequisite, and the skills that overlapped with it are gone.
|
|
20
|
+
|
|
21
|
+
- **Requires the robotcode CLI.** Install `robotcode[all]>=2.8` in the project environment (`uv add --dev "robotcode[all]>=2.8"`; Poetry and pip forms in the README and `rf-setup`). `[all]` is needed because it alone brings the `runner`, `analyze` and `repl` extras and Robocop. No plugin dependency is declared: rf-agentskills loads with or without the RobotCode project's `robotcode` plugin, which the README recommends as a companion (install commands per agent; the RobotCode VS Code extension already bundles it).
|
|
22
|
+
- **Removed skills:** `rf-robotcode` (use the `robotcode` skill of `robotcode@robotframework-agent-plugins`), `rf-libdoc` and its `rf_libdoc.py` (use `robotcode doc keywords <Library> [pattern]` / `robotcode doc keyword <Library> "<Keyword>"`), `rf-results` and its `rf_results.py` (use `robotcode results summary|show|log|stats|diff`; for a CI artifact outside any project: `uvx --from "robotcode[runner]" --with robotframework robotcode results summary -o output.xml`). Their Claude Desktop archives are gone too. 9 skills remain.
|
|
23
|
+
- **Removed subagent:** `rf-keyword-consultant` (use `robotcode doc`, or the REPL's `.kw`).
|
|
24
|
+
- **`rf-debug-expert` is read-only.** It reads the recorded run (`robotcode results`), groups failures by cause, classifies each cause, debugs one representative test with `robotcode robot-debug -bl`, and returns a FAILURE / CATEGORY / ROOT CAUSE / EVIDENCE / FIX / PREVENTION block per cause instead of editing files (`tools: Read, Grep, Glob, Bash`; OpenCode `permission: edit: deny`). It never proposes weakening an assertion, expected value or tag.
|
|
25
|
+
- **Subagents** have situation-based descriptions, and the shared verification loop uses `robotcode doc keyword`, `robotcode analyze code`, Robocop, a longname run (`robotcode robot -bl`) and `robotcode results`.
|
|
26
|
+
- **Skills use robotcode inline.** The library skills, `rf-language` and `rf-python-library` look keywords up with `robotcode doc`, check files with `robotcode analyze code`, run tests by longname and read results with `robotcode results`; Companion Skills tables no longer list the removed skills. Every skill's `compatibility` names `robotcode[all]>=2.8`. `rf-setup` installs robotcode as a required step and verifies with `robotcode discover info` and `robotcode analyze code`.
|
|
27
|
+
- **Validation hook checks errors with robotcode.** `validate_robot.mjs` runs `robotcode --format json analyze code <file>` (with Robocop's deprecation and formatting checks in parallel; about 1 s per edit with a warm `.robotcode_cache/`). Syntax, argument and import errors block (exit 2); unknown keywords and variables are advisory on edit and block at Stop if they are still unresolved, so writing a keyword in a second file is not interrupted. Robocop no longer decides what blocks. The edit hook timeout is 60 s.
|
|
28
|
+
- **Project tier** (`RF_AGENTSKILLS_PROJECT_VALIDATION`) runs `robotcode analyze code --collect-unused` instead of `robot --dryrun` and `robotframework-find-unused`.
|
|
29
|
+
- **Context hooks:** SessionStart reports the robotcode version (and that 2.8 is needed); the prompt hint, the `robot` error hints and the end-of-session reminder use `robotcode doc` / `robotcode results` instead of the removed skills.
|
|
30
|
+
- **rf-requests:** new gotcha: RequestsLibrary logs credentials and token headers at INFO.
|
|
31
|
+
|
|
32
|
+
- **One plugin marketplace for every agent.** The repository's `.claude-plugin/marketplace.json` now serves Claude Code, GitHub Copilot CLI, VS Code (Copilot), Codex and Cursor; the README has the install, scope and pinning steps per agent. Pin a release with its `v<version>` tag.
|
|
33
|
+
- **VS Code extension retired.** No `.vsix` is built or attached to releases any more. Instead, VS Code users add `manykarim/robotframework-agentskills` to `chat.plugins.marketplaces` (user scope), accept the workspace recommendation from a committed `.claude/settings.json` (project scope), or run `rf-agentskills install --agent copilot` (files). Unlike the extension, the plugin also brings subagents and hooks.
|
|
34
|
+
- **No default main agent.** The plugin's `settings.json` (`"agent": "rf-test-architect"`) is removed, so enabling the plugin no longer replaces your main agent. The four subagents remain available for delegation; to keep `rf-test-architect` as your main agent, select it yourself (for example `"agent"` in your own Claude Code settings).
|
|
35
|
+
- **Hooks read every agent's input.** `validate_robot.mjs` and `rf_error_hints.mjs` accept the tool names and input shapes of Claude Code, Copilot CLI, VS Code (`create_file`, `replace_string_in_file`, `apply_patch`, `run_in_terminal`), Codex (`apply_patch`, `Bash`) and Cursor, validate every `.robot`/`.resource` file a patch touches, and exit silently for other tools. Validation errors are now also reported as `{"decision": "block", "reason": ...}`, the only hook output Copilot CLI passes to its model.
|
|
36
|
+
- **Unfixed validation errors are re-checked at Stop.** A new Stop hook, `report_pending_errors.mjs`, re-validates the `.robot`/`.resource` files whose validation failed in the session and are still broken, and hands the errors to the model for one more turn. This covers VS Code's Local agent harness, which sends the next model request without waiting for PostToolUse hooks. Each content version of a file is reported once, and the hook is silent on `stop_hook_active`.
|
|
37
|
+
- **Generated per-agent variants** in `variants/` (from `scripts/build-agent-variants.py`, drift-checked in CI): Codex TOML subagents, OpenCode subagents (`mode: subagent`) and an OpenCode JS plugin that runs the same validation, error-hint and environment hooks.
|
|
38
|
+
|
|
39
|
+
## 2.0.0 (never tagged; shipped in 3.0.0)
|
|
40
|
+
|
|
41
|
+
- Skill descriptions trimmed to fit Claude Code 2.1.288's smaller skill listing (all 12 visible, 1210 characters) and sibling cues added (rf-appium/rf-selenium/rf-restinstance → rf-setup for installs and drivers, rf-libdoc/rf-results → rf-robotcode when robotcode is installed).
|
|
42
|
+
|
|
43
|
+
- **`rf-tools` MCP server removed** from the content bundle: the skills run their scripts directly, so no MCP tools (`rf_libdoc_search`, `rf_libdoc_explain`, `rf_results_analyze`, `rf_conventions`, `rf_check_library`) are shipped. The VS Code extension never shipped the server; this only affects the Claude Code plugin and the installer.
|
|
44
|
+
|
|
45
|
+
- rf-language: concrete embedded-argument recipe (`${team:\S+}`, text between arguments is literal) and the "No keyword with name … for an `[Arguments]` keyword" gotcha.
|
|
46
|
+
|
|
47
|
+
Breaking content release. Later changes in this release cycle add their
|
|
48
|
+
entries here.
|
|
49
|
+
|
|
50
|
+
- **rf-language / rf-setup:** every documented `robocop check` / `robocop
|
|
51
|
+
format` command passes `--no-cache` (Robocop otherwise leaves a
|
|
52
|
+
`.robocop_cache/` directory in the project).
|
|
53
|
+
- **rf-appium:** duplicate H1 heading removed.
|
|
54
|
+
- **New skill `rf-language`:** writing and reviewing Robot Framework test
|
|
55
|
+
cases (keyword-driven, data-driven, BDD), suites and `__init__.robot`,
|
|
56
|
+
tags and selection, user keywords and arguments, embedded arguments,
|
|
57
|
+
variables, resource and variable files, with a version gate, verified
|
|
58
|
+
gotchas, a legacy-to-modern migration table (Robocop 9 rule IDs) and
|
|
59
|
+
examples labelled "RF 7.0+". Its bundled `scripts/rf_conventions.py`
|
|
60
|
+
detects the project's conventions. The Companion Skills tables of
|
|
61
|
+
rf-setup, rf-robotcode and the six library skills link to it.
|
|
62
|
+
- **New skill `rf-python-library`:** writing and fixing Robot Framework
|
|
63
|
+
keyword libraries and listeners in Python (template, scope by state
|
|
64
|
+
lifetime per the RF User Guide, conversion, failures and logging,
|
|
65
|
+
dynamic/hybrid APIs, listener API v3, libdoc), with a version gate,
|
|
66
|
+
thirteen verified gotchas and examples labelled "RF 7.0+". Its bundled
|
|
67
|
+
`scripts/check_library.py` checks project libraries for RF-specific defects
|
|
68
|
+
before tests run. rf-language's description and Companion Skills table and
|
|
69
|
+
rf-setup's project layout point to it.
|
|
70
|
+
- **Removed skills:** `rf-keyword-builder`, `rf-testcase-builder`,
|
|
71
|
+
`rf-resource-architect` (and in the Claude Code plugin the slash commands
|
|
72
|
+
`/rf-agentskills:keyword-builder`, `:testcase-builder`,
|
|
73
|
+
`:resource-architect`), plus their scripts `keyword_builder.py`,
|
|
74
|
+
`testcase_builder.py`, `resource_architect.py`.
|
|
75
|
+
- **Removed MCP tools** (`rf-tools` server): `rf_keyword_builder`,
|
|
76
|
+
`rf_testcase_builder`, `rf_resource_architect`. Calling them returns the
|
|
77
|
+
normal unknown-tool error.
|
|
78
|
+
- **Why:** the JSON → script → paste round trip cost more turns and tokens
|
|
79
|
+
than writing Robot Framework directly, and the scripts lagged the language
|
|
80
|
+
(no RF 7 typed arguments, unimplemented layout modes).
|
|
81
|
+
- **Use instead:** write keywords, test cases and resource files directly;
|
|
82
|
+
check keyword names and arguments with `rf-libdoc`
|
|
83
|
+
(or `robotcode libdoc`), and validate with
|
|
84
|
+
`robot --dryrun`. The companion tables of the library skills, `rf-setup`
|
|
85
|
+
and `rf-robotcode` no longer list the generators; the subagents follow the
|
|
86
|
+
write-directly workflow.
|
|
87
|
+
- **Upgrade notes:** the VS Code extension and the Claude Code plugin replace
|
|
88
|
+
the skill tree on update. `rf-agentskills` installer users re-run
|
|
89
|
+
`rf-agentskills install` (0.7.0 prunes the old copies). Skills-tarball
|
|
90
|
+
users delete `rf-keyword-builder/`, `rf-testcase-builder/` and
|
|
91
|
+
`rf-resource-architect/` from their skills directory by hand. To keep the
|
|
92
|
+
generators, stay on 1.2.0.
|
|
93
|
+
- **Merged skills:** `rf-libdoc-search` and `rf-libdoc-explain` are
|
|
94
|
+
replaced by one skill, `rf-libdoc` (Claude Code plugin: slash command
|
|
95
|
+
`/rf-agentskills:rf-libdoc` replaces `:libdoc-search` and `:libdoc-explain`).
|
|
96
|
+
It finds keywords for a use case, explains a keyword's arguments (with
|
|
97
|
+
search fallback) and lists a library's keywords, and points to
|
|
98
|
+
`robotcode libdoc` when robotcode is installed. `rf_libdoc.py` flags and
|
|
99
|
+
JSON output are unchanged; the MCP tools `rf_libdoc_search` and
|
|
100
|
+
`rf_libdoc_explain` keep their names. The script ships as one regular file
|
|
101
|
+
(no symlink). **Upgrade:** the extension and plugin replace the skill tree;
|
|
102
|
+
installer users re-run `rf-agentskills install`; users who copied skill
|
|
103
|
+
folders by hand delete `rf-libdoc-search/` and `rf-libdoc-explain/`.
|
|
104
|
+
- **One identifier per skill (Claude Code plugin, installer, tarballs).**
|
|
105
|
+
Every skill's folder name now equals its `name` (`rf-<topic>`) in every
|
|
106
|
+
channel. The VS Code extension already used these names, so **VS Code users
|
|
107
|
+
see no change**. Elsewhere: repo/tarball folders `robotframework-browser-skill`,
|
|
108
|
+
`-selenium-skill`, `-appium-skill`, `-requests-skill`, `-restinstance-skill`,
|
|
109
|
+
`-platynui-skill`, `-robotcode-skill`, `-setup-skill` and
|
|
110
|
+
`robotframework-results` become `rf-browser`, `rf-selenium`, `rf-appium`,
|
|
111
|
+
`rf-requests`, `rf-restinstance`, `rf-platynui`, `rf-robotcode`, `rf-setup`
|
|
112
|
+
and `rf-results`; the Claude Code plugin folders and slash commands change
|
|
113
|
+
from the short names (`/rf-agentskills:browser`, `:setup`, `:results`,
|
|
114
|
+
`:libdoc`, …) to `/rf-agentskills:rf-browser`, `:rf-setup`, `:rf-results`,
|
|
115
|
+
`:rf-libdoc`, …. Installer users re-run `rf-agentskills install` (old
|
|
116
|
+
folders are pruned); tarball users delete the old folders by hand
|
|
117
|
+
(`rf-agentskills doctor` lists them).
|
|
118
|
+
- Every `SKILL.md` declares `license`, `compatibility` (runtime needs) and
|
|
119
|
+
`metadata` (`author`, `version`); CI validates all channels against the
|
|
120
|
+
agentskills.io frontmatter rules (`scripts/validate-skills.py`).
|
|
121
|
+
- **Skill scripts run in the project environment.** `rf-libdoc` and
|
|
122
|
+
`rf-results` now document `uv run python scripts/rf_libdoc.py …` /
|
|
123
|
+
`uv run python scripts/rf_results.py …` (paths relative to the skill folder)
|
|
124
|
+
plus one fallback line for non-uv projects (`.venv/bin/python` /
|
|
125
|
+
`poetry run python`, see rf-setup). Commands copied from 1.x
|
|
126
|
+
(`python scripts/…`) still work but use whatever `python` is on PATH.
|
|
127
|
+
- **Script CLI contract:** exit codes `0` ok, `1` internal error, `2` usage,
|
|
128
|
+
`3` Robot Framework missing or older than 7, `4` input not found or not
|
|
129
|
+
loadable (previously `1` for all failures); diagnostics are `error:` /
|
|
130
|
+
`warning:` / `hint:` lines on stderr (no JSON error on stderr, no
|
|
131
|
+
`pip install` advice); `--help` works without Robot Framework and ends with
|
|
132
|
+
examples. Both scripts carry PEP 723 metadata (`robotframework>=7`).
|
|
133
|
+
- **Bounded output:** `rf_libdoc.py --max-doc-chars` (default 4000, `0` = full
|
|
134
|
+
text, truncation marker inside `doc`); `rf_results.py --limit` (default 50)
|
|
135
|
+
caps `details` test entries (failed first) and each `errors` list and reports
|
|
136
|
+
`omitted` counts; both scripts accept `--json-out FILE`.
|
|
137
|
+
- **Sharper skill descriptions:** every skill's `description` now opens with
|
|
138
|
+
what it does and for which library or tool, has a `Use when` clause with the
|
|
139
|
+
terms users type (`Library Browser`, `output.xml`, `robot.toml`,
|
|
140
|
+
`No module named 'Browser'`, `No keyword with name`) and ends with the
|
|
141
|
+
sibling to use instead: rf-browser vs rf-selenium (by import; rf-browser is
|
|
142
|
+
the default for new web tests), rf-requests vs rf-restinstance (by import or
|
|
143
|
+
JSON Schema/OpenAPI; rf-requests is the default for API tests),
|
|
144
|
+
rf-results / rf-libdoc vs rf-robotcode (robotcode installed or named), and
|
|
145
|
+
rf-setup for installing and environment errors. No more "Guide AI agents…"
|
|
146
|
+
phrasing.
|
|
147
|
+
- **Compact skill descriptions:** agents list skill descriptions only while
|
|
148
|
+
they fit a character budget (about 8000 characters in Claude Code for
|
|
149
|
+
200k-context models), so every description is now at most 160 characters
|
|
150
|
+
and starts with a load-first cue ("Use first, before exploring or
|
|
151
|
+
answering, for Robot Framework web tests with Browser Library (Playwright):
|
|
152
|
+
selectors, waits."). The trigger terms, pasted errors and sibling boundaries
|
|
153
|
+
moved into a `## When to use` block near the top of each `SKILL.md`.
|
|
154
|
+
- **Standard Companion Skills tables:** every skill (now including rf-libdoc
|
|
155
|
+
and rf-results) has a `Need | Skill` table built from one shared catalogue,
|
|
156
|
+
with rows for its sibling, `rf-setup`, keyword lookup (`rf-libdoc`, or
|
|
157
|
+
`robotcode libdoc`) and result analysis (`rf-results`, or
|
|
158
|
+
`robotcode results`).
|
|
159
|
+
- **Library skills restructured** (rf-browser, rf-selenium, rf-appium,
|
|
160
|
+
rf-requests, rf-restinstance): one shared layout (Installation, Import and
|
|
161
|
+
defaults, a "which keyword for which situation" table, an agent workflow
|
|
162
|
+
with a libdoc → dry run → run → results → fix loop, verified Gotchas, a
|
|
163
|
+
gated reference table). Breaking for anyone who read the files directly:
|
|
164
|
+
every `references/keywords-reference.md` catalog is deleted (query libdoc
|
|
165
|
+
with `robotcode libdoc <Library> list/show` or the rf-libdoc skill
|
|
166
|
+
instead), and several references were merged or renamed (rf-browser
|
|
167
|
+
`tabs-windows.md` → `browser-context-page.md`; rf-selenium
|
|
168
|
+
`webdriver-setup.md` → `browser-setup.md`, `screenshots-logs.md` →
|
|
169
|
+
`troubleshooting.md`; rf-appium `device-capabilities.md` →
|
|
170
|
+
`capabilities.md`, `android-specific.md` + `ios-specific.md` →
|
|
171
|
+
`platform-specific.md`; rf-requests `http-methods.md` →
|
|
172
|
+
`request-options.md`). Examples were trimmed to suites that pass
|
|
173
|
+
`robot --dryrun`.
|
|
174
|
+
|
|
175
|
+
Companion: `rf-agentskills` installer 0.7.0 ships the same content bundle
|
|
176
|
+
(`bundled content: 2.0.0`).
|
|
177
|
+
|
|
178
|
+
## 1.2.0 (2026-03-17)
|
|
179
|
+
|
|
180
|
+
- Fix: VS Code skill dirs now match the `name:` field per the Agent
|
|
181
|
+
Skills spec (so chat skills resolve correctly in Copilot 1.108+).
|
|
182
|
+
- Architecture overhaul: MCP server, script drift, hooks, tests, and
|
|
183
|
+
build infrastructure.
|
|
184
|
+
|
|
185
|
+
Companion: `rf-agentskills` installer ≥ 0.3.0 ships the same content
|
|
186
|
+
bundle (`bundled content: 1.2.0`).
|
|
187
|
+
|
|
188
|
+
## 1.1.0
|
|
189
|
+
|
|
190
|
+
- Iterative skill updates and minor fixes.
|
|
191
|
+
|
|
192
|
+
## 1.0.0 (2026-02-27)
|
|
193
|
+
|
|
194
|
+
- Initial release with 11 Robot Framework Agent Skills
|
|
195
|
+
- Skills for Browser, Selenium, Appium, Requests, RESTinstance libraries
|
|
196
|
+
- Keyword builder, test case builder, resource architect generators
|
|
197
|
+
- Library documentation search and explanation tools
|
|
198
|
+
- Results analysis for output.xml files
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# rf-agentskills bundle
|
|
2
|
+
|
|
3
|
+
Installs every Robot Framework plugin of this marketplace at once: `rf-core`, `rf-web`, `rf-api`, `rf-mobile` and `rf-desktop`. It has no content of its own. Install instructions for every agent are in the [repository README](https://github.com/MarketSquare/robotframework-plugins#install).
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
/plugin install rf-agentskills --marketplace MarketSquare/robotframework-plugins
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
That one step works on Claude Code 2.1.275 or later. The commands for other agents and older versions are in the repository README.
|
|
12
|
+
|
|
13
|
+
Until 3.0.0 this plugin held all nine skills, three subagents and the hooks. From 4.0.0 they are maintained in the five plugins above, so a web team can install `rf-core` and `rf-web` only. `rf-agentskills` ships a copy of all five, generated from them for each release. Projects that enable `rf-agentskills@robotframework-plugins` keep everything, under the same `rf-agentskills:` prefix as before.
|
|
14
|
+
|
|
15
|
+
| Plugin | Skills and subagents |
|
|
16
|
+
|---|---|
|
|
17
|
+
| `rf-core` | `rf-language`, `rf-setup`, `rf-python-library`; `rf-test-architect`, `rf-debug-expert`, `rf-migration-guide`; all hooks |
|
|
18
|
+
| `rf-web` | `rf-browser`, `rf-selenium` |
|
|
19
|
+
| `rf-api` | `rf-requests`, `rf-restinstance` |
|
|
20
|
+
| `rf-mobile` | `rf-appium` |
|
|
21
|
+
| `rf-desktop` | `rf-platynui` |
|
|
22
|
+
|
|
23
|
+
## Bundle or separate plugins, not both
|
|
24
|
+
|
|
25
|
+
Install either this bundle or the plugins you need. With both, each skill appears twice, once as `rf-agentskills:rf-browser` and once as `rf-web:rf-browser`. Moving from the bundle to separate plugins changes the skill prefixes, so update project instructions or docs that name a prefixed skill.
|
|
26
|
+
|
|
27
|
+
robotcode is a prerequisite of `rf-core`; see its README.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Programme manifest: see schemas/catalog.schema.json and CONTRIBUTING.md.
|
|
2
|
+
name: rf-agentskills
|
|
3
|
+
summary: All Robot Framework plugins in one install (rf-core, rf-web, rf-api, rf-mobile, rf-desktop), as one plugin.
|
|
4
|
+
tier: verified
|
|
5
|
+
status: active
|
|
6
|
+
maintainers:
|
|
7
|
+
- github: manykarim
|
|
8
|
+
name: Many Kasiriha
|
|
9
|
+
libraries: []
|
|
10
|
+
bundle:
|
|
11
|
+
- rf-core
|
|
12
|
+
- rf-web
|
|
13
|
+
- rf-api
|
|
14
|
+
- rf-mobile
|
|
15
|
+
- rf-desktop
|
|
16
|
+
robotframework: ">=7.0"
|
|
17
|
+
agents:
|
|
18
|
+
- claude-code
|
|
19
|
+
- copilot-cli
|
|
20
|
+
- vscode-copilot
|
|
21
|
+
- codex
|
|
22
|
+
- cursor
|
|
23
|
+
- opencode
|
|
24
|
+
- goose
|
|
25
|
+
- claude-desktop
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "rf-api",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "RequestsLibrary and RESTinstance skills for Robot Framework API tests.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "manykarim",
|
|
7
|
+
"email": "manykarim@users.noreply.github.com"
|
|
8
|
+
},
|
|
9
|
+
"homepage": "https://github.com/MarketSquare/robotframework-plugins",
|
|
10
|
+
"repository": "https://github.com/MarketSquare/robotframework-plugins",
|
|
11
|
+
"license": "Apache-2.0",
|
|
12
|
+
"keywords": [
|
|
13
|
+
"robotframework",
|
|
14
|
+
"testing",
|
|
15
|
+
"api-testing",
|
|
16
|
+
"requests",
|
|
17
|
+
"restinstance"
|
|
18
|
+
],
|
|
19
|
+
"dependencies": [
|
|
20
|
+
{
|
|
21
|
+
"name": "rf-core",
|
|
22
|
+
"version": "^1.0"
|
|
23
|
+
}
|
|
24
|
+
]
|
|
25
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
The `rf-api` plugin, versioned on its own (`rf-api--v<version>` tags); see `RELEASING.md` at the repository root.
|
|
4
|
+
|
|
5
|
+
## 1.0.0 (unreleased)
|
|
6
|
+
|
|
7
|
+
First release, split out of `rf-agentskills` 3.0.0: `rf-requests` and `rf-restinstance`. It depends on `rf-core` `^1.0`. Skill names are unchanged; their plugin prefix is now `rf-api:` instead of `rf-agentskills:`, for example `/rf-api:rf-requests`.
|
|
8
|
+
|
|
9
|
+
- **Install steps moved here** from `rf-setup`: `rf-requests` and `rf-restinstance` each have `references/install.md`. `rf-restinstance` also has `references/migrate-from-requests.md`, the RequestsLibrary → RESTinstance keyword map that `rf-migration-guide` used to carry.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# rf-api plugin
|
|
2
|
+
|
|
3
|
+
Robot Framework skills for API tests. Install instructions for every agent are in the [repository README](https://github.com/MarketSquare/robotframework-plugins#install).
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
/plugin install rf-api --marketplace MarketSquare/robotframework-plugins
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
That one step works on Claude Code 2.1.275 or later. The commands for other agents and older versions are in the repository README.
|
|
12
|
+
|
|
13
|
+
| Skill | Library and package |
|
|
14
|
+
|---|---|
|
|
15
|
+
| `rf-requests` | RequestsLibrary: `robotframework-requests` |
|
|
16
|
+
| `rf-restinstance` | RESTinstance: `RESTinstance` |
|
|
17
|
+
|
|
18
|
+
## Needs rf-core
|
|
19
|
+
|
|
20
|
+
This plugin depends on `rf-core`, which holds Robot Framework syntax, environment setup, the subagents and the validation hooks. Claude Code installs `rf-core` with it. Copilot CLI and Codex don't install plugin dependencies, so install `rf-core` there too:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
copilot plugin install rf-core@robotframework-plugins
|
|
24
|
+
codex plugin add rf-core@robotframework-plugins
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
The `robotframework-plugins` installer adds `rf-core` for you. Don't install this plugin next to the `rf-agentskills` bundle: the bundle carries its own copy of every skill, and you would see each skill twice.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Programme manifest: see schemas/catalog.schema.json and CONTRIBUTING.md.
|
|
2
|
+
name: rf-api
|
|
3
|
+
summary: RequestsLibrary and RESTinstance skills for API tests.
|
|
4
|
+
tier: verified
|
|
5
|
+
status: active
|
|
6
|
+
maintainers:
|
|
7
|
+
- github: manykarim
|
|
8
|
+
name: Many Kasiriha
|
|
9
|
+
libraries:
|
|
10
|
+
- name: RequestsLibrary
|
|
11
|
+
package: robotframework-requests
|
|
12
|
+
versions: ">=0.9.7"
|
|
13
|
+
skills: [rf-requests]
|
|
14
|
+
- name: RESTinstance
|
|
15
|
+
package: RESTinstance
|
|
16
|
+
versions: ">=1.8,<2"
|
|
17
|
+
skills: [rf-restinstance]
|
|
18
|
+
robotframework: ">=7.0"
|
|
19
|
+
agents:
|
|
20
|
+
- claude-code
|
|
21
|
+
- copilot-cli
|
|
22
|
+
- vscode-copilot
|
|
23
|
+
- codex
|
|
24
|
+
- cursor
|
|
25
|
+
- opencode
|
|
26
|
+
- goose
|
|
27
|
+
- claude-desktop
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: rf-requests
|
|
3
|
+
description: "Use first, before answering, for RF HTTP API tests with RequestsLibrary: sessions."
|
|
4
|
+
license: Apache-2.0
|
|
5
|
+
compatibility: Requires Python 3.10+, robotframework>=7, robotcode[all]>=2.8 and robotframework-requests in the project environment.
|
|
6
|
+
metadata:
|
|
7
|
+
author: manykarim
|
|
8
|
+
version: "1.0.0"
|
|
9
|
+
---
|
|
10
|
+
# Requests Library Skill
|
|
11
|
+
|
|
12
|
+
HTTP API tests with RequestsLibrary, a thin wrapper around Python `requests`: each call returns a `requests.Response`.
|
|
13
|
+
Use rf-restinstance instead when the suite imports `Library REST` or asserts JSON Schema / OpenAPI contracts.
|
|
14
|
+
Verified against RequestsLibrary 0.9.7, Robot Framework 7.4.
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
|
|
18
|
+
Load this skill first, before exploring the project, reading the suite or answering from memory, when a Robot Framework test calls an HTTP API with RequestsLibrary (`Library RequestsLibrary`):
|
|
19
|
+
|
|
20
|
+
- writing new API tests for an endpoint, or adding a check on a field of the JSON response;
|
|
21
|
+
- sessions, GET/POST/PUT/PATCH/DELETE, headers, bearer or basic auth, query parameters, JSON and multipart bodies, `expected_status` for error responses;
|
|
22
|
+
- a failing request (HTTPError, wrong status, SSL, timeouts);
|
|
23
|
+
- API tests in Robot Framework without naming a library: RequestsLibrary is the default.
|
|
24
|
+
|
|
25
|
+
Not this skill: suites that import `REST` (RESTinstance), or tests driven by JSON Schema/OpenAPI assertions, use `rf-restinstance`.
|
|
26
|
+
|
|
27
|
+
## Installation
|
|
28
|
+
|
|
29
|
+
Install into the project environment, with the tool the project already uses. Full steps and verification: `references/install.md`. For a new environment, Poetry and venv + pip forms, and troubleshooting, see `rf-setup` (plugin `rf-core`).
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
uv add robotframework-requests
|
|
33
|
+
```
|
|
34
|
+
No post-install step.
|
|
35
|
+
|
|
36
|
+
## Import and defaults
|
|
37
|
+
|
|
38
|
+
Default: one session per API, created in Suite Setup with TLS verification on, and path-only `… On Session` calls.
|
|
39
|
+
|
|
40
|
+
```robotframework
|
|
41
|
+
*** Settings ***
|
|
42
|
+
Library RequestsLibrary
|
|
43
|
+
Suite Setup Create Session api ${API_URL} verify=${True}
|
|
44
|
+
Suite Teardown Delete All Sessions
|
|
45
|
+
|
|
46
|
+
*** Test Cases ***
|
|
47
|
+
Get User
|
|
48
|
+
${resp}= GET On Session api /users/1
|
|
49
|
+
Should Be Equal ${resp.json()}[name] Alice
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Escape hatch: for one or two calls to full URLs, use the sessionless keywords (`GET`, `POST`, …) — see `references/request-options.md`.
|
|
53
|
+
|
|
54
|
+
## Which keyword for which situation
|
|
55
|
+
|
|
56
|
+
| Situation | Use | Details |
|
|
57
|
+
|---|---|---|
|
|
58
|
+
| Call an endpoint of a shared base URL | `GET On Session` / `POST On Session` (path, not full URL) | references/request-options.md |
|
|
59
|
+
| One-off call to a full URL | `GET`, `POST` … (sessionless) | references/request-options.md |
|
|
60
|
+
| Send JSON / form / files | `json=${dict}` / `data=${dict}` / `files=${files}` | references/request-options.md |
|
|
61
|
+
| Query string | `params=${dict}` | references/request-options.md |
|
|
62
|
+
| Negative test (expect 4xx/5xx) | `expected_status=404` on the call | references/request-options.md |
|
|
63
|
+
| Assert status after the call | `Status Should Be 201 ${resp}`, `Request Should Be Successful` | references/response-validation.md |
|
|
64
|
+
| Assert body or headers | `Should Be Equal ${resp.json()}[id] ${1}`, `${resp.headers}[Content-Type]` | references/response-validation.md |
|
|
65
|
+
| Basic / digest / NTLM / client cert | `Create Session … auth=`, `Create Digest Session`, `Create Ntlm Session`, `Create Client Cert Session` | references/authentication.md |
|
|
66
|
+
| Bearer token for all later calls | `Update Session api headers=${auth}` | references/authentication.md |
|
|
67
|
+
| Unexpected error message | — | references/troubleshooting.md |
|
|
68
|
+
|
|
69
|
+
## Agent workflow
|
|
70
|
+
|
|
71
|
+
1. Look up each keyword before you use it: `robotcode doc keyword RequestsLibrary "<Keyword>"`; find names with `robotcode doc keywords RequestsLibrary "<text>"`. Copy names and arguments exactly as robotcode shows them.
|
|
72
|
+
2. Write the test with the defaults above and the decision table.
|
|
73
|
+
3. Check the changed files statically: `robotcode analyze code <changed files>` (through the project environment, e.g. `uv run robotcode …`). Fix every error it reports.
|
|
74
|
+
4. Run them by longname: `robotcode robot -bl "<Suite.Sub.Test>"` (longnames from `robotcode discover tests`), or pass a whole directory. Don't pass a single `.robot` file: it skips the parent `__init__.robot`.
|
|
75
|
+
5. Read the results: `robotcode results show --failed`, then `robotcode results log -bl "<longname>"`. Don't parse output.xml by hand.
|
|
76
|
+
6. Fix the cause and go back to step 3 (static check). Stop when the tests pass or the failure is shown to be in the system under test, and say which.
|
|
77
|
+
|
|
78
|
+
## Gotchas
|
|
79
|
+
|
|
80
|
+
- **Every call asserts the status** — with `expected_status` unset, any 4xx/5xx raises `HTTPError`, because the library calls `raise_for_status()`. For negative tests pass `expected_status=404` (or a name such as `not found`) instead of wrapping the call in `Run Keyword And Expect Error`.
|
|
81
|
+
- **No status ranges** — `expected_status` takes one code, a status name, or `any`/`anything`; `2xx` fails with `UnknownStatusError`. For "any success" use `expected_status=anything` plus `Request Should Be Successful ${resp}`.
|
|
82
|
+
- **Sessions skip TLS verification** — `Create Session` defaults to `verify=False`, while sessionless `GET`/`POST` use the `requests` default (verify on). Pass `verify=${True}` (or a CA bundle path) to `Create Session`.
|
|
83
|
+
- **`json=` vs `data=`** — `json=${dict}` serializes and sets `Content-Type: application/json`; `data=${dict}` form-encodes. Values from `Create Dictionary`/`VAR` are strings, so write `count=${1}` when the API expects a number; don't build JSON with `Evaluate json.dumps(...)`.
|
|
84
|
+
- **Sessionless `auth=` needs a tuple** — `GET ${url} auth=${list}` fails with `TypeError: 'list' object is not callable`, because the list goes straight to `requests`. `Create Session … auth=${list}` works (the library wraps it in basic auth); sessionless calls need `${auth}= Evaluate ("user", "pass")`.
|
|
85
|
+
- **Sessions are global** — the library scope is `GLOBAL`, so an alias and its headers, cookies and auth live across tests and suites. Create sessions in Suite Setup and call `Delete All Sessions` in Suite Teardown.
|
|
86
|
+
- **`=` in a URL** — `GET On Session api /search?q=x` fails with `missing 1 required positional argument: 'url'`, because Robot Framework parses `…?q=x` as a named argument. Pass `params=${query}` or write `url=/search?q=x`.
|
|
87
|
+
- **`Status Should Be` argument order** — the status comes first: `Status Should Be 201 ${resp}`. Without a response it checks the last response of any session.
|
|
88
|
+
- **Credentials are logged at INFO** — session creation and each request log the `auth` tuple, the `Authorization: Basic …` header and custom token headers in plain text, in `log.html` and in `robotcode repl` output (RequestsLibrary 0.9.7, observed with robotcode 2.8.0). Don't share raw logs; when logs leave the machine, run with `--loglevel WARN` or wrap the login calls in `Set Log Level WARN` … `Set Log Level INFO`.
|
|
89
|
+
|
|
90
|
+
## When to read the references
|
|
91
|
+
|
|
92
|
+
| Read | When |
|
|
93
|
+
|---|---|
|
|
94
|
+
| references/install.md | installing the library, its post-install steps, verifying the install, or a failed post-install step |
|
|
95
|
+
| references/request-options.md | choosing sessionless vs `… On Session`, body/params/files, timeouts, retries, TLS, `expected_status` |
|
|
96
|
+
| references/response-validation.md | asserting JSON bodies, lists, headers and cookies of a `requests.Response` |
|
|
97
|
+
| references/authentication.md | basic, digest, NTLM, client-certificate or token authentication |
|
|
98
|
+
| references/troubleshooting.md | a request fails with an error you don't recognise |
|
|
99
|
+
|
|
100
|
+
Examples in `assets/examples/`: `basic-crud.robot`, `session-handling.robot`, `authentication-patterns.robot`, `file-upload.robot`.
|
|
101
|
+
|
|
102
|
+
## Companion Skills
|
|
103
|
+
|
|
104
|
+
| Need | Skill |
|
|
105
|
+
|------|-------|
|
|
106
|
+
| API tests with RESTinstance / JSON Schema | `rf-restinstance` |
|
|
107
|
+
| Install Robot Framework or a library, fix the environment | `rf-setup` (plugin `rf-core`) |
|
|
108
|
+
| Write tests, suites, user keywords, resources and variables in Robot Framework syntax | `rf-language` (plugin `rf-core`) |
|
|
109
|
+
|
|
110
|
+
For running, discovering, keyword documentation, result analysis and debugging with the robotcode CLI, use the `robotcode` skill of the robotcode plugin (`robotcode@robotframework-agent-plugins`); the commands above work without it.
|