From ef1d4396b12234cf801048dd27773e49577c07f5 Mon Sep 17 00:00:00 2001
From: Juan Antonio Osorio <ozz@stacklok.com>
Date: Mon, 20 Apr 2026 10:49:10 +0300
Subject: [PATCH] feat(skills): package 3 Neon skills
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Packages 3 skills from neondatabase/agent-skills (Apache-2.0).

- neon-postgres — Neon Serverless Postgres guide (connection methods,
  drivers, CLI, branching, autoscaling, scale-to-zero, replicas)
- claimable-postgres — instant temp Postgres databases (neon.new) with
  REST/CLI/SDK/Vite plugin paths
- neon-postgres-egress-optimizer — diagnose/fix high egress bills with
  pg_stat_statements and query refactors

Pinned to upstream 38c7da8. All pass scanner with only
MANIFEST_MISSING_LICENSE.

Refs #486
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 skills/claimable-postgres/spec.yaml           | 23 +++++++++++++++++++
 .../neon-postgres-egress-optimizer/spec.yaml  | 23 +++++++++++++++++++
 skills/neon-postgres/spec.yaml                | 23 +++++++++++++++++++
 3 files changed, 69 insertions(+)
 create mode 100644 skills/claimable-postgres/spec.yaml
 create mode 100644 skills/neon-postgres-egress-optimizer/spec.yaml
 create mode 100644 skills/neon-postgres/spec.yaml

diff --git a/skills/claimable-postgres/spec.yaml b/skills/claimable-postgres/spec.yaml
new file mode 100644
index 00000000..171dcae7
--- /dev/null
+++ b/skills/claimable-postgres/spec.yaml
@@ -0,0 +1,23 @@
+# Neon claimable-postgres Skill
+# Provision instant temporary Postgres databases via Claimable Postgres (neon.new).
+# Source: https://github.com/neondatabase/agent-skills
+# Will publish as: ghcr.io/stacklok/dockyard/skills/claimable-postgres:0.1.0
+
+metadata:
+  name: claimable-postgres
+  description: "Provision instant temporary Postgres databases via Claimable Postgres by Neon (neon.new) — no login/signup/credit card, REST API/CLI/SDK/Vite plugin; ideal for prototyping, tests, and quick DATABASE_URLs; 72-hour claim window"
+
+spec:
+  repository: "https://github.com/neondatabase/agent-skills"
+  ref: "38c7da85db656c8c9efd1e6433c200212926fd2d"  # main as of 2026-04-14
+  path: "skills/claimable-postgres"
+  version: "0.1.0"
+
+provenance:
+  repository_uri: "https://github.com/neondatabase/agent-skills"
+  repository_ref: "refs/heads/main"
+
+security:
+  allowed_issues:
+    - rule_id: MANIFEST_MISSING_LICENSE
+      reason: "neondatabase/agent-skills is licensed Apache-2.0 at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter."
diff --git a/skills/neon-postgres-egress-optimizer/spec.yaml b/skills/neon-postgres-egress-optimizer/spec.yaml
new file mode 100644
index 00000000..9f54e2af
--- /dev/null
+++ b/skills/neon-postgres-egress-optimizer/spec.yaml
@@ -0,0 +1,23 @@
+# Neon neon-postgres-egress-optimizer Skill
+# Diagnose and fix excessive Postgres egress (network data transfer).
+# Source: https://github.com/neondatabase/agent-skills
+# Will publish as: ghcr.io/stacklok/dockyard/skills/neon-postgres-egress-optimizer:0.1.0
+
+metadata:
+  name: neon-postgres-egress-optimizer
+  description: "Diagnose and fix excessive Postgres egress — identify top offenders with pg_stat_statements, spot SELECT *, missing pagination, high-frequency queries on static data, app-side aggregation, and JOIN duplication; fix patterns with concrete SQL refactors"
+
+spec:
+  repository: "https://github.com/neondatabase/agent-skills"
+  ref: "38c7da85db656c8c9efd1e6433c200212926fd2d"  # main as of 2026-04-14
+  path: "skills/neon-postgres-egress-optimizer"
+  version: "0.1.0"
+
+provenance:
+  repository_uri: "https://github.com/neondatabase/agent-skills"
+  repository_ref: "refs/heads/main"
+
+security:
+  allowed_issues:
+    - rule_id: MANIFEST_MISSING_LICENSE
+      reason: "neondatabase/agent-skills is licensed Apache-2.0 at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter."
diff --git a/skills/neon-postgres/spec.yaml b/skills/neon-postgres/spec.yaml
new file mode 100644
index 00000000..8b0fe714
--- /dev/null
+++ b/skills/neon-postgres/spec.yaml
@@ -0,0 +1,23 @@
+# Neon neon-postgres Skill
+# Guides and best practices for working with Neon Serverless Postgres.
+# Source: https://github.com/neondatabase/agent-skills
+# Will publish as: ghcr.io/stacklok/dockyard/skills/neon-postgres:0.1.0
+
+metadata:
+  name: neon-postgres
+  description: "Work with Neon Serverless Postgres — connection methods (serverless driver, PostgREST-style Data API), Neon CLI, MCP server setup, branching, autoscaling, scale-to-zero, instant restore, read replicas, connection pooling, logical replication; Platform API/SDKs in TypeScript and Python"
+
+spec:
+  repository: "https://github.com/neondatabase/agent-skills"
+  ref: "38c7da85db656c8c9efd1e6433c200212926fd2d"  # main as of 2026-04-14
+  path: "skills/neon-postgres"
+  version: "0.1.0"
+
+provenance:
+  repository_uri: "https://github.com/neondatabase/agent-skills"
+  repository_ref: "refs/heads/main"
+
+security:
+  allowed_issues:
+    - rule_id: MANIFEST_MISSING_LICENSE
+      reason: "neondatabase/agent-skills is licensed Apache-2.0 at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter."