@openhands/extensions 0.7.2 → 0.9.0

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.7.2"
+  ".": "0.9.0"
 }

package/README.md

@@ -87,7 +87,7 @@ The JS and Python versions are kept in lock-step by `release-please` and guarded
 ## Extensions Catalog
 
 <!-- BEGIN AUTO-GENERATED CATALOG -->
-This repository contains **2 marketplace(s)** with **60 extensions** (50 skills, 10 plugins).
+This repository contains **2 marketplace(s)** with **62 extensions** (52 skills, 10 plugins).
 
 ### large-codebase
 
@@ -106,7 +106,7 @@ OpenHands skills for interacting, improving, and refactoring large codebases
 
 Official skills and plugins for OpenHands — the open-source AI software engineer.
 
-**56 extensions** (48 skills, 8 plugins)
+**58 extensions** (50 skills, 8 plugins)
 
 | Name | Type | Description | Commands |
 |------|------|-------------|----------|
@@ -137,6 +137,7 @@ Official skills and plugins for OpenHands — the open-source AI software engine
 | gitlab | skill | Interact with GitLab repositories, merge requests, and APIs using the GITLAB_TOKEN environment variable. Use when wor... | — |
 | incident-retrospective | skill | Create an automation that drafts incident retrospectives by gathering incident-channel messages from Slack, collectin... | `/incident-retro:setup` |
 | iterate | skill | Iterate on a GitHub pull request — drive it through CI, code review, and QA until merge-ready. Monitors state, fixes ... | `/iterate`, `/verify`, `/babysit` |
+| jira-issue-to-pr | skill | Deploy a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable lab... | — |
 | jupyter | skill | Read, modify, execute, and convert Jupyter notebooks programmatically. Use when working with .ipynb files for data sc... | — |
 | kubernetes | skill | Set up and manage local Kubernetes clusters using KIND (Kubernetes IN Docker). Use when testing Kubernetes applicatio... | — |
 | learn-from-code-review | skill | Distill code review feedback from GitHub PRs into reusable skills and guidelines. Use when users ask to learn from co... | `/learn-from-reviews` |
@@ -151,6 +152,7 @@ Official skills and plugins for OpenHands — the open-source AI software engine
 | openhands-automation | skill | Create and manage OpenHands automations - scheduled tasks that run in sandboxes. Use the prompt preset to create auto... | `/automation:create` |
 | openhands-sdk | skill | Reference skill for the OpenHands Software Agent SDK - build AI agents with custom tools, LLM configuration, conversa... | `/sdk` |
 | pdflatex | skill | Install and use pdflatex to compile LaTeX documents into PDFs on Linux. Use when generating academic papers, research... | — |
+| plain-english-content | skill | Write and edit clear, accessible prose in a plain English content style: active voice, front-loaded content, sentence... | — |
 | pr-review | plugin | Automated PR code review — analyzes diffs and posts inline review comments via the GitHub API. | — |
 | prd | skill | Generate a Product Requirements Document (PRD) for a new feature through an interactive clarifying-question workflow.... | `/prd` |
 | qa-changes | plugin | Validate pull request changes by actually running the code — setting up the environment, exercising changed behavior,... | — |

package/automations/catalog/jira-issue-to-pr.json

@@ -0,0 +1,14 @@
+{
+  "id": "jira-issue-to-pr",
+  "name": "Jira issue to GitHub PR",
+  "category": "Project management",
+  "description": "Watch a Jira Cloud project for issues with a configurable label and automatically open a GitHub pull request for each new issue found. The target GitHub repo is read from the ticket body - no repo parameter required at deploy time.",
+  "requiredIntegrationIds": [
+    "jira",
+    "github"
+  ],
+  "popularityRank": 85,
+  "estimatedSetupMinutes": 5,
+  "prompt": "Set up a Jira automation to create pull requests",
+  "exampleImplementation": "Trigger: cron polling (e.g. every 5 minutes)\nRequired secrets: Jira API token, GitHub personal access token (repo + workflow scope)\n\n1. Collect Jira base URL, email, API token secret name, label to watch, and cron schedule from the user. No GitHub repo is needed at deploy time - each ticket must include the target repo (owner/repo) in its body.\n2. Poll POST /rest/api/3/search/jql on the Jira Cloud instance to find open issues carrying the configured label.\n3. Deduplicate against a KV-store-backed set of already-processed issue keys so re-runs never create duplicate PRs.\n4. For each new issue, start an independent OpenHands agent conversation that extracts the GitHub repo from the ticket body, clones it, creates a branch named after the Jira key, implements or scaffolds the requested change, and opens a pull request.\n5. Immediately after the conversation is created, post a Jira comment on the issue: 'I'm on it: <conversation URL>'.\n6. Persist the processed issue key immediately after dispatching so the next poll skips it."
+}

package/automations/index.js

@@ -5,6 +5,7 @@ import slack_channel_monitor from "./catalog/slack-channel-monitor.json" with {
 import linear_triage_assistant from "./catalog/linear-triage-assistant.json" with { type: "json" };
 import research_brief_writer from "./catalog/research-brief-writer.json" with { type: "json" };
 import incident_retrospective_drafter from "./catalog/incident-retrospective-drafter.json" with { type: "json" };
+import jira_issue_to_pr from "./catalog/jira-issue-to-pr.json" with { type: "json" };
 
 export const AUTOMATION_CATALOG = [
   github_pr_reviewer,
@@ -14,5 +15,6 @@ export const AUTOMATION_CATALOG = [
   linear_triage_assistant,
   research_brief_writer,
   incident_retrospective_drafter,
+  jira_issue_to_pr,
 ];
 export default AUTOMATION_CATALOG;

package/integrations/catalog/atlassian.json

@@ -1,8 +1,13 @@
 {
   "id": "atlassian",
   "name": "Atlassian (Jira & Confluence)",
-  "description": "Search Jira issues and Confluence pages via Atlassian's hosted MCP server.",
-  "docsUrl": "https://www.atlassian.com/platform/remote-mcp-server",
+  "description": "Search Jira issues, manage tickets, and read Confluence pages from your agent.",
+  "categories": [
+    "Project management",
+    "Documentation"
+  ],
+  "appUrl": "https://www.atlassian.com",
+  "docsUrl": "https://mcp-atlassian.soomiles.com/docs/installation",
   "iconBg": "#0052CC",
   "logoUrl": "https://cdn.simpleicons.org/atlassian/FFFFFF",
   "keywords": [
@@ -10,8 +15,11 @@
     "confluence",
     "tickets",
     "wiki",
-    "issues"
+    "issues",
+    "sprint"
   ],
+  "popularityRank": 88,
+  "installHint": "Paste your Jira and/or Confluence URL and API token. The mcp-atlassian package runs via uvx - no install needed.",
   "connectionOptions": [
     {
       "id": "oauth",
@@ -23,6 +31,73 @@
       "auth": {
         "strategy": "oauth2"
       }
+    },
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "mcp-atlassian",
+        "command": "uvx",
+        "args": [
+          "mcp-atlassian"
+        ],
+        "envFields": [
+          {
+            "key": "JIRA_URL",
+            "label": "Jira URL",
+            "type": "text",
+            "placeholder": "https://your-company.atlassian.net",
+            "required": false,
+            "helperText": "Your Atlassian Jira base URL. Omit if using Confluence only."
+          },
+          {
+            "key": "JIRA_USERNAME",
+            "label": "Jira username (email)",
+            "type": "text",
+            "placeholder": "your.email@company.com",
+            "required": false,
+            "helperText": "Email address linked to your Atlassian account."
+          },
+          {
+            "key": "JIRA_API_TOKEN",
+            "label": "Jira API token",
+            "type": "password",
+            "placeholder": "ATATT...",
+            "required": false,
+            "helperText": "Atlassian API token for Jira. Required when JIRA_URL is set.",
+            "helperLink": "https://id.atlassian.com/manage-profile/security/api-tokens"
+          },
+          {
+            "key": "CONFLUENCE_URL",
+            "label": "Confluence URL",
+            "type": "text",
+            "placeholder": "https://your-company.atlassian.net/wiki",
+            "required": false,
+            "helperText": "Your Atlassian Confluence base URL. Omit if using Jira only."
+          },
+          {
+            "key": "CONFLUENCE_USERNAME",
+            "label": "Confluence username (email)",
+            "type": "text",
+            "placeholder": "your.email@company.com",
+            "required": false,
+            "helperText": "Email address linked to your Atlassian account."
+          },
+          {
+            "key": "CONFLUENCE_API_TOKEN",
+            "label": "Confluence API token",
+            "type": "password",
+            "placeholder": "ATATT...",
+            "required": false,
+            "helperText": "Atlassian API token for Confluence. Required when CONFLUENCE_URL is set.",
+            "helperLink": "https://id.atlassian.com/manage-profile/security/api-tokens"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
     }
   ]
 }

package/integrations/catalog/datadog.json

@@ -8,8 +8,9 @@
   ],
   "appUrl": "https://www.datadoghq.com",
   "docsUrl": "https://docs.datadoghq.com/bits_ai/mcp_server/setup/",
-  "notes": "Uses Datadog's official hosted MCP server. The default registration targets the US1 endpoint and can be edited for other Datadog sites.",
+  "notes": "Uses Datadog's official hosted MCP server. The MCP endpoint host is site-specific: use https://mcp.<site>.datadoghq.com/v1/mcp for your Datadog site (e.g. mcp.us5.datadoghq.com for US5). The default URL below targets US1 and can be edited in the install dialog.",
   "popularityRank": 35,
+  "installHint": "The Datadog MCP URL is site-specific. Edit the URL to https://mcp.<site>.datadoghq.com/v1/mcp for your Datadog site (for example https://mcp.us5.datadoghq.com/v1/mcp for US5, https://mcp.eu.datadoghq.com/v1/mcp for EU). Find your site at Organization Settings → Site in Datadog.",
   "connectionOptions": [
     {
       "id": "oauth",
@@ -27,7 +28,37 @@
       },
       "transport": {
         "kind": "shttp",
-        "url": "https://mcp.datadoghq.com/api/unstable/mcp-server/mcp"
+        "url": "https://mcp.datadoghq.com/v1/mcp"
+      }
+    },
+    {
+      "id": "api",
+      "provider": "mcp",
+      "auth": {
+        "strategy": "none"
+      },
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.datadoghq.com/v1/mcp",
+        "urlEditable": true,
+        "headerFields": [
+          {
+            "key": "DD-API-KEY",
+            "label": "Datadog API key",
+            "type": "password",
+            "required": true,
+            "placeholder": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            "helperText": "Created in Datadog under Organization Settings → API Keys. Used to authenticate to the Datadog MCP server. See the [setup docs](https://docs.datadoghq.com/mcp_server/setup/?tab=other#authentication)."
+          },
+          {
+            "key": "DD-APPLICATION-KEY",
+            "label": "Datadog Application key",
+            "type": "password",
+            "required": true,
+            "placeholder": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            "helperText": "Created in Datadog under Organization Settings → Application Keys. Grants the MCP server access to your Datadog data. See the [setup docs](https://docs.datadoghq.com/mcp_server/setup/?tab=other#authentication)."
+          }
+        ]
       }
     }
   ]

package/integrations/catalog/notion.json

@@ -10,6 +10,22 @@
   "docsUrl": "https://developers.notion.com/docs/mcp",
   "popularityRank": 82,
   "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://api.notion.com/v1/oauth/authorize",
