@openhands/extensions 0.16.0 → 0.18.0

package/integrations/catalog-index.js

@@ -14,69 +14,70 @@ import entry8 from "./catalog/elevenlabs.json" with { type: "json" };
 import entry9 from "./catalog/bitbucket.json" with { type: "json" };
 import entry10 from "./catalog/xero.json" with { type: "json" };
 import entry11 from "./catalog/quickbooks.json" with { type: "json" };
-import entry12 from "./catalog/okta.json" with { type: "json" };
-import entry13 from "./catalog/netlify.json" with { type: "json" };
-import entry14 from "./catalog/vercel.json" with { type: "json" };
-import entry15 from "./catalog/supabase.json" with { type: "json" };
-import entry16 from "./catalog/posthog.json" with { type: "json" };
-import entry17 from "./catalog/sentry.json" with { type: "json" };
-import entry18 from "./catalog/datadog.json" with { type: "json" };
-import entry19 from "./catalog/canva.json" with { type: "json" };
-import entry20 from "./catalog/miro.json" with { type: "json" };
-import entry21 from "./catalog/webflow.json" with { type: "json" };
-import entry22 from "./catalog/zoom.json" with { type: "json" };
-import entry23 from "./catalog/discord.json" with { type: "json" };
-import entry24 from "./catalog/stripe.json" with { type: "json" };
-import entry25 from "./catalog/intercom.json" with { type: "json" };
-import entry26 from "./catalog/hubspot.json" with { type: "json" };
-import entry27 from "./catalog/salesforce.json" with { type: "json" };
-import entry28 from "./catalog/sharepoint.json" with { type: "json" };
-import entry29 from "./catalog/onedrive.json" with { type: "json" };
-import entry30 from "./catalog/microsoft-teams.json" with { type: "json" };
-import entry31 from "./catalog/microsoft-outlook.json" with { type: "json" };
-import entry32 from "./catalog/box.json" with { type: "json" };
-import entry33 from "./catalog/airtable.json" with { type: "json" };
-import entry34 from "./catalog/monday.json" with { type: "json" };
-import entry35 from "./catalog/trello.json" with { type: "json" };
-import entry36 from "./catalog/asana.json" with { type: "json" };
-import entry37 from "./catalog/confluence.json" with { type: "json" };
-import entry38 from "./catalog/jira.json" with { type: "json" };
-import entry39 from "./catalog/google-calendar.json" with { type: "json" };
-import entry40 from "./catalog/gmail.json" with { type: "json" };
-import entry41 from "./catalog/google-sheets.json" with { type: "json" };
-import entry42 from "./catalog/google-drive.json" with { type: "json" };
-import entry43 from "./catalog/figma.json" with { type: "json" };
-import entry44 from "./catalog/google-docs.json" with { type: "json" };
-import entry45 from "./catalog/apify.json" with { type: "json" };
-import entry46 from "./catalog/atlassian-rovo.json" with { type: "json" };
-import entry47 from "./catalog/brave-search.json" with { type: "json" };
-import entry48 from "./catalog/browser-mcp.json" with { type: "json" };
-import entry49 from "./catalog/clickhouse.json" with { type: "json" };
-import entry50 from "./catalog/cloudflare-bindings.json" with { type: "json" };
-import entry51 from "./catalog/cloudflare-browser-rendering.json" with { type: "json" };
-import entry52 from "./catalog/cloudflare-builds.json" with { type: "json" };
-import entry53 from "./catalog/cloudflare-docs.json" with { type: "json" };
-import entry54 from "./catalog/cloudflare-observability.json" with { type: "json" };
-import entry55 from "./catalog/deepwiki.json" with { type: "json" };
-import entry56 from "./catalog/everything.json" with { type: "json" };
-import entry57 from "./catalog/exa.json" with { type: "json" };
-import entry58 from "./catalog/fetch.json" with { type: "json" };
-import entry59 from "./catalog/filesystem.json" with { type: "json" };
-import entry60 from "./catalog/firecrawl.json" with { type: "json" };
-import entry61 from "./catalog/git.json" with { type: "json" };
-import entry62 from "./catalog/huggingface.json" with { type: "json" };
-import entry63 from "./catalog/kagi.json" with { type: "json" };
-import entry64 from "./catalog/memory.json" with { type: "json" };
-import entry65 from "./catalog/mongodb.json" with { type: "json" };
-import entry66 from "./catalog/neon.json" with { type: "json" };
-import entry67 from "./catalog/obsidian.json" with { type: "json" };
-import entry68 from "./catalog/paypal.json" with { type: "json" };
-import entry69 from "./catalog/playwright.json" with { type: "json" };
-import entry70 from "./catalog/redis.json" with { type: "json" };
-import entry71 from "./catalog/resend.json" with { type: "json" };
-import entry72 from "./catalog/sequential-thinking.json" with { type: "json" };
-import entry73 from "./catalog/superhuman-mail.json" with { type: "json" };
-import entry74 from "./catalog/time.json" with { type: "json" };
+import entry12 from "./catalog/sonarqube.json" with { type: "json" };
+import entry13 from "./catalog/okta.json" with { type: "json" };
+import entry14 from "./catalog/netlify.json" with { type: "json" };
+import entry15 from "./catalog/vercel.json" with { type: "json" };
+import entry16 from "./catalog/supabase.json" with { type: "json" };
+import entry17 from "./catalog/posthog.json" with { type: "json" };
+import entry18 from "./catalog/sentry.json" with { type: "json" };
+import entry19 from "./catalog/datadog.json" with { type: "json" };
+import entry20 from "./catalog/canva.json" with { type: "json" };
+import entry21 from "./catalog/miro.json" with { type: "json" };
+import entry22 from "./catalog/webflow.json" with { type: "json" };
+import entry23 from "./catalog/zoom.json" with { type: "json" };
+import entry24 from "./catalog/discord.json" with { type: "json" };
+import entry25 from "./catalog/stripe.json" with { type: "json" };
+import entry26 from "./catalog/intercom.json" with { type: "json" };
+import entry27 from "./catalog/hubspot.json" with { type: "json" };
+import entry28 from "./catalog/salesforce.json" with { type: "json" };
+import entry29 from "./catalog/sharepoint.json" with { type: "json" };
+import entry30 from "./catalog/onedrive.json" with { type: "json" };
+import entry31 from "./catalog/microsoft-teams.json" with { type: "json" };
+import entry32 from "./catalog/microsoft-outlook.json" with { type: "json" };
+import entry33 from "./catalog/box.json" with { type: "json" };
+import entry34 from "./catalog/airtable.json" with { type: "json" };
+import entry35 from "./catalog/monday.json" with { type: "json" };
+import entry36 from "./catalog/trello.json" with { type: "json" };
+import entry37 from "./catalog/asana.json" with { type: "json" };
+import entry38 from "./catalog/confluence.json" with { type: "json" };
+import entry39 from "./catalog/jira.json" with { type: "json" };
+import entry40 from "./catalog/google-calendar.json" with { type: "json" };
+import entry41 from "./catalog/gmail.json" with { type: "json" };
+import entry42 from "./catalog/google-sheets.json" with { type: "json" };
+import entry43 from "./catalog/google-drive.json" with { type: "json" };
+import entry44 from "./catalog/figma.json" with { type: "json" };
+import entry45 from "./catalog/google-docs.json" with { type: "json" };
+import entry46 from "./catalog/apify.json" with { type: "json" };
+import entry47 from "./catalog/atlassian-rovo.json" with { type: "json" };
+import entry48 from "./catalog/brave-search.json" with { type: "json" };
+import entry49 from "./catalog/browser-mcp.json" with { type: "json" };
+import entry50 from "./catalog/clickhouse.json" with { type: "json" };
+import entry51 from "./catalog/cloudflare-bindings.json" with { type: "json" };
+import entry52 from "./catalog/cloudflare-browser-rendering.json" with { type: "json" };
+import entry53 from "./catalog/cloudflare-builds.json" with { type: "json" };
+import entry54 from "./catalog/cloudflare-docs.json" with { type: "json" };
+import entry55 from "./catalog/cloudflare-observability.json" with { type: "json" };
+import entry56 from "./catalog/deepwiki.json" with { type: "json" };
+import entry57 from "./catalog/everything.json" with { type: "json" };
+import entry58 from "./catalog/exa.json" with { type: "json" };
+import entry59 from "./catalog/fetch.json" with { type: "json" };
+import entry60 from "./catalog/filesystem.json" with { type: "json" };
+import entry61 from "./catalog/firecrawl.json" with { type: "json" };
+import entry62 from "./catalog/git.json" with { type: "json" };
+import entry63 from "./catalog/huggingface.json" with { type: "json" };
+import entry64 from "./catalog/kagi.json" with { type: "json" };
+import entry65 from "./catalog/memory.json" with { type: "json" };
+import entry66 from "./catalog/mongodb.json" with { type: "json" };
+import entry67 from "./catalog/neon.json" with { type: "json" };
+import entry68 from "./catalog/obsidian.json" with { type: "json" };
+import entry69 from "./catalog/paypal.json" with { type: "json" };
+import entry70 from "./catalog/playwright.json" with { type: "json" };
+import entry71 from "./catalog/redis.json" with { type: "json" };
+import entry72 from "./catalog/resend.json" with { type: "json" };
+import entry73 from "./catalog/sequential-thinking.json" with { type: "json" };
+import entry74 from "./catalog/superhuman-mail.json" with { type: "json" };
+import entry75 from "./catalog/time.json" with { type: "json" };
 
 export const INTEGRATION_CATALOG_ENTRIES = [
   entry0,
@@ -154,4 +155,5 @@ export const INTEGRATION_CATALOG_ENTRIES = [
   entry72,
   entry73,
   entry74,
+  entry75,
 ];

package/marketplaces/openhands-extensions.json

@@ -29,6 +29,7 @@
       "source": "./skills/add-skill",
       "description": "Add (import) an OpenHands skill from a GitHub repository into the current workspace.",
       "category": "agent-authoring",
+      "defaultEnabled": true,
       "keywords": [
         "skill",
         "import",
@@ -41,6 +42,7 @@
       "source": "./skills/agent-memory",
       "description": "Persist and retrieve repository-specific knowledge using AGENTS.md files. Use when you want to save important information about a codebase (build commands, code style, workflows) for future sessions.",
       "category": "agent-authoring",
+      "defaultEnabled": true,
       "keywords": [
         "memory",
         "knowledge",
@@ -53,6 +55,7 @@
       "source": "./skills/agent-sdk-builder",
       "description": "Guided workflow for building custom AI agents using the OpenHands Software Agent SDK. Use when you want to create a new agent through an interactive interview process that gathers requirements and generates implementation plans.",
       "category": "agent-authoring",
+      "defaultEnabled": true,
       "keywords": [
         "agent",
         "sdk",
@@ -80,6 +83,7 @@
       "source": "./skills/openhands-automation",
       "description": "Create and manage OpenHands automations - scheduled tasks that run in sandboxes. Use the prompt preset to create automations from natural language, or manage existing automations.",
       "category": "automations",
+      "defaultEnabled": true,
       "keywords": [
         "automation",
         "cron",
@@ -93,6 +97,7 @@
       "source": "./skills/agent-canvas-environment",
       "description": "Work effectively inside a local Agent Canvas environment, including local agent-server auth, safe workspace hygiene, and local conversation delegation.",
       "category": "agent-authoring",
+      "defaultEnabled": true,
       "keywords": [
         "agent-canvas",
         "openhands",
@@ -106,6 +111,7 @@
       "source": "./skills/openhands-sdk",
       "description": "Reference skill for the OpenHands Software Agent SDK - build AI agents with custom tools, LLM configuration, conversations, sub-agent delegation, MCP integration, security, and persistence.",
       "category": "agent-authoring",
+      "defaultEnabled": true,
       "keywords": [
         "sdk",
         "agent",
@@ -182,6 +188,7 @@
       "source": "./skills/code-review",
       "description": "Rigorous code review focusing on data structures, simplicity, security, pragmatism, and risk/safety evaluation. Provides brutally honest, actionable feedback on pull requests or merge requests, including a risk assessment for every review. Use when reviewing code changes.",
       "category": "code-quality",
+      "defaultEnabled": true,
       "keywords": [
         "code-review",
         "quality",
@@ -232,6 +239,7 @@
       "source": "./skills/docker",
       "description": "Run Docker commands within a container environment, including starting the Docker daemon and managing containers. Use when building, running, or managing Docker containers and images.",
       "category": "environment",
+      "defaultEnabled": true,
       "keywords": [
         "docker",
         "container",
@@ -268,6 +276,7 @@
       "source": "./skills/github",
       "description": "Interact with GitHub repositories, pull requests, issues, and workflows using the GITHUB_TOKEN environment variable and GitHub CLI. Use when working with code hosted on GitHub or managing GitHub resources.",
       "category": "code-hosting",
+      "defaultEnabled": true,
       "keywords": [
         "github",
         "git",
@@ -444,6 +453,7 @@
       "source": "./skills/openhands-api",
       "description": "Use the OpenHands Cloud REST API (V1) and agent-server APIs to create and manage Cloud or local backend conversations, including multi-conversation delegation workflows. Includes minimal Python and TypeScript clients under scripts/.",
       "category": "agent-authoring",
+      "defaultEnabled": true,
       "keywords": [
         "openhands",
         "api",
@@ -534,6 +544,7 @@
       "source": "./skills/skill-creator",
       "description": "Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.",
       "category": "agent-authoring",
+      "defaultEnabled": true,
       "keywords": [
         "skill",
         "plugin",
@@ -670,6 +681,32 @@
         "official"
       ]
     },
+    {
+      "name": "github-agents-md-maintainer",
+      "source": "./skills/github-agents-md-maintainer",
+      "description": "Create an automation that keeps AGENTS.md current in one or more GitHub repositories. On a schedule an agent reads the repository, creates or updates AGENTS.md, and opens a pull request - staying quiet while one of its own pull requests is still open.",
+      "category": "automations",
+      "keywords": [
+        "github",
+        "agents-md",
+        "documentation",
+        "maintenance",
+        "automation"
+      ]
+    },
+    {
+      "name": "github-issue-to-pr",
+      "source": "./skills/github-issue-to-pr",
+      "description": "Create an automation that implements GitHub issues when a configurable trigger label is applied. Clones the default branch for the agent, then commits, pushes, and opens the pull request itself - the agent is handed no GitHub credential.",
+      "category": "automations",
+      "keywords": [
+        "github",
+        "issue",
+        "pull-request",
+        "automation",
+        "integration"
+      ]
+    },
     {
       "name": "github-pr-reviewer",
       "source": "./skills/github-pr-reviewer",
@@ -770,6 +807,18 @@
         "jira",
         "atlassian"
       ]
+    },
+    {
+      "name": "news-digest",
+      "source": "./skills/news-digest",
+      "description": "Create an automation that reads public RSS and Atom feeds on a schedule, keeps what is new and matches the configured topics, and has an agent write a short digest of it. Needs no credentials.",
+      "category": "automations",
+      "keywords": [
+        "news",
+        "rss",
+        "atom",
+        "digest"
+      ]
     }
   ]
 }

package/package.json

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

package/plugins/qa-changes/action.yml

@@ -160,7 +160,7 @@ runs:
         # so we enforce the time limit via the coreutils timeout command.
         TIMEOUT_SECONDS=$((TIMEOUT_MINUTES * 60))
         timeout "${TIMEOUT_SECONDS}" \
-          uv run --no-project --with openhands-sdk --with openhands-tools --with 'lmnr<0.7.53' \
+          uv run --no-project --with openhands-sdk --with openhands-tools --with lmnr \
             python ../extensions/plugins/qa-changes/scripts/agent_script.py
 
     - name: Upload logs as artifact

package/pyproject.toml

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

package/python/openhands_extensions/_version.py

@@ -18,7 +18,7 @@ from importlib.metadata import PackageNotFoundError, version
 #: Kept in lock-step with pyproject.toml/package.json by the version test.
 #: release-please only rewrites a semver found on the annotated line itself, so
 #: the annotation must stay on the assignment; on its own line it is a no-op.
-_FALLBACK_VERSION = "0.16.0"  # x-release-please-version
+_FALLBACK_VERSION = "0.18.0"  # x-release-please-version
 
 try:
     __version__: str = version("openhands-extensions")

package/scripts/build-automation-catalog.mjs

@@ -4,6 +4,7 @@ import path from "node:path";
 const root = process.cwd();
 const catalogDir = path.join(root, "automations", "catalog");
 const outputPath = path.join(root, "automations", "catalog-index.js");
+const bundleOutputPath = path.join(root, "automations", "bundle-index.js");
 
 const directories = (await readdir(catalogDir, { withFileTypes: true }))
   .filter((entry) => entry.isDirectory())
@@ -37,6 +38,25 @@ const imports = indexedAutomations
   .join("\n");
 const entries = indexedAutomations.map(({ importName }) => `  ${importName},`).join("\n");
 
+// A bundle entry names its files by repository-relative path, so the one copy
+// of a script shipped by both a skill and the catalog stays in one place. The
+// package cannot ship a path, though - a browser host has no repository - so
+// the contents are inlined here at build time.
+const bundles = {};
+for (const { entry } of automations) {
+  const files = entry.setup?.bundle?.files;
+  if (!files) continue;
+  bundles[entry.id] = {};
+  for (const [packedPath, source] of Object.entries(files).sort()) {
+    if (!/^(skills|automations)\//.test(source) || source.includes("..")) {
+      throw new Error(
+        `${entry.id}: bundle file "${packedPath}" names ${source}, which is outside skills/ or automations/`,
+      );
+    }
+    bundles[entry.id][packedPath] = await readFile(path.join(root, source), "utf8");
+  }
+}
+
 const header = `// This file is auto-generated by scripts/build-automation-catalog.mjs.
 // Do not edit it manually. To update it after changing automations/catalog/*/manifest.json,
 // run: npm run build:automations
@@ -49,3 +69,13 @@ ${entries}
 ];
 `;
 await writeFile(outputPath, body);
+
+const bundleHeader = `// This file is auto-generated by scripts/build-automation-catalog.mjs.
+// Do not edit it manually. It inlines the files each bundle entry ships, read from
+// the repository paths its manifest names. To update it, run: npm run build:automations
+
+`;
+await writeFile(
+  bundleOutputPath,
+  `${bundleHeader}export const AUTOMATION_BUNDLE_FILES = ${JSON.stringify(bundles, null, 2)};\n`,
+);

package/scripts/build-skills-catalog.mjs

@@ -36,8 +36,8 @@ export const SKILL_CATEGORY_IDS = [
 
 const FALLBACK_CATEGORY = "other";
 
-/** Build a `skill directory name -> {category, file}` map from every manifest. */
-export function buildCategoryMap(marketplacesDir) {
+/** Build a `skill directory name -> {category, defaultEnabled, file}` map from every manifest. */
+export function buildEntryMap(marketplacesDir) {
   const map = new Map();
 
   for (const filename of readdirSync(marketplacesDir).filter((f) => f.endsWith(".json")).sort()) {
@@ -56,14 +56,27 @@ export function buildCategoryMap(marketplacesDir) {
         );
       }
 
+      if ("defaultEnabled" in entry && typeof entry.defaultEnabled !== "boolean") {
+        throw new Error(
+          `${filename}: skill "${name}" has defaultEnabled ${JSON.stringify(entry.defaultEnabled)}, expected a boolean`,
+        );
+      }
+
+      const defaultEnabled = entry.defaultEnabled === true;
+
       const existing = map.get(name);
       if (existing && existing.category !== category) {
         throw new Error(
           `Conflicting categories for skill "${name}": ${existing.file} says "${existing.category}", ${filename} says "${category}"`,
         );
       }
+      if (existing && existing.defaultEnabled !== defaultEnabled) {
+        throw new Error(
+          `Conflicting defaultEnabled for skill "${name}": ${existing.file} says ${existing.defaultEnabled}, ${filename} says ${defaultEnabled}`,
+        );
+      }
 
-      map.set(name, { category, file: filename });
+      map.set(name, { category, defaultEnabled, file: filename });
     }
   }
 
@@ -114,7 +127,7 @@ export function parseFrontmatter(raw) {
  */
 export function buildCatalog(skillsDir, marketplacesDir = MARKETPLACES_DIR) {
   const entries = [];
-  const categories = buildCategoryMap(marketplacesDir);
+  const manifestEntries = buildEntryMap(marketplacesDir);
   const uncategorized = [];
 
   for (const dir of readdirSync(skillsDir).sort()) {
@@ -133,7 +146,7 @@ export function buildCatalog(skillsDir, marketplacesDir = MARKETPLACES_DIR) {
     const fm = parseFrontmatter(parts[1]);
     const body = parts.slice(2).join("---").trim();
 
-    const mapped = categories.get(dir);
+    const mapped = manifestEntries.get(dir);
     if (!mapped) uncategorized.push(dir);
 
     entries.push({
@@ -142,6 +155,8 @@ export function buildCatalog(skillsDir, marketplacesDir = MARKETPLACES_DIR) {
       triggers: fm.triggers,
       content: body,
       category: mapped?.category ?? FALLBACK_CATEGORY,
+      // Only when true, so off-by-default has one shape.
+      ...(mapped?.defaultEnabled ? { defaultEnabled: true } : {}),
       ...(fm.license ? { license: fm.license } : {}),
       ...(fm.compatibility ? { compatibility: fm.compatibility } : {}),
     });
@@ -160,14 +175,16 @@ export function buildCatalog(skillsDir, marketplacesDir = MARKETPLACES_DIR) {
 const isMain = process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1];
 if (isMain) {
   const entries = buildCatalog(SKILLS_DIR);
+  const defaultEnabledNames = entries.filter((e) => e.defaultEnabled).map((e) => e.name);
 
   const source = `// Auto-generated by scripts/build-skills-catalog.mjs — do not edit.
-// Source of truth: skills/*/SKILL.md and marketplaces/*.json (category)
+// Source of truth: skills/*/SKILL.md and marketplaces/*.json (category, defaultEnabled)
 export const SKILL_CATEGORY_IDS = ${JSON.stringify(SKILL_CATEGORY_IDS)};
 export const SKILLS_CATALOG = ${JSON.stringify(entries, null, 2)};
+export const DEFAULT_ENABLED_SKILL_NAMES = ${JSON.stringify(defaultEnabledNames)};
 export default SKILLS_CATALOG;
 `;
 
   writeFileSync(OUTPUT, source);
-  console.log(`Generated ${OUTPUT} with ${entries.length} skills`);
+  console.log(`Generated ${OUTPUT} with ${entries.length} skills (${defaultEnabledNames.length} default-enabled)`);
 }

package/skills/add-skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-skill
-description: Add an external skill from a GitHub repository to the current workspace. Use when users want to import, install, or add a skill from a GitHub URL (e.g., `/add-skill https://github.com/OpenHands/extensions/tree/main/skills/codereview` or "add the codereview skill from https://github.com/OpenHands/extensions/"). Handles fetching the skill files and placing them in .agents/skills/.
+description: Import an existing skill from a GitHub repository URL into the current workspace. Use only when the user provides or references a GitHub URL/repo to fetch from (e.g., `/add-skill https://github.com/OpenHands/extensions/tree/main/skills/codereview` or "add the codereview skill from https://github.com/OpenHands/extensions/"). Handles fetching the skill files and placing them in .agents/skills/. This does not author new skills — to create a new skill from scratch (no source URL), use the skill-creator skill instead.
 ---
 
 # Add Skill

package/skills/github-agents-md-maintainer/.plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "github-agents-md-maintainer",
+  "version": "1.0.0",
+  "description": "Create an automation that keeps AGENTS.md current in one or more GitHub repositories. On a schedule it clones the default branch, has an agent read the repository and create or update AGENTS.md, and opens a pull request - staying quiet while one of its own pull requests is still open.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "github",
+    "agents-md",
+    "documentation",
+    "maintenance",
+    "automation"
+  ]
+}

package/skills/github-agents-md-maintainer/README.md

@@ -0,0 +1,59 @@
+# AGENTS.md Maintainer
+
+Create an automation that keeps `AGENTS.md` current in one or more GitHub
+repositories, on a schedule.
+
+## Trigger
+
+This skill is activated by:
+
+- `/agents-md:setup`
+
+## Features
+
+- Creates `AGENTS.md` when it is missing, updates it when the repository has
+  moved on, and leaves it alone when it is accurate
+- Runs weekly by default, keyed by ISO week, so extra runs inside a week are
+  harmless
+- Stays quiet while one of its own pull requests is still open, instead of
+  stacking a pull request per week over the same file
+- Maintains several repositories from one automation, each with its own state
+- Clones the default branch for the agent and removes the clone when the run ends
+- Lets the agent open the pull request, and opens it in Python when the agent
+  did not - a failed push or a dead conversation never loses the work
+- Opens draft pull requests by default, titled `docs: update AGENTS.md` or
+  `docs: add AGENTS.md`
+
+## What the agent is asked to do
+
+Read the repository - layout, the build, test, lint and format commands as they
+are actually defined, language and framework versions, contributing docs - and
+edit `AGENTS.md` to match. It is told to treat an existing file as someone
+else's writing: correct what is wrong, add what is missing, remove what no
+longer exists, and leave the rest alone. Only knowledge that helps in most
+future tasks belongs there, which is the rule the `agent-memory` skill sets out;
+task-specific notes and unverified commands do not.
+
+## Prerequisites
+
+Set `GITHUB_PERSONAL_ACCESS_TOKEN` in OpenHands Settings -> Secrets, able to
+read the repositories, **write contents** (to push the branch) and **write pull
+requests**. No issue permission is needed - this automation never comments on an
+issue.
+
+The automation runtime must have `git` available.
+
+## Quick Start
+
+Ask OpenHands:
+
+> "Set up an AGENTS.md maintenance automation for `myorg/backend` and
+> `myorg/frontend`, weekly."
+
+## See Also
+
+- [SKILL.md](SKILL.md) - Full setup workflow reference
+- [references/state-schema.md](references/state-schema.md) - State document and
+  task lifecycle
+- [../agent-memory/SKILL.md](../agent-memory/SKILL.md) - What belongs in an
+  AGENTS.md, and what does not