@openhands/extensions 0.0.1-alpha → 0.2.0

package/skills/github-repo-monitor/tests/test_main.py

@@ -0,0 +1,400 @@
+"""Unit tests for github-repo-monitor main.py.
+
+Run from the skill root:
+    python -m pytest tests/
+or with the standard library runner:
+    python -m unittest discover tests
+"""
+
+import json
+import os
+import sys
+import tempfile
+import time
+import unittest
+from pathlib import Path
+from unittest.mock import MagicMock, patch, call
+
+# Allow importing main.py from the sibling scripts/ directory.
+sys.path.insert(0, str(Path(__file__).parent.parent / "scripts"))
+import main  # noqa: E402
+
+
+# ── Helpers ────────────────────────────────────────────────────────────────────
+
+def _make_comment(body="hello @openhands", login="octocat", user_type="User"):
+    return {"id": 1, "body": body, "user": {"login": login, "type": user_type},
+            "issue_url": "https://api.github.com/repos/owner/repo/issues/7"}
+
+
+# ── State file tests ───────────────────────────────────────────────────────────
+
+class TestLoadState(unittest.TestCase):
+
+    def test_missing_file_returns_default(self):
+        state = main.load_state("/nonexistent/path/state.json")
+        self.assertIn("conversations", state)
+        self.assertIn("processed_comment_ids", state)
+        self.assertEqual(state["version"], 1)
+
+    def test_valid_json_is_loaded(self):
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+            json.dump({"version": 1, "custom": "value", "conversations": {}}, f)
+            path = f.name
+        try:
+            state = main.load_state(path)
+            self.assertEqual(state["custom"], "value")
+        finally:
+            os.unlink(path)
+
+    def test_corrupted_json_returns_default(self):
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+            f.write("{this is not valid json!!!}")
+            path = f.name
+        try:
+            state = main.load_state(path)
+            # Should return the default state rather than raising.
+            self.assertIn("conversations", state)
+            self.assertEqual(state["version"], 1)
+        finally:
+            os.unlink(path)
+
+    def test_empty_file_returns_default(self):
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+            f.write("")
+            path = f.name
+        try:
+            state = main.load_state(path)
+            self.assertIn("conversations", state)
+        finally:
+            os.unlink(path)
+
+
+class TestSaveAndLoadRoundtrip(unittest.TestCase):
+
+    def test_roundtrip(self):
+        data = {
+            "version": 1,
+            "conversations": {"42": {"conversation_id": "abc", "status": "active"}},
+            "processed_comment_ids": [1, 2, 3],
+        }
+        with tempfile.NamedTemporaryFile(suffix=".json", delete=False) as f:
+            path = f.name
+        try:
+            main.save_state(path, data)
+            loaded = main.load_state(path)
+            self.assertEqual(loaded["conversations"]["42"]["conversation_id"], "abc")
+            self.assertEqual(loaded["processed_comment_ids"], [1, 2, 3])
+        finally:
+            os.unlink(path)
+
+
+# ── Bot detection tests ────────────────────────────────────────────────────────
+
+class TestIsBotComment(unittest.TestCase):
+
+    def test_login_ends_with_bot_suffix(self):
+        self.assertTrue(main._is_bot_comment(
+            {"user": {"login": "dependabot[bot]", "type": "Bot"}}
+        ))
+
+    def test_login_ends_with_bot_suffix_human_type(self):
+        # Login suffix alone is sufficient.
+        self.assertTrue(main._is_bot_comment(
+            {"user": {"login": "mybot[bot]", "type": "User"}}
+        ))
+
+    def test_user_type_bot_without_suffix(self):
+        self.assertTrue(main._is_bot_comment(
+            {"user": {"login": "AutomationService", "type": "Bot"}}
+        ))
+
+    def test_human_user_returns_false(self):
+        self.assertFalse(main._is_bot_comment(
+            {"user": {"login": "octocat", "type": "User"}}
+        ))
+
+    def test_missing_user_returns_false(self):
+        self.assertFalse(main._is_bot_comment({}))
+
+    def test_null_user_returns_false(self):
+        self.assertFalse(main._is_bot_comment({"user": None}))
+
+    def test_login_containing_but_not_ending_with_bot(self):
+        # "botuser" does not end with "[bot]" — should be treated as human.
+        self.assertFalse(main._is_bot_comment(
+            {"user": {"login": "botuser", "type": "User"}}
+        ))
+
+
+# ── Author authorization tests ────────────────────────────────────────────────
+
+class TestAllowedCommentAuthor(unittest.TestCase):
+
+    def setUp(self):
+        self._original_allowed = main.ALLOWED_GITHUB_LOGINS
+
+    def tearDown(self):
+        main.ALLOWED_GITHUB_LOGINS = self._original_allowed
+
+    def test_default_token_owner_allows_owner(self):
+        main.ALLOWED_GITHUB_LOGINS = ["<TOKEN_OWNER>"]
+        comment = _make_comment(login="OctoCat")
+        self.assertTrue(main._is_allowed_comment_author(comment, "octocat"))
+
+    def test_default_token_owner_rejects_other_user(self):
+        main.ALLOWED_GITHUB_LOGINS = ["<TOKEN_OWNER>"]
+        comment = _make_comment(login="enyst")
+        self.assertFalse(main._is_allowed_comment_author(comment, "tofarr"))
+
+    def test_explicit_allowlist_is_case_insensitive(self):
+        main.ALLOWED_GITHUB_LOGINS = ["Enyst", "tofarr"]
+        comment = _make_comment(login="enyst")
+        self.assertTrue(main._is_allowed_comment_author(comment, "someone-else"))
+
+    def test_wildcard_allows_any_commenter(self):
+        main.ALLOWED_GITHUB_LOGINS = ["*"]
+        comment = _make_comment(login="anyone")
+        self.assertTrue(main._is_allowed_comment_author(comment, "octocat"))
+
+    def test_missing_author_is_rejected(self):
+        main.ALLOWED_GITHUB_LOGINS = ["*"]
+        self.assertFalse(main._is_allowed_comment_author({}, "octocat"))
+
+
+# ── Trigger phrase tests ───────────────────────────────────────────────────────
+
+class TestHasTrigger(unittest.TestCase):
+
+    def test_exact_match(self):
+        c = _make_comment(body="Please fix this @openhands")
+        self.assertTrue(main._has_trigger(c, "@openhands"))
+
+    def test_case_insensitive_upper(self):
+        c = _make_comment(body="Hey @OpenHands can you help?")
+        self.assertTrue(main._has_trigger(c, "@openhands"))
+
+    def test_case_insensitive_phrase_uppercase(self):
+        c = _make_comment(body="@openhands please look at this")
+        self.assertTrue(main._has_trigger(c, "@OPENHANDS"))
+
+    def test_custom_trigger_phrase(self):
+        c = _make_comment(body="yeehaw! this needs fixing")
+        self.assertTrue(main._has_trigger(c, "yeehaw!"))
+
+    def test_absent_phrase_returns_false(self):
+        c = _make_comment(body="Just a regular comment, nothing special")
+        self.assertFalse(main._has_trigger(c, "@openhands"))
+
+    def test_empty_body_returns_false(self):
+        c = _make_comment(body="")
+        self.assertFalse(main._has_trigger(c, "@openhands"))
+
+    def test_none_body_returns_false(self):
+        c = {"id": 1, "body": None, "user": {"login": "u", "type": "User"}}
+        self.assertFalse(main._has_trigger(c, "@openhands"))
+
+    def test_missing_body_returns_false(self):
+        c = {"id": 1, "user": {"login": "u", "type": "User"}}
+        self.assertFalse(main._has_trigger(c, "@openhands"))
+
+
+# ── Processed-ID deduplication tests ──────────────────────────────────────────
+
+class TestProcessedIdDeduplication(unittest.TestCase):
+    """
+    The dedup logic lives in main() but the set membership check is trivial.
+    These tests verify the state schema: processed_comment_ids is persisted
+    and re-hydrated correctly across simulated runs.
+    """
+
+    def test_ids_survive_save_and_load(self):
+        with tempfile.NamedTemporaryFile(suffix=".json", delete=False) as f:
+            path = f.name
+        try:
+            state = {"version": 1, "conversations": {},
+                     "processed_comment_ids": [101, 202, 303]}
+            main.save_state(path, state)
+            loaded = main.load_state(path)
+            self.assertIn(101, loaded["processed_comment_ids"])
+            self.assertIn(303, loaded["processed_comment_ids"])
+            self.assertNotIn(404, loaded["processed_comment_ids"])
+        finally:
+            os.unlink(path)
+
+
+# ── Conversation state transition tests ───────────────────────────────────────
+
+class TestEnsureConversation(unittest.TestCase):
+    """Tests for _ensure_conversation using mocked API calls."""
+
+    BASE_ARGS = dict(
+        agent_url="http://agent",
+        api_key="key",
+        conv_key="7",
+        issue_number=7,
+        is_pr=False,
+        html_url="https://github.com/owner/repo/issues/7",
+        prompt="Do something",
+        comment=_make_comment(),
+        item_type="issue",
+    )
+
+    @patch("main.create_conversation", return_value="new-conv-id")
+    def test_creates_new_when_no_existing(self, mock_create):
+        conversations = {}
+        conv_id, resumed = main._ensure_conversation(conversations=conversations,
+                                                      **self.BASE_ARGS)
+        self.assertEqual(conv_id, "new-conv-id")
+        self.assertFalse(resumed)
+        mock_create.assert_called_once()
+        self.assertEqual(conversations["7"]["status"], "active")
+
+    @patch("main.send_to_conversation")
+    def test_reopens_closed_conversation(self, mock_send):
+        conversations = {
+            "7": {"conversation_id": "old-conv-id", "status": "closed",
+                  "issue_number": 7, "last_activity": 0.0}
+        }
+        conv_id, resumed = main._ensure_conversation(conversations=conversations,
+                                                      **self.BASE_ARGS)
+        self.assertEqual(conv_id, "old-conv-id")
+        self.assertTrue(resumed)
+        mock_send.assert_called_once()
+        self.assertEqual(conversations["7"]["status"], "active")
+
+    @patch("main.create_conversation", return_value="fallback-conv-id")
+    @patch("main.send_to_conversation", side_effect=RuntimeError("gone"))
+    def test_fallback_to_new_when_closed_unreachable(self, mock_send, mock_create):
+        conversations = {
+            "7": {"conversation_id": "stale-conv-id", "status": "closed",
+                  "issue_number": 7, "last_activity": 0.0}
+        }
+        conv_id, resumed = main._ensure_conversation(conversations=conversations,
+                                                      **self.BASE_ARGS)
+        self.assertEqual(conv_id, "fallback-conv-id")
+        self.assertFalse(resumed)
+        mock_create.assert_called_once()
+        self.assertEqual(conversations["7"]["status"], "active")
+
+    @patch("main.create_conversation", return_value="brand-new-id")
+    def test_creates_new_when_status_unknown(self, mock_create):
+        # An entry with an unrecognised status should be treated as missing.
+        conversations = {
+            "7": {"conversation_id": "weird-id", "status": "unknown"}
+        }
+        conv_id, resumed = main._ensure_conversation(conversations=conversations,
+                                                      **self.BASE_ARGS)
+        self.assertEqual(conv_id, "brand-new-id")
+        self.assertFalse(resumed)
+
+    @patch("main.create_conversation", side_effect=RuntimeError("API down"))
+    def test_raises_when_create_fails(self, _mock_create):
+        conversations = {}
+        with self.assertRaises(RuntimeError):
+            main._ensure_conversation(conversations=conversations, **self.BASE_ARGS)
+
+
+# ── Acknowledgement message tests ─────────────────────────────────────────────
+
+class TestPostAcknowledgement(unittest.TestCase):
+
+    @patch("main._post_github_comment")
+    def test_new_conversation_message(self, mock_post):
+        main._post_acknowledgement(
+            github_token="tok", repo="o/r", issue_number=5,
+            item_type="issue", conv_url="http://app/conv/1", resumed=False,
+        )
+        body = mock_post.call_args[0][3]
+        self.assertIn("OpenHands is on it!", body)
+        self.assertNotIn("resuming", body.lower())
+
+    @patch("main._post_github_comment")
+    def test_resumed_conversation_message(self, mock_post):
+        main._post_acknowledgement(
+            github_token="tok", repo="o/r", issue_number=5,
+            item_type="pull request", conv_url="http://app/conv/2", resumed=True,
+        )
+        body = mock_post.call_args[0][3]
+        self.assertIn("resuming", body.lower())
+        self.assertNotIn("OpenHands is on it!", body)
+
+    @patch("main._post_github_comment")
+    def test_trigger_phrase_in_footer(self, mock_post):
+        original = main.TRIGGER_PHRASE
+        main.TRIGGER_PHRASE = "yeehaw!"
+        try:
+            main._post_acknowledgement(
+                github_token="tok", repo="o/r", issue_number=1,
+                item_type="issue", conv_url="http://x", resumed=False,
+            )
+            body = mock_post.call_args[0][3]
+            self.assertIn("yeehaw!", body)
+        finally:
+            main.TRIGGER_PHRASE = original
+
+
+# ── _get_agent_dict tests ──────────────────────────────────────────────────────
+
+class TestGetAgentDict(unittest.TestCase):
+    """Regression tests for agent-name resolution from /api/settings."""
+
+    def _mock_settings(self, agent_value, llm_value=None):
+        """Return a mock urlopen context manager that yields the given settings."""
+        payload = json.dumps({
+            "agent_settings": {"agent": agent_value, "llm": llm_value or {}}
+        }).encode()
+        mock_resp = MagicMock()
+        mock_resp.__enter__ = MagicMock(return_value=mock_resp)
+        mock_resp.__exit__ = MagicMock(return_value=False)
+        mock_resp.read = MagicMock(return_value=payload)
+        return mock_resp
+
+    @patch("urllib.request.urlopen")
+    def test_null_agent_falls_back_to_agent(self, mock_urlopen):
+        """agent=null in settings must fall back to 'Agent', not propagate as null."""
+        mock_urlopen.return_value = self._mock_settings(agent_value=None)
+        result = main._get_agent_dict("http://agent", "key")
+        self.assertEqual(result["kind"], "Agent")
+
+    @patch("urllib.request.urlopen")
+    def test_tools_always_included(self, mock_urlopen):
+        """terminal and file_editor must always be present so the agent has bash.
+
+        The runtime-registered names ('terminal', 'file_editor') must be used,
+        not the Python class names ('TerminalTool', 'FileEditorTool').
+        """
+        mock_urlopen.return_value = self._mock_settings(agent_value=None)
+        result = main._get_agent_dict("http://agent", "key")
+        tool_names = [t["name"] for t in result.get("tools", [])]
+        self.assertIn("terminal", tool_names)
+        self.assertIn("file_editor", tool_names)
+
+    @patch("urllib.request.urlopen")
+    def test_full_app_agent_name_not_forwarded(self, mock_urlopen):
+        """Full-app agent names (CodeActAgent, BrowsingAgent, …) must not be forwarded.
+
+        settings["agent_settings"]["agent"] belongs to the full OpenHands app
+        registry.  The automation SDK only accepts 'Agent' / 'ACPAgent'.
+        Forwarding 'CodeActAgent' causes a 500 with 'Unknown kind' in production.
+        """
+        for app_agent in ("CodeActAgent", "BrowsingAgent", "SomeFutureAgent"):
+            with self.subTest(app_agent=app_agent):
+                mock_urlopen.return_value = self._mock_settings(agent_value=app_agent)
+                result = main._get_agent_dict("http://agent", "key")
+                self.assertEqual(result["kind"], "Agent")
+
+    @patch("urllib.request.urlopen")
+    def test_missing_agent_key_falls_back_to_agent(self, mock_urlopen):
+        payload = json.dumps({"agent_settings": {"llm": {}}}).encode()
+        mock_resp = MagicMock()
+        mock_resp.__enter__ = MagicMock(return_value=mock_resp)
+        mock_resp.__exit__ = MagicMock(return_value=False)
+        mock_resp.read = MagicMock(return_value=payload)
+        mock_urlopen.return_value = mock_resp
+        result = main._get_agent_dict("http://agent", "key")
+        self.assertEqual(result["kind"], "Agent")
+
+
+if __name__ == "__main__":
+    unittest.main()

package/skills/gitlab/.plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "gitlab",
+  "version": "1.0.0",
+  "description": "Interact with GitLab repositories, merge requests, and APIs using the GITLAB_TOKEN environment variable. Use when working with code hosted on GitLab or managing GitLab resources.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "gitlab",
+    "git",
+    "merge-request"
+  ]
+}

package/skills/gitlab/README.md

@@ -0,0 +1,37 @@
+# Gitlab
+
+Interact with GitLab repositories, merge requests, and APIs using the GITLAB_TOKEN environment variable. Use when working with code hosted on GitLab or managing GitLab resources.
+
+## Triggers
+
+This skill is activated by the following keywords:
+
+- `gitlab`
+- `git`
+
+## Details
+
+You have access to an environment variable, `GITLAB_TOKEN`, which allows you to interact with
+the GitLab API.
+
+<IMPORTANT>
+You can use `curl` with the `GITLAB_TOKEN` to interact with GitLab's API.
+ALWAYS use the GitLab API for operations instead of a web browser.
+ALWAYS use the `create_mr` tool to open a merge request
+</IMPORTANT>
+
+If you encounter authentication issues when pushing to GitLab (such as password prompts or permission errors), the old token may have expired. In such case, update the remote URL to include the current token: `git remote set-url origin https://oauth2:${GITLAB_TOKEN}@gitlab.com/username/repo.git`
+
+Here are some instructions for pushing, but ONLY do this if the user asks you to:
+* NEVER push directly to the `main` or `master` branch
+* Git config (username and email) is pre-set. Do not modify.
+* You may already be on a branch starting with `openhands-workspace`. Create a new branch with a better name before pushing.
+* Use the `create_mr` tool to create a merge request, if you haven't already
+* Once you've created your own branch or a merge request, continue to update it. Do NOT create a new one unless you are explicitly asked to. Update the PR title and description as necessary, but don't change the branch name.
+* Use the main branch as the base branch, unless the user requests otherwise
+* After opening or updating a merge request, send the user a short message with a link to the merge request.
+* Do all of the above in as few steps as possible. E.g. you could push changes with one step by running the following bash commands:
+```bash
+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
+```