+          "tokenUrl": "https://api.notion.com/v1/oauth/token",
+          "scopes": []
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.notion.com",
+        "openApiUrl": "https://developers.notion.com/openapi.json"
+      }
+    },
     {
       "id": "api",
       "provider": "mcp",
@@ -36,22 +52,6 @@
       "auth": {
         "strategy": "api_key"
       }
-    },
-    {
-      "id": "oauth",
-      "provider": "http",
-      "auth": {
-        "strategy": "oauth2",
-        "oauth": {
-          "authorizationUrl": "https://api.notion.com/v1/oauth/authorize",
-          "tokenUrl": "https://api.notion.com/v1/oauth/token",
-          "scopes": []
-        }
-      },
-      "http": {
-        "apiBaseUrl": "https://api.notion.com",
-        "openApiUrl": "https://developers.notion.com/openapi.json"
-      }
     }
   ],
   "iconBg": "#FFFFFF",

package/integrations/catalog/superhuman-mail.json

@@ -0,0 +1,36 @@
+{
+  "id": "superhuman-mail",
+  "name": "Superhuman Mail",
+  "description": "Search, read, draft, and send email via Superhuman's hosted MCP server.",
+  "categories": [
+    "Communication",
+    "Email"
+  ],
+  "appUrl": "https://superhuman.com",
+  "docsUrl": "https://github.com/superhuman/mcp-mail",
+  "notes": "OAuth is handled by the Superhuman MCP server itself (mcp-remote). No client credentials required.",
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.mail.superhuman.com/mcp"
+      },
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "clientAuthentication": "none"
+        }
+      }
+    }
+  ],
+  "iconBg": "#FF5C28",
+  "logoUrl": "https://cdn.simpleicons.org/superhuman/FFFFFF",
+  "keywords": [
+    "email",
+    "mail",
+    "superhuman",
+    "inbox"
+  ]
+}

package/integrations/catalog-index.js

@@ -5,48 +5,48 @@
 import entry0 from "./catalog/github.json" with { type: "json" };
 import entry1 from "./catalog/slack.json" with { type: "json" };
 import entry2 from "./catalog/tavily.json" with { type: "json" };
