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.
Files changed (195) hide show
  1. robotframework_plugins/__init__.py +14 -0
  2. robotframework_plugins/_assets/catalog.json +143 -0
  3. robotframework_plugins/_assets/plugins/rf-agentskills/.claude-plugin/plugin.json +25 -0
  4. robotframework_plugins/_assets/plugins/rf-agentskills/CHANGELOG.md +198 -0
  5. robotframework_plugins/_assets/plugins/rf-agentskills/README.md +27 -0
  6. robotframework_plugins/_assets/plugins/rf-agentskills/catalog.yaml +25 -0
  7. robotframework_plugins/_assets/plugins/rf-api/.claude-plugin/plugin.json +25 -0
  8. robotframework_plugins/_assets/plugins/rf-api/CHANGELOG.md +9 -0
  9. robotframework_plugins/_assets/plugins/rf-api/README.md +27 -0
  10. robotframework_plugins/_assets/plugins/rf-api/catalog.yaml +27 -0
  11. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/SKILL.md +110 -0
  12. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/authentication-patterns.robot +39 -0
  13. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/basic-crud.robot +46 -0
  14. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/file-upload.robot +28 -0
  15. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/session-handling.robot +48 -0
  16. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/authentication.md +58 -0
  17. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/install.md +10 -0
  18. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/request-options.md +90 -0
  19. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/response-validation.md +64 -0
  20. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/troubleshooting.md +64 -0
  21. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/SKILL.md +119 -0
  22. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/basic-rest.robot +51 -0
  23. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schema-validation.robot +38 -0
  24. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schemas/user.json +10 -0
  25. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/authentication.md +61 -0
  26. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/install.md +11 -0
  27. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/json-handling.md +89 -0
  28. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/migrate-from-requests.md +15 -0
  29. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/schema-validation.md +85 -0
  30. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/troubleshooting.md +68 -0
  31. robotframework_plugins/_assets/plugins/rf-core/.claude-plugin/plugin.json +19 -0
  32. robotframework_plugins/_assets/plugins/rf-core/CHANGELOG.md +11 -0
  33. robotframework_plugins/_assets/plugins/rf-core/README.md +38 -0
  34. robotframework_plugins/_assets/plugins/rf-core/agents/rf-debug-expert.md +104 -0
  35. robotframework_plugins/_assets/plugins/rf-core/agents/rf-migration-guide.md +73 -0
  36. robotframework_plugins/_assets/plugins/rf-core/agents/rf-test-architect.md +98 -0
  37. robotframework_plugins/_assets/plugins/rf-core/catalog.yaml +19 -0
  38. robotframework_plugins/_assets/plugins/rf-core/hooks/README.md +435 -0
  39. robotframework_plugins/_assets/plugins/rf-core/hooks/hooks.json +70 -0
  40. robotframework_plugins/_assets/plugins/rf-core/scripts/_hook_input.mjs +101 -0
  41. robotframework_plugins/_assets/plugins/rf-core/scripts/_pending_errors.mjs +65 -0
  42. robotframework_plugins/_assets/plugins/rf-core/scripts/_python_env.mjs +181 -0
  43. robotframework_plugins/_assets/plugins/rf-core/scripts/check_rf_environment.mjs +181 -0
  44. robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_inject_rf_context.mjs +74 -0
  45. robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_remind_robot_tests.mjs +108 -0
  46. robotframework_plugins/_assets/plugins/rf-core/scripts/report_pending_errors.mjs +72 -0
  47. robotframework_plugins/_assets/plugins/rf-core/scripts/rf_error_hints.mjs +126 -0
  48. robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot.mjs +509 -0
  49. robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot_project.mjs +103 -0
  50. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/SKILL.md +313 -0
  51. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/api.resource +30 -0
  52. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/calc.resource +23 -0
  53. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/embedded.resource +20 -0
  54. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/keywords.resource +26 -0
  55. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/login.resource +10 -0
  56. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/01__keyword_driven.robot +15 -0
  57. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/02__data_driven.robot +10 -0
  58. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/03__templates.robot +17 -0
  59. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/04__bdd.robot +10 -0
  60. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/05__embedded.robot +13 -0
  61. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/__init__.robot +6 -0
  62. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/__init__.robot +7 -0
  63. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/users.robot +18 -0
  64. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/env.robot +15 -0
  65. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/common.py +11 -0
  66. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/dev.yaml +3 -0
  67. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/staging.yaml +3 -0
  68. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/arguments.md +139 -0
  69. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/control-structures.md +175 -0
  70. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/embedded-arguments.md +135 -0
  71. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/migration.md +90 -0
  72. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/resources-and-variable-files.md +127 -0
  73. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/styles.md +92 -0
  74. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/suites-and-init.md +96 -0
  75. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/tags-and-selection.md +104 -0
  76. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/templates.md +124 -0
  77. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/variables-and-scopes.md +129 -0
  78. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/scripts/rf_conventions.py +883 -0
  79. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/SKILL.md +216 -0
  80. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ExampleLibrary.py +61 -0
  81. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ResultListener.py +60 -0
  82. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.py +48 -0
  83. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.robot +20 -0
  84. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/example_library.robot +31 -0
  85. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/listener.robot +12 -0
  86. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/api-variants.md +291 -0
  87. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/communication.md +248 -0
  88. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/conversion.md +347 -0
  89. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/listeners.md +150 -0
  90. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/packaging-and-docs.md +155 -0
  91. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/scripts/check_library.py +842 -0
  92. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/SKILL.md +159 -0
  93. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/github-actions-robot.yml +32 -0
  94. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/gitignore.txt +22 -0
  95. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.poetry.toml +28 -0
  96. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.uv.toml +20 -0
  97. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/requirements.txt +9 -0
  98. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/robot.toml +16 -0
  99. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/smoke.robot +22 -0
  100. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/ci.md +61 -0
  101. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/cli-tools.md +33 -0
  102. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/libraries.md +47 -0
  103. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/poetry.md +77 -0
  104. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/project-layout.md +86 -0
  105. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/troubleshooting.md +73 -0
  106. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/uv.md +108 -0
  107. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/venv-pip.md +71 -0
  108. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-debug-expert.toml +103 -0
  109. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-migration-guide.toml +72 -0
  110. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-test-architect.toml +97 -0
  111. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-debug-expert.md +107 -0
  112. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-migration-guide.md +76 -0
  113. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-test-architect.md +101 -0
  114. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/plugins/rf-core.js +93 -0
  115. robotframework_plugins/_assets/plugins/rf-desktop/.claude-plugin/plugin.json +24 -0
  116. robotframework_plugins/_assets/plugins/rf-desktop/CHANGELOG.md +9 -0
  117. robotframework_plugins/_assets/plugins/rf-desktop/README.md +26 -0
  118. robotframework_plugins/_assets/plugins/rf-desktop/catalog.yaml +23 -0
  119. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/SKILL.md +266 -0
  120. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/calculator.robot +45 -0
  121. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/mock-deterministic.robot +33 -0
  122. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/cli-and-inspector.md +82 -0
  123. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/install.md +14 -0
  124. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/keywords-reference.md +102 -0
  125. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/locators-and-queries.md +95 -0
  126. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/platform-setup.md +65 -0
  127. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/status-and-migration.md +41 -0
  128. robotframework_plugins/_assets/plugins/rf-mobile/.claude-plugin/plugin.json +24 -0
  129. robotframework_plugins/_assets/plugins/rf-mobile/CHANGELOG.md +9 -0
  130. robotframework_plugins/_assets/plugins/rf-mobile/README.md +26 -0
  131. robotframework_plugins/_assets/plugins/rf-mobile/catalog.yaml +23 -0
  132. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/SKILL.md +134 -0
  133. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/android-basic.robot +60 -0
  134. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/gestures-example.robot +59 -0
  135. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/hybrid-app.robot +54 -0
  136. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/ios-basic.robot +48 -0
  137. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/capabilities.md +117 -0
  138. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/gestures-touch.md +84 -0
  139. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/install.md +21 -0
  140. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/locators-mobile.md +74 -0
  141. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/platform-specific.md +105 -0
  142. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/troubleshooting.md +70 -0
  143. robotframework_plugins/_assets/plugins/rf-web/.claude-plugin/plugin.json +25 -0
  144. robotframework_plugins/_assets/plugins/rf-web/CHANGELOG.md +9 -0
  145. robotframework_plugins/_assets/plugins/rf-web/README.md +27 -0
  146. robotframework_plugins/_assets/plugins/rf-web/catalog.yaml +27 -0
  147. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/SKILL.md +132 -0
  148. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/authentication-flow.robot +34 -0
  149. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/basic-web-test.robot +29 -0
  150. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/form-handling.robot +49 -0
  151. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/iframe-shadow-dom.robot +31 -0
  152. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/assertion-engine.md +79 -0
  153. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/authentication-storage.md +86 -0
  154. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/browser-context-page.md +110 -0
  155. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/downloads-uploads.md +51 -0
  156. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/iframes-shadow-dom.md +67 -0
  157. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/install.md +67 -0
  158. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/locators.md +83 -0
  159. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/migrate-from-selenium.md +22 -0
  160. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/troubleshooting.md +100 -0
  161. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/SKILL.md +123 -0
  162. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/basic-web-test.robot +64 -0
  163. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/multi-window.robot +55 -0
  164. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/wait-patterns.robot +53 -0
  165. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/browser-setup.md +103 -0
  166. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/frames-windows.md +84 -0
  167. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/install.md +12 -0
  168. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/javascript-execution.md +65 -0
  169. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/locators.md +86 -0
  170. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/troubleshooting.md +122 -0
  171. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/waiting-strategies.md +84 -0
  172. robotframework_plugins/_assets.py +120 -0
  173. robotframework_plugins/_catalog.py +123 -0
  174. robotframework_plugins/_snapshot.py +230 -0
  175. robotframework_plugins/adapters/__init__.py +53 -0
  176. robotframework_plugins/adapters/_base.py +400 -0
  177. robotframework_plugins/adapters/claude_code.py +312 -0
  178. robotframework_plugins/adapters/claude_desktop.py +129 -0
  179. robotframework_plugins/adapters/codex.py +276 -0
  180. robotframework_plugins/adapters/copilot.py +87 -0
  181. robotframework_plugins/adapters/cursor.py +295 -0
  182. robotframework_plugins/adapters/goose.py +240 -0
  183. robotframework_plugins/adapters/opencode.py +170 -0
  184. robotframework_plugins/bundle.py +85 -0
  185. robotframework_plugins/cli.py +1311 -0
  186. robotframework_plugins/detect.py +121 -0
  187. robotframework_plugins/manifest.py +338 -0
  188. robotframework_plugins/py.typed +0 -0
  189. robotframework_plugins/skillzip.py +39 -0
  190. robotframework_plugins/transforms.py +725 -0
  191. robotframework_plugins-2026.11.0.dev1.dist-info/METADATA +178 -0
  192. robotframework_plugins-2026.11.0.dev1.dist-info/RECORD +195 -0
  193. robotframework_plugins-2026.11.0.dev1.dist-info/WHEEL +4 -0
  194. robotframework_plugins-2026.11.0.dev1.dist-info/entry_points.txt +2 -0
  195. 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.