package/skills/gitlab/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: gitlab
+description: Interact with GitLab repositories, merge requests, and APIs using the GITLAB_TOKEN environment variable. Use when working with code hosted on GitLab or managing GitLab resources.
+triggers:
+- gitlab
+- git
+---
+
+You have access to an environment variable, `GITLAB_TOKEN`, which allows you to interact with
+the GitLab API.
+
+<IMPORTANT>
+You can use `curl` with the `GITLAB_TOKEN` to interact with GitLab's API.
+ALWAYS use the GitLab API for operations instead of a web browser.
+ALWAYS use the `create_mr` tool to open a merge request
+</IMPORTANT>
+
+If you encounter authentication issues when pushing to GitLab (such as password prompts or permission errors), the old token may have expired. In such case, update the remote URL to include the current token: `git remote set-url origin https://oauth2:${GITLAB_TOKEN}@gitlab.com/username/repo.git`
+
+Here are some instructions for pushing, but ONLY do this if the user asks you to:
+* NEVER push directly to the `main` or `master` branch
+* Git config (username and email) is pre-set. Do not modify.
+* You may already be on a branch starting with `openhands-workspace`. Create a new branch with a better name before pushing.
+* Use the `create_mr` tool to create a merge request, if you haven't already
+* Once you've created your own branch or a merge request, continue to update it. Do NOT create a new one unless you are explicitly asked to. Update the PR title and description as necessary, but don't change the branch name.
+* Use the main branch as the base branch, unless the user requests otherwise
+* After opening or updating a merge request, send the user a short message with a link to the merge request.
+* Do all of the above in as few steps as possible. E.g. you could push changes with one step by running the following bash commands:
+```bash
+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
+```