-import entry3 from "./catalog/linear.json" with { type: "json" };
-import entry4 from "./catalog/notion.json" with { type: "json" };
-import entry5 from "./catalog/ordinal.json" with { type: "json" };
-import entry6 from "./catalog/elevenlabs.json" with { type: "json" };
-import entry7 from "./catalog/bitbucket.json" with { type: "json" };
-import entry8 from "./catalog/xero.json" with { type: "json" };
-import entry9 from "./catalog/quickbooks.json" with { type: "json" };
-import entry10 from "./catalog/okta.json" with { type: "json" };
-import entry11 from "./catalog/netlify.json" with { type: "json" };
-import entry12 from "./catalog/vercel.json" with { type: "json" };
-import entry13 from "./catalog/supabase.json" with { type: "json" };
-import entry14 from "./catalog/posthog.json" with { type: "json" };
-import entry15 from "./catalog/sentry.json" with { type: "json" };
-import entry16 from "./catalog/datadog.json" with { type: "json" };
-import entry17 from "./catalog/canva.json" with { type: "json" };
-import entry18 from "./catalog/miro.json" with { type: "json" };
-import entry19 from "./catalog/webflow.json" with { type: "json" };
-import entry20 from "./catalog/zoom.json" with { type: "json" };
-import entry21 from "./catalog/discord.json" with { type: "json" };
-import entry22 from "./catalog/stripe.json" with { type: "json" };
-import entry23 from "./catalog/intercom.json" with { type: "json" };
-import entry24 from "./catalog/hubspot.json" with { type: "json" };
-import entry25 from "./catalog/salesforce.json" with { type: "json" };
-import entry26 from "./catalog/sharepoint.json" with { type: "json" };
-import entry27 from "./catalog/onedrive.json" with { type: "json" };
-import entry28 from "./catalog/microsoft-teams.json" with { type: "json" };
-import entry29 from "./catalog/microsoft-outlook.json" with { type: "json" };
-import entry30 from "./catalog/box.json" with { type: "json" };
-import entry31 from "./catalog/airtable.json" with { type: "json" };
-import entry32 from "./catalog/monday.json" with { type: "json" };
-import entry33 from "./catalog/trello.json" with { type: "json" };
-import entry34 from "./catalog/asana.json" with { type: "json" };
-import entry35 from "./catalog/confluence.json" with { type: "json" };
-import entry36 from "./catalog/jira.json" with { type: "json" };
-import entry37 from "./catalog/google-calendar.json" with { type: "json" };
-import entry38 from "./catalog/gmail.json" with { type: "json" };
-import entry39 from "./catalog/google-sheets.json" with { type: "json" };
-import entry40 from "./catalog/google-drive.json" with { type: "json" };
-import entry41 from "./catalog/figma.json" with { type: "json" };
-import entry42 from "./catalog/google-docs.json" with { type: "json" };
-import entry43 from "./catalog/apify.json" with { type: "json" };
-import entry44 from "./catalog/atlassian.json" with { type: "json" };
+import entry3 from "./catalog/atlassian.json" with { type: "json" };
+import entry4 from "./catalog/linear.json" with { type: "json" };
+import entry5 from "./catalog/notion.json" with { type: "json" };
+import entry6 from "./catalog/ordinal.json" with { type: "json" };
+import entry7 from "./catalog/elevenlabs.json" with { type: "json" };
+import entry8 from "./catalog/bitbucket.json" with { type: "json" };
+import entry9 from "./catalog/xero.json" with { type: "json" };
+import entry10 from "./catalog/quickbooks.json" with { type: "json" };
+import entry11 from "./catalog/okta.json" with { type: "json" };
+import entry12 from "./catalog/netlify.json" with { type: "json" };
+import entry13 from "./catalog/vercel.json" with { type: "json" };
+import entry14 from "./catalog/supabase.json" with { type: "json" };
+import entry15 from "./catalog/posthog.json" with { type: "json" };
+import entry16 from "./catalog/sentry.json" with { type: "json" };
+import entry17 from "./catalog/datadog.json" with { type: "json" };
+import entry18 from "./catalog/canva.json" with { type: "json" };
+import entry19 from "./catalog/miro.json" with { type: "json" };
+import entry20 from "./catalog/webflow.json" with { type: "json" };
+import entry21 from "./catalog/zoom.json" with { type: "json" };
+import entry22 from "./catalog/discord.json" with { type: "json" };
+import entry23 from "./catalog/stripe.json" with { type: "json" };
+import entry24 from "./catalog/intercom.json" with { type: "json" };
+import entry25 from "./catalog/hubspot.json" with { type: "json" };
+import entry26 from "./catalog/salesforce.json" with { type: "json" };
+import entry27 from "./catalog/sharepoint.json" with { type: "json" };
+import entry28 from "./catalog/onedrive.json" with { type: "json" };
+import entry29 from "./catalog/microsoft-teams.json" with { type: "json" };
+import entry30 from "./catalog/microsoft-outlook.json" with { type: "json" };
+import entry31 from "./catalog/box.json" with { type: "json" };
+import entry32 from "./catalog/airtable.json" with { type: "json" };
+import entry33 from "./catalog/monday.json" with { type: "json" };
+import entry34 from "./catalog/trello.json" with { type: "json" };
+import entry35 from "./catalog/asana.json" with { type: "json" };
+import entry36 from "./catalog/confluence.json" with { type: "json" };
+import entry37 from "./catalog/jira.json" with { type: "json" };
+import entry38 from "./catalog/google-calendar.json" with { type: "json" };
+import entry39 from "./catalog/gmail.json" with { type: "json" };
+import entry40 from "./catalog/google-sheets.json" with { type: "json" };
+import entry41 from "./catalog/google-drive.json" with { type: "json" };
+import entry42 from "./catalog/figma.json" with { type: "json" };
+import entry43 from "./catalog/google-docs.json" with { type: "json" };
+import entry44 from "./catalog/apify.json" with { type: "json" };
 import entry45 from "./catalog/brave-search.json" with { type: "json" };
 import entry46 from "./catalog/browser-mcp.json" with { type: "json" };
 import entry47 from "./catalog/clickhouse.json" with { type: "json" };
@@ -73,7 +73,8 @@ import entry67 from "./catalog/playwright.json" with { type: "json" };
 import entry68 from "./catalog/redis.json" with { type: "json" };
 import entry69 from "./catalog/resend.json" with { type: "json" };
 import entry70 from "./catalog/sequential-thinking.json" with { type: "json" };
-import entry71 from "./catalog/time.json" with { type: "json" };
+import entry71 from "./catalog/superhuman-mail.json" with { type: "json" };
+import entry72 from "./catalog/time.json" with { type: "json" };
 
 export const INTEGRATION_CATALOG_ENTRIES = [
   entry0,
@@ -148,4 +149,5 @@ export const INTEGRATION_CATALOG_ENTRIES = [
   entry69,
   entry70,
   entry71,
+  entry72,
 ];

package/marketplaces/openhands-extensions.json

@@ -728,6 +728,25 @@
         "cron",
         "automation"
       ]
+    },
+    {
+      "name": "plain-english-content",
+      "source": "./skills/plain-english-content",
+      "description": "Write and edit clear, accessible prose in a plain English content style: active voice, front-loaded content, sentence case, and accessible formatting.",
+      "category": "productivity",
+      "keywords": [
+        "plain-english"
+      ]
+    },
+    {
+      "name": "jira-issue-to-pr",
+      "source": "./skills/jira-issue-to-pr",
+      "description": "Deploy a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable label (default: create-pr) and spawns an agent conversation to create a GitHub pull request for each new issue found. The target GitHub repo is read from the ticket body - no repo parameter required at deploy time.",
+      "category": "productivity",
+      "keywords": [
+        "jira",
+        "atlassian"
+      ]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/extensions",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "Public OpenHands extension catalogs for skills, plugins, integrations, and automation templates.",
   "license": "MIT",
   "type": "module",

package/plugins/cobol-modernization/skills/build-setup/SKILL.md

@@ -13,6 +13,7 @@ triggers:
 Set up a build environment and create test fixtures for validating COBOL-to-Java migrations.
 
 To install GnuCOBOL, run: `./scripts/install-gnucobol.sh`
+On Windows, run that shell script from Git Bash/WSL (`bash scripts/install-gnucobol.sh`) or install GnuCOBOL with a Windows package manager and document the chosen command in `build_notes.md`.
 
 ## Phase 1: Build Setup
 

package/plugins/cobol-modernization/skills/cobol-modernization/SKILL.md

@@ -37,6 +37,15 @@ export LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
 uv run python -m lc_sdk_examples.cobol_modernization --src-path /path/to/cobol/project
 ```
 
+PowerShell equivalent for the environment setup:
+
+```powershell
+$env:LLM_API_KEY = "your-api-key"
+$env:LLM_MODEL = "anthropic/claude-3-5-sonnet-20241022"
+
+uv run python -m lc_sdk_examples.cobol_modernization --src-path C:\path\to\cobol\project
+```
+
 ## Workflow Phases
 
 ### Phase 1: Build Setup

package/plugins/migration-scoring/skills/migration-scoring/SKILL.md

@@ -39,6 +39,17 @@ uv run python -m lc_sdk_examples.migration_scoring \
   --rubric-path /path/to/style_rubric.txt
 ```
 
+PowerShell equivalent for the environment setup:
+
+```powershell
+$env:LLM_API_KEY = "your-api-key"
+$env:LLM_MODEL = "anthropic/claude-3-5-sonnet-20241022"
+
+uv run python -m lc_sdk_examples.migration_scoring `
+  --src-path C:\path\to\migration\project `
+  --rubric-path C:\path\to\style_rubric.txt
+```
+
 ## Workflow Phases
 
 ### Phase 1: Migration Mapping

package/plugins/onboarding/skills/agent-readiness-report/SKILL.md

@@ -51,6 +51,8 @@ Or scan all five at once:
 for s in scripts/scan_*.sh; do bash "$s" /path/to/repo; echo; done
 ```
 
+On Windows, run these `.sh` helpers from Git Bash or WSL and pass a path that environment can read. Native PowerShell cannot execute the shell scripts directly.
+
 **Important**: The scripts are helpers, not scorers.  They find files and
 patterns but do not evaluate quality.  Many features require judgment that only
 reading the actual files can provide — for example, whether a README includes

package/plugins/openhands/SKILL.md

@@ -31,6 +31,12 @@ This plugin provides a unified entry point and the CLI integration script.
 command -v openhands &>/dev/null && echo "CLI available" || echo "CLI not found"
 ```
 
+PowerShell check:
+
+```powershell
+if (Get-Command openhands -ErrorAction SilentlyContinue) { "CLI available" } else { "CLI not found" }
+```
+
 2. **If CLI is available**, use it — it manages auth and API keys automatically.
 3. **If CLI is not available**, check for an API key:
    - Preferred env var: `OPENHANDS_CLOUD_API_KEY`
@@ -49,6 +55,7 @@ command -v openhands &>/dev/null && echo "CLI available" || echo "CLI not found"
 ```
 
 The script checks for the CLI, installs it if needed, sends the task, and opens the resulting conversation URL.
+On Windows, run this POSIX shell script from Git Bash or WSL (`bash scripts/run.sh "Investigate flaky tests in tests/test_api.py"`) unless a native PowerShell launcher is available.
 
 If the script exits with code `2` (`AUTH_REQUIRED`), ask the user to complete authentication in the browser, then re-run.
 

package/plugins/release-notes/SKILL.md

@@ -32,6 +32,15 @@ curl -o .github/workflows/release-notes.yml \
   https://raw.githubusercontent.com/OpenHands/extensions/main/plugins/release-notes/workflows/release-notes.yml
 ```
 
+PowerShell equivalent:
+
+```powershell
+New-Item -ItemType Directory -Force .github\workflows | Out-Null
+Invoke-WebRequest `
+  -Uri https://raw.githubusercontent.com/OpenHands/extensions/main/plugins/release-notes/workflows/release-notes.yml `
+  -OutFile .github\workflows\release-notes.yml
+```
+
 Configure required secrets (see the README for details).
 
 ### Manual Invocation

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openhands-extensions"
-version = "0.7.2"
+version = "0.9.0"
 description = "OpenHands extensions, plugins, and skills (Python bindings for the integration catalog)"
 requires-python = ">=3.12"
 

package/python/openhands_extensions/_version.py

@@ -17,7 +17,7 @@ from importlib.metadata import PackageNotFoundError, version
 #: Fallback used only when the package is not installed (no dist metadata).
 #: Kept in lock-step with pyproject.toml/package.json by the version test.
 # x-release-please-update-version
-_FALLBACK_VERSION = "0.7.2"
+_FALLBACK_VERSION = "0.9.0"
 
 try:
     __version__: str = version("openhands-extensions")

package/scripts/build-skills-catalog.mjs

@@ -61,7 +61,7 @@ export function buildCatalog(skillsDir) {
     const skillMd = join(dirPath, "SKILL.md");
     if (!existsSync(skillMd)) continue;
 
-    const raw = readFileSync(skillMd, "utf-8");
+    const raw = readFileSync(skillMd, "utf-8").replace(/\r\n?/g, "\n");
     const parts = raw.split("---");
     if (parts.length < 3) {
       console.warn(`Warning: ${skillMd} missing frontmatter sections, skipping`);

package/skills/add-skill/SKILL.md

@@ -38,6 +38,8 @@ python3 scripts/fetch_skill.py "https://github.com/OpenHands/extensions/tree/mai
 ls /path/to/workspace/.agents/skills/codereview/SKILL.md
 ```
 
+On Windows, use `python` if `python3` is not available and verify with PowerShell, for example: `Test-Path C:\path\to\workspace\.agents\skills\codereview\SKILL.md`.
+
 Response: "✅ Added `codereview` to your workspace. The skill is now available."
 
 ## Notes

package/skills/azure-devops/SKILL.md

@@ -30,6 +30,8 @@ git remote -v && git branch # to find the current org, repo and branch
 git checkout -b create-widget && git add . && git commit -m "Create widget" && git push -u origin create-widget
 ```
 
+On Windows PowerShell, run those `git` commands as separate commands if `&&` is not supported by the installed shell.
+
 ## Azure DevOps API Usage
 
 When working with Azure DevOps API, you need to use Basic authentication with your Personal Access Token (PAT). The username is ignored (empty string), and the password is the PAT.
@@ -43,8 +45,17 @@ AUTH=$(echo -n ":$AZURE_DEVOPS_TOKEN" | base64)
 curl -H "Authorization: Basic $AUTH" -H "Content-Type: application/json" https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1
 ```
 
+PowerShell equivalent for the PAT header:
+
+```powershell
+$auth = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$env:AZURE_DEVOPS_TOKEN"))
+Invoke-RestMethod `
+  -Headers @{ Authorization = "Basic $auth"; "Content-Type" = "application/json" } `
+  -Uri "https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1"
+```
+
 Common API endpoints:
 - List repositories: `https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1`
 - Get repository details: `https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}?api-version=7.1`
 - List pull requests: `https://dev.azure.com/{organization}/{project}/_apis/git/pullrequests?api-version=7.1`
-- Create pull request: `https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1` (POST)
+- Create pull request: `https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1` (POST)

package/skills/bitbucket-cloud/SKILL.md

@@ -28,6 +28,15 @@ ENCODED_PASS=$(python3 -c 'import sys, urllib.parse; print(urllib.parse.quote(sy
 git remote set-url origin "https://${ENCODED_USER}:${ENCODED_PASS}@bitbucket.org/username/repo.git"
 ```
 
+PowerShell equivalent for the remote URL encoding:
+
+```powershell
+$parts = $env:BITBUCKET_TOKEN -split ":", 2
+$encodedUser = [Uri]::EscapeDataString($parts[0])
+$encodedPass = [Uri]::EscapeDataString($parts[1])
+git remote set-url origin "https://${encodedUser}:${encodedPass}@bitbucket.org/username/repo.git"
+```
+
 Atlassian's Bitbucket Cloud docs recommend avoiding long-lived credentials in the remote URL when possible. Their API token examples use either `https://{bitbucket_username}:{api_token}@...` or `https://x-bitbucket-api-token-auth:{api_token}@...`; OpenHands users should only construct those URLs on demand, with proper URL encoding.
 
 Here are some instructions for pushing, but ONLY do this if the user asks you to:
@@ -44,3 +53,5 @@ Here are some instructions for pushing, but ONLY do this if the user asks you to
 git remote -v && git branch # to find the current org, repo and branch
 git checkout -b create-widget && git add . && git commit -m "Create widget" && git push -u origin create-widget
 ```
+
+On Windows PowerShell, run those `git` commands as separate commands if `&&` is not supported by the installed shell.