package/skills/incident-retrospective/.plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "incident-retrospective",
+  "version": "1.0.0",
+  "description": "Create an automation that drafts incident retrospectives by gathering incident-channel messages from Slack, collecting linked tickets from Linear, and publishing a retrospective draft to Notion with timeline, impact summary, root-cause hypotheses, and action items.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "incident",
+    "retrospective",
+    "postmortem",
+    "slack",
+    "linear",
+    "notion",
+    "automation"
+  ]
+}

package/skills/incident-retrospective/README.md

@@ -0,0 +1,34 @@
+# Incident Retrospective Drafter
+
+Create an automation that drafts incident retrospectives from Slack, Linear, and Notion.
+
+## Triggers
+
+This skill is activated by keywords:
+
+- `draft incident retrospective`
+- `incident postmortem`
+- `retro automation`
+
+## Features
+
+- **Gathers incident-channel messages from Slack**
+- **Collects linked tickets and follow-ups from Linear**
+- **Publishes retrospective draft to Notion**
+- **Customizable template**: timeline, impact, root cause, action items
+- **Supports manual, cron, or event-based triggers**
+
+## Prerequisites
+
+Slack MCP, Linear MCP, and Notion MCP installed in Settings → MCP
+
+## Quick Start
+
+Ask OpenHands:
+
+> "Set up an incident retro automation that pulls from #incidents in
+> Slack, checks Linear for follow-ups, and publishes to our Notion retro database"
+
+## See Also
+
+- [SKILL.md](SKILL.md) — Full setup workflow reference

package/skills/incident-retrospective/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: incident-retrospective
+description: >
+  Create an automation that drafts incident retrospectives. Gathers
+  incident-channel messages from Slack, collects linked tickets and follow-ups
+  from Linear, and publishes a retrospective draft to Notion with a timeline,
+  impact summary, root-cause hypotheses, and action items.
+triggers:
+  - /incident-retro:setup
+---
+
+# Incident Retrospective Drafter Automation
+
+Set up an automation that drafts incident retrospectives by pulling data from
+Slack, Linear, and Notion.
+
+---
+
+## Prerequisites
+
+### Required integrations
+
+All three MCP integrations must be installed in Settings → MCP:
+
+- **Slack MCP** — to gather incident-channel messages
+- **Linear MCP** — to collect linked tickets and follow-ups
+- **Notion MCP** — to publish the retrospective draft
+
+### Information to collect
+
+Ask the user for:
+
+1. **Incident identification** — how are incidents identified? (e.g. Slack channel naming convention like `#inc-*`, a Linear label, or manual trigger)
+2. **Slack channels** — which channels contain incident chatter (e.g. `#incidents`, `#inc-*` pattern)
+3. **Linear teams** — which Linear teams/projects to inspect for follow-up tickets
+4. **Retrospective template** — what sections should the retro include? Default: Timeline, Impact, Root Cause, Action Items, Lessons Learned
+5. **Notion destination** — which Notion database or page should receive the draft
+6. **Trigger type** — manual dispatch, cron schedule, or triggered by an incident label being added
+
+---
+
+## Setup Workflow
+
+### Step 1 — Verify MCP access
+
+Test each integration:
+```
+Use the Slack MCP to list recent messages in an incident channel.
+Use the Linear MCP to list recent issues for the target team.
+Use the Notion MCP to search for the destination database.
+```
+
+If any fail, tell the user which integration needs to be installed first.
+
+### Step 2 — Determine trigger type
+
+Ask the user how retros should be triggered:
+- **Manual** — dispatch from the automations page when an incident wraps up
+- **Cron** — run daily/weekly to check for recent incidents
+- **Event** — triggered by a Linear label change or Slack message
+
+### Step 3 — Build the retro prompt
+
+Construct a prompt that includes:
+- How to identify the incident (channel pattern, label, etc.)
+- Which Slack channels and Linear teams to query
+- The retrospective template/sections
+- Where to publish in Notion
+
+### Step 4 — Create the automation
+
+Read the Automation backend URL and auth from `<RUNTIME_SERVICES>`:
+- Use the **Automation backend** `url_from_agent` as `OPENHANDS_HOST`
+- Auth: `X-Session-API-Key: $OPENHANDS_AUTOMATION_API_KEY`
+
+Use the **prompt preset** endpoint:
+```bash
+curl -s -X POST "${OPENHANDS_HOST}/api/automation/v1/preset/prompt" \
+  -H "X-Session-API-Key: $OPENHANDS_AUTOMATION_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Incident Retrospective Drafter",
+    "prompt": "<constructed retro prompt>",
+    "trigger": <trigger config from step 2>
+  }'
+```
+
+### Step 5 — Confirm
+
+Tell the user:
+> ✅ **Incident Retrospective Drafter** is running!
+>
+> - Automation ID: `{id}`
+> - Incident source: `{identification method}`
+> - Slack channels: `{channels}`
+> - Linear teams: `{teams}`
+> - Notion destination: `{destination}`
+> - Trigger: `{trigger description}`

package/skills/incident-retrospective/commands/incident-retro:setup.md

@@ -0,0 +1,8 @@
+---
+# auto-generated by sync_extensions.py
+description: Create an automation that drafts incident retrospectives. Gathers incident-channel messages from Slack, collects linked tickets and follow-ups from Linear, and publishes a retrospective draft to Notion with a timeline, impact summary, root-cause hypotheses, and action items.
+---
+
+Read and follow the complete instructions in the SKILL.md file located in this skill's directory.
+
+$ARGUMENTS

package/skills/iterate/.plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "iterate",
+  "version": "1.0.0",
+  "description": "Iterate on a GitHub pull request — drive it through CI, code review, and QA until it is merge-ready.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": ["github", "ci", "review", "qa", "pull-request", "iterate"]
+}