@1aboveio/skills 1.0.1 → 1.0.2

package/skills/app-dev/data-quality/scripts/test_data_quality.py

@@ -0,0 +1,277 @@
+"""Tests for data_quality.py against a real repo and a real SQLite warehouse. Run: python3 test_data_quality.py"""
+from __future__ import annotations
+
+import contextlib
+import io
+import json
+import shutil
+import sqlite3
+import sys
+import tempfile
+import textwrap
+import unittest
+from pathlib import Path
+
+HERE = Path(__file__).resolve().parent
+CATALOG_ENGINE = HERE.parent.parent / "data-catalog" / "scripts" / "data_catalog.py"
+sys.path.insert(0, str(HERE))
+import data_quality as dq  # noqa: E402
+
+SCRIPT = '''
+from catalog_fields import Field, Table
+
+CATALOG_TABLE = Table(
+    "customer_daily",
+    en="Daily customer metrics.",
+    grain_en="One row per (dt, cust_id).",
+)
+CATALOG_FIELDS = (
+    Field("dt", en="Snapshot date.", source="run parameter dt"),
+    Field("cust_id", en="Customer id.", source="dwd.transaction.cust_id"),
+    Field("coll_cnt_7d", en="Number of collections in the last 7 days.", source="count of rows", unit="count"),
+    Field("recall_ratio", en="Recalled share of collected amount, 0-1.", source="recall / collected", unit="ratio"),
+    Field("agent_risk", en="Agent risk: yes, no or undetermined.", source="agent list and recalls",
+          values=("是", "否", "无法判定")),
+    Field("result", en="Transaction result.", source="constant in v1", values=("SUCCESS", "FAILED")),
+    Field("cert_type", en="Payer certificate type.", source="dwd.transaction.debtor_cert_type"),
+    Field("legacy_flag", en="Legacy flag; always empty since v2.", source="none"),
+    Field("channel", en="Collection channel.", source="dwd.transaction.channel", values=("bank", "card")),
+)
+PUBLISHED_COLUMNS = tuple(f.name for f in CATALOG_FIELDS)
+'''
+
+ROWS = [
+    # dt, cust_id, coll_cnt_7d, recall_ratio, agent_risk, result, cert_type, legacy_flag, channel
+    ("2026-10-01", "c1", 3, 0.1, "是", "SUCCESS", None, None, "bank"),
+    ("2026-10-01", "c2", 0, 1.4, "无法判定", "SUCCESS", None, None, "card"),
+    ("2026-10-02", "c1", -1, 0.0, "无法判定", "SUCCESS", None, None, "wallet"),
+    ("2026-10-02", "c3", 5, None, "是", "SUCCESS", None, None, "bank"),
+]
+
+
+def make_repo(rows=ROWS, script=SCRIPT, extra_column=None) -> tuple[Path, Path]:
+    root = Path(tempfile.mkdtemp(prefix="data-quality-test-"))
+    (root / ".git").mkdir()
+    (root / "scripts/data-catalog").mkdir(parents=True)
+    shutil.copy(CATALOG_ENGINE, root / "scripts/data-catalog/data_catalog.py")
+    (root / "jobs").mkdir()
+    (root / "jobs/customer_daily.py").write_text(textwrap.dedent(script), encoding="utf-8")
+    (root / "data-catalog.json").write_text(json.dumps({"version": 1, "scripts": ["jobs/*.py"], "languages": ["en"]}),
+                                           encoding="utf-8")
+    db = root / "warehouse.db"
+    con = sqlite3.connect(db)
+    columns = ["dt TEXT", "cust_id TEXT", "coll_cnt_7d INTEGER", "recall_ratio REAL", "agent_risk TEXT", "result TEXT",
+               "cert_type TEXT", "legacy_flag TEXT", "channel TEXT"]
+    if extra_column:
+        columns.insert(6, extra_column)
+    con.execute(f"CREATE TABLE customer_daily ({', '.join(columns)})")
+    con.executemany(f"INSERT INTO customer_daily VALUES ({', '.join('?' * len(columns))})", rows)
+    con.commit()
+    con.close()
+    return root, db
+
+
+def run(root: Path, *argv: str) -> tuple[int, str, str]:
+    out, err = io.StringIO(), io.StringIO()
+    with contextlib.redirect_stdout(out), contextlib.redirect_stderr(err):
+        code = dq.main(["--root", str(root), *argv])
+    return code, out.getvalue(), err.getvalue()
+
+
+def findings(root: Path, db: Path, *extra: str) -> tuple[int, dict]:
+    code, out, err = run(root, "run", "--sqlite", str(db), "--json", "--constant-min-rows", "2", *extra)
+    assert out, err
+    report = json.loads(out)
+    return code, {(f["column"], f["kind"]): f for f in report["findings"]}
+
+
+class RunTest(unittest.TestCase):
+    def test_each_check_fires_on_the_column_that_breaks_it(self):
+        root, db = make_repo()
+        code, found = findings(root, db)
+        self.assertEqual(code, 1)
+        self.assertEqual(found[("coll_cnt_7d", "negative-value")]["message"], "minimum -1, but the unit is count")
+        self.assertEqual(found[("recall_ratio", "out-of-range")]["message"],
+                         "values from 0 to 1.4, outside 0–1 for unit ratio")
+        self.assertEqual(found[("agent_risk", "unseen-value")]["message"], "declared but never present: 否")
+        self.assertEqual(found[("channel", "undeclared-value")]["message"], "present but not declared: wallet (1)")
+        self.assertEqual(found[("result", "constant")]["message"], "one value in all 4 filled rows")
+        self.assertEqual(found[("result", "unseen-value")]["message"], "declared but never present: FAILED")
+        self.assertEqual(found[("cert_type", "never-filled")]["message"], "empty in all 4 rows")
+        self.assertFalse(found[("cert_type", "never-filled")]["documented"])
+        # the definition already says "always empty": reported, but as documented
+        self.assertTrue(found[("legacy_flag", "never-filled")]["documented"])
+        # clean columns raise nothing
+        self.assertFalse([k for k in found if k[0] in ("dt", "cust_id")])
+
+    def test_a_missing_flag_constant_at_zero_is_healthy_but_at_one_is_not(self):
+        script = SCRIPT.replace('Field("cert_type"', 'Field("fx_missing", en="1 if any amount lacked a rate.", source="flag"),\n    Field("cert_type"')
+        for value, healthy in ((0, True), (1, False)):
+            rows = [r[:6] + (value,) + r[6:] for r in ROWS]
+            root, db = make_repo(rows, script, extra_column="fx_missing INTEGER")
+            _, found = findings(root, db)
+            self.assertEqual(found[("fx_missing", "constant")]["documented"], healthy, value)
+
+    def test_version_and_hash_columns_are_expected_to_be_constant(self):
+        script = SCRIPT.replace('Field("cert_type"', 'Field("rule_version", en="Rule set version.", source="RULE_VERSION"),\n    Field("cert_type"')
+        rows = [r[:6] + ("v2",) + r[6:] for r in ROWS]
+        root = Path(tempfile.mkdtemp(prefix="data-quality-test-"))
+        root, db = make_repo(rows, script, extra_column="rule_version TEXT")
+        _, found = findings(root, db)
+        self.assertTrue(found[("rule_version", "constant")]["documented"])
+
+    def test_duplicate_grain_keys_are_counted(self):
+        rows = ROWS + [ROWS[0]]  # (2026-10-01, c1) twice
+        root, db = make_repo(rows)
+        _, found = findings(root, db, "--key", "dt", "--key", "cust_id")
+        self.assertEqual(found[(None, "duplicate-key")]["message"],
+                         "1 (dt, cust_id) value(s) repeat across 2 rows; the grain allows one each")
+        root, db = make_repo()
+        _, clean = findings(root, db, "--key", "dt", "--key", "cust_id")
+        self.assertNotIn((None, "duplicate-key"), clean)
+        code, _, err = run(root, "plan", "--key", "nope")
+        self.assertEqual(code, 2)
+        self.assertIn("--key column(s) not documented in customer_daily: nope", err)
+
+    def test_where_bounds_the_scan(self):
+        root, db = make_repo()
+        _, found = findings(root, db, "--where", "dt = '2026-10-01'")
+        self.assertNotIn(("coll_cnt_7d", "negative-value"), found)
+        self.assertNotIn(("channel", "undeclared-value"), found)
+        self.assertIn(("recall_ratio", "out-of-range"), found)
+
+    def test_where_columns_and_small_samples_are_not_called_constant(self):
+        root, db = make_repo()
+        _, found = findings(root, db, "--where", "dt = '2026-10-01'")
+        self.assertNotIn(("dt", "constant"), found)
+        code, out, _ = run(root, "run", "--sqlite", str(db), "--json")  # default minimum: 30 rows
+        self.assertNotIn("constant", {f["kind"] for f in json.loads(out)["findings"]})
+
+    def test_an_empty_range_is_reported_once_and_judges_nothing_else(self):
+        root, db = make_repo()
+        code, found = findings(root, db, "--where", "dt = '1999-01-01'")
+        self.assertEqual(code, 1)
+        self.assertEqual(list(found), [(None, "empty-table")])
+
+    def test_clean_data_exits_zero(self):
+        clean = [(dt, c, n, ratio, a, r, cert, None, ch) for dt, c, n, ratio, a, r, cert, ch in [
+            ("2026-10-01", "c1", 3, 0.1, "是", "SUCCESS", "ID", "bank"),
+            ("2026-10-02", "c2", 0, 0.0, "否", "FAILED", "PASSPORT", "card"),
+            ("2026-10-03", "c3", 7, 1.0, "无法判定", "SUCCESS", "ID", "bank")]]
+        root, db = make_repo(clean)
+        code, found = findings(root, db)
+        self.assertEqual(code, 0, found)
+        self.assertEqual([k for k, f in found.items() if not f["documented"]], [])
+
+    def test_external_runner_gets_only_selects_and_its_csv_or_json_is_read(self):
+        root, db = make_repo()
+        runner = root / "runner.py"
+        log = root / "sql.log"
+        runner.write_text(textwrap.dedent(f'''
+            import csv, sqlite3, sys
+            sql = sys.stdin.read()
+            open({str(log)!r}, "a").write(sql + "\\n")
+            con = sqlite3.connect({str(db)!r})
+            cur = con.execute(sql)
+            w = csv.writer(sys.stdout)
+            w.writerow([d[0] for d in cur.description])
+            w.writerows(cur.fetchall())
+        '''), encoding="utf-8")
+        code, out, err = run(root, "run", "--runner", f"{sys.executable} {runner}", "--json")
+        self.assertEqual(code, 1, err)
+        kinds = {(f["column"], f["kind"]) for f in json.loads(out)["findings"]}
+        self.assertIn(("coll_cnt_7d", "negative-value"), kinds)
+        statements = [s for s in log.read_text(encoding="utf-8").split("\n") if s.strip()]
+        self.assertTrue(statements and all(s.startswith("SELECT ") for s in statements))
+
+
+class PlanJudgeTest(unittest.TestCase):
+    def test_plan_then_judge_matches_run(self):
+        root, db = make_repo()
+        code, out, _ = run(root, "plan", "--dialect", "spark", "--skip", "channel")
+        self.assertEqual(code, 0)
+        queries = json.loads(out)
+        self.assertEqual([q["id"] for q in queries],
+                         ["profile:customer_daily", "values:customer_daily.agent_risk", "values:customer_daily.result"])
+        self.assertIn("COUNT(DISTINCT `coll_cnt_7d`) AS d_2", queries[0]["sql"])
+        self.assertIn("MIN(`recall_ratio`) AS mn_3", queries[0]["sql"])
+        self.assertNotIn("channel", queries[0]["sql"])
+        con = sqlite3.connect(db)
+        results = {}
+        for q in queries:
+            cur = con.execute(q["sql"].replace("`", '"'))
+            results[q["id"]] = [dict(zip([d[0] for d in cur.description], r)) for r in cur.fetchall()]
+        path = root / "results.json"
+        path.write_text(json.dumps(results), encoding="utf-8")
+        code, out, _ = run(root, "judge", "--skip", "channel", "--results", str(path), "--json", "--constant-min-rows", "2")
+        kinds = {(f["column"], f["kind"]) for f in json.loads(out)["findings"]}
+        self.assertIn(("agent_risk", "unseen-value"), kinds)
+        self.assertNotIn(("channel", "undeclared-value"), kinds)
+
+    def test_profile_batches_cover_every_column_and_report_an_empty_range_once(self):
+        root, db = make_repo()
+        code, out, _ = run(root, "plan", "--batch", "4")
+        ids = [q["id"] for q in json.loads(out) if q["kind"] == "profile"]
+        self.assertEqual(ids, ["profile:customer_daily#1", "profile:customer_daily#2", "profile:customer_daily#3"])
+        cols = [c for q in json.loads(out) if q["kind"] == "profile" for c in q["columns"]]
+        self.assertEqual(len(cols), 9)
+        _, found = findings(root, db, "--batch", "4")
+        self.assertIn(("recall_ratio", "out-of-range"), found)
+        self.assertIn(("legacy_flag", "never-filled"), found)
+        _, empty = findings(root, db, "--batch", "4", "--where", "dt = 'none'")
+        self.assertEqual(list(empty), [(None, "empty-table")])
+
+    def test_a_missing_result_is_reported_not_skipped(self):
+        root, _ = make_repo()
+        path = root / "results.json"
+        path.write_text("{}", encoding="utf-8")
+        code, out, _ = run(root, "judge", "--results", str(path), "--json")
+        self.assertEqual(code, 1)
+        self.assertIn("not-run", {f["kind"] for f in json.loads(out)["findings"]})
+
+
+class OldEngineTest(unittest.TestCase):
+    def test_fields_from_an_engine_copy_without_values_still_plan(self):
+        from types import SimpleNamespace as NS
+        old = NS(name="t", fields=[NS(name="a", text={"en": "x"}, source="s", window=None, unit="count", line=1)])
+        [query] = dq.plan_queries([old], None, "ansi", set())
+        self.assertEqual(query["sql"], 'SELECT COUNT(*) AS n, COUNT("a") AS nn_0, COUNT(DISTINCT "a") AS d_0, '
+                                       'MIN("a") AS mn_0, MAX("a") AS mx_0 FROM t')
+
+
+class RowsTest(unittest.TestCase):
+    def test_runner_output_formats(self):
+        self.assertEqual(dq.parse_rows('[{"n": 1}]'), [{"n": 1}])
+        self.assertEqual(dq.parse_rows('{"value": "a", "n": 2}\n{"value": "b", "n": 3}\n'),
+                         [{"value": "a", "n": 2}, {"value": "b", "n": 3}])
+        self.assertEqual(dq.parse_rows("value,n\na,2\n"), [{"value": "a", "n": "2"}])
+        self.assertEqual(dq.parse_rows(""), [])
+
+
+class SetupTest(unittest.TestCase):
+    def test_without_the_catalog_engine_it_explains_the_setup(self):
+        root, _ = make_repo()
+        (root / "scripts/data-catalog/data_catalog.py").unlink()
+        code, _, err = run(root, "plan")
+        self.assertEqual(code, 2)
+        self.assertIn("set the repo up with the data-catalog skill first", err)
+
+    def test_an_unknown_table_is_refused(self):
+        root, _ = make_repo()
+        code, _, err = run(root, "plan", "--table", "nope")
+        self.assertEqual(code, 2)
+        self.assertIn("not documented in the catalog: nope", err)
+
+    def test_statements_other_than_one_select_are_refused(self):
+        for sql in ("DELETE FROM t", "SELECT 1; DROP TABLE t"):
+            with self.assertRaises(dq.QualityError):
+                dq.assert_read_only(sql)
+
+    def test_the_sqlite_runner_cannot_write(self):
+        root, db = make_repo()
+        with self.assertRaises(sqlite3.OperationalError):
+            dq.run_sqlite(str(db), "INSERT INTO customer_daily (dt) VALUES ('x')")
+
+
+if __name__ == "__main__":
+    unittest.main()

package/skills/app-dev/ios-foundation/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ios-foundation
 description: "Set up and prove an Expo / React Native native iOS workspace from a clean checkout to a manual Login smoke on an owned iOS Simulator: isolated worktree and private caches, Xcode/runtime/CocoaPods preflight, frozen install with `pod install --deployment`, platform-scoped prebuild, an ad-hoc-signed Debug simulator build, a private simulator by exact UDID, Metro on a free port, a disposable PostgreSQL backend with owned cleanup, and the evidence record (setup proof only; feature work reports the smoke result). Use for 'set up iOS', 'build the iOS app', 'run the app on the iOS simulator', 'add iOS to the React Native app', 'prove the iOS build', or when a pod install, xcodebuild, simulator boot, Metro connection or Keychain session fails. NOT for Android (android-foundation), signing, TestFlight or App Store release, or general workflow YAML (github-actions)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # iOS foundation

package/skills/app-dev/monorepo/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: monorepo
 description: Turborepo architecture for shared packages, pnpm workspaces, DAL boundaries, and pipelines.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Turborepo Monorepo Architecture

package/skills/app-dev/nextjs-fullstack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: nextjs-fullstack
 description: "Build or debug Next.js App Router features with React 19 — pages/layouts/route handlers, Server/Client Components, Server Actions, forms, middleware, DAL, strict TypeScript, Zod — plus our conventions: nuqs URL state, SWR cache, Skeleton/Progress + Sonner feedback, drag-and-drop upload, the portal app shell, list pages as filter/sort/paginate tables. shadcn component mechanics: see the shadcn skill."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Next.js 16 Fullstack Development

package/skills/app-dev/prisma-setup/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: prisma-setup
 description: Use when adding or debugging Prisma with PostgreSQL, Next.js, or Turborepo, including schema.prisma, prisma.config.ts, client generation, migrations, seeds, relations, adapters, and DAL/database-layer setup. Triggers on phrases like "Prisma schema", "prisma migrate", "schema.prisma", "seed the database", "PrismaClient error", "relation issue", or "database layer".
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Prisma v7 Setup Guide

package/skills/app-dev/pyspark/SKILL.md

@@ -12,7 +12,7 @@ description: >
   Connect, spark-submit, Hudi commits, backfills, validate-only canaries,
   cluster reconciliation, or Spark event-log profiling — including warehouse
   job timeouts, empty Hudi writes, or EMR/Dataproc performance regressions.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # PySpark

package/skills/app-dev/python-backend/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: python-backend
 description: "Python backend architecture for FastAPI, Tortoise ORM, Pydantic Settings, loguru, and uv. Also: uv.lock installs in CI/Docker via a proxy or mirror (`uv sync --frozen` bypasses it), slow uv installs on runners, relocking."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Python Backend Conventions

package/skills/app-dev/shadcn/SKILL.md

@@ -2,7 +2,7 @@
 name: shadcn
 description: "Add or debug shadcn/ui in a React/Next.js project: components.json, shadcn init/add, presets, registries, Tailwind styling, base/radix/aria composition, component fixes, and list-index pages — where the default is the DiceUI data table with filter/sort/pagination in the URL via nuqs, not a bare shadcn Table."
 allowed-tools: Bash(npx shadcn@latest *), Bash(pnpm dlx shadcn@latest *), Bash(bunx --bun shadcn@latest *)
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # shadcn/ui

package/skills/app-dev/zod-v4/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: zod-v4
 description: Zod v4 schema conventions and v3 migration for errors, validators, objects, enums, records, and async parsing.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Zod v3 to v4 Migration

package/skills/cicd/cloud-build/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: cloud-build
 description: "Build or debug Cloud Build pipelines for Cloud Run: cloudbuild.yaml, triggers, Artifact Registry, builds, migrations, deploys, secrets, VPC, notifications. Use cloud-deploy for staged promotion. NOT for GitHub Actions PR checks (github-actions)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Cloud Build Direct Deploy to Cloud Run

package/skills/cicd/cloud-debug/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: cloud-debug
 description: "Debug Cloud Build or Deploy failures: builds, deployments, health checks, and pipeline errors. Inputs: service, build ID, region. NOT for GitHub Actions runs (github-actions) or runtime errors in a running service (app-debug)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Cloud Build & Cloud Deploy Debug Skill

package/skills/cicd/cloud-deploy/SKILL.md

@@ -5,7 +5,7 @@ description: >
   CI/CD pipelines with staged promotion, verification gates, or GitFlow branching.
   Also use when debugging Cloud Deploy pipeline failures. NOT for simple single-container
   deploys — use cloud-build instead.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Cloud Deploy + Skaffold + Kustomize for Cloud Run

package/skills/cicd/docker/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: docker
 description: Docker/Podman container architecture and build patterns. Read when designing or reviewing containerization, Dockerfile structure, multi-stage builds, PyPI mirror support, or docker-compose setup for Python/uv projects, and when a Dockerfile's dependency install misses the layer cache on every build (build args such as a commit SHA or version declared too early) or an image build is slow in CI.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Docker Build Patterns

package/skills/cicd/github-actions/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: github-actions
 description: "Author, review, audit, profile, optimize, or debug GitHub Actions workflows (.github/workflows/*.yml): run-history audits, job and step timing, resource bottlenecks, before/after comparisons, conditional CI by changed path, the one required gate check, PR and merge-queue lanes, sharding, workers, caching, self-hosted runners, timeouts, concurrency, permissions and action pinning, post-deploy verification, npm publishing. Use for 'set up CI', 'CI is slow', 'profile CI', 'optimize our pipeline', 'audit CI for redundant or wasted jobs', 'why is this check stuck expected or never started', 'harden this workflow', or 'browser not found on the runner'. NOT for pushing, opening, or merging a PR, or writing CI conventions into CONTRIBUTING.md (github-flow), queue rules or a check unmet inside Mergify (mergify), Playwright config and specs (e2e-test), cloudbuild.yaml or Cloud Run deploys (cloud-build), or which gates a repo must prove (ensure-coverage)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # GitHub Actions

package/skills/cicd/github-flow/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: github-flow
 description: "Deliver a change after the commit: push, open a PR, wait for checks, and merge to main through the repo's flow (direct push, pull request, or merge queue). Use whenever you commit or finish a change, when CONTRIBUTING.md has a Delivery section, and for asks like 'commit this', 'push it', 'open a PR', 'ship it', 'land it', 'get it merged'. Also: declare a repo's delivery flow, or write the CI conventions and Delivery section into CONTRIBUTING.md on request. NOT for writing workflow YAML (github-actions), Mergify config or a stuck queued PR (mergify), cutting a release (resolve-release), or PRs that resolve-issues or rush-issues deliver."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # GitHub Flow

package/skills/cicd/google-cloud/SKILL.md

@@ -5,7 +5,7 @@ description: >
   project management. Use when configuring GCP resources, managing service
   accounts, setting up IAP access, configuring VPC networks, managing secrets,
   or debugging cloud infrastructure.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Google Cloud Platform (GCP) Skill

package/skills/cicd/mergify/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: mergify
 description: "Mergify merge queue and stacked PRs (`mergify stack`): config, rules, queue status, delivery. Use whenever a merge queue or stack is involved, including plain asks ('watch #123 till it merges', 'where is #412 in the queue', 'push this stack'): `gh pr view`/`gh pr checks` cannot see a dequeue; use `mergify queue show` and the bundled watcher. Also: a hook saying 'use mergify stack push', a missing Change-Id; authoring or debugging `.mergify.yml`, queue rules, merge protections, batch size, the ruleset making merges queue-only; enqueue policy (`@mergifyio queue` vs `auto_merge_conditions`); a push dequeuing a queued PR; bypass actors; freezing a branch. Failures: a PR stuck, queued but never merging, or merged unqueued; CI green on GitHub but unmet in Mergify; a batch going red or bisecting; a queue check missing rather than failing. Outranks the vendor mergify-* skills. NOT for pushing a PR in a repo without stack hooks (github-flow), workflow YAML (github-actions), or GCP deploy pipelines (cloud-deploy)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Mergify Merge Queue

package/skills/cicd/podman/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: podman
 description: "Debug, design, or fix Podman: rootless/rootful containers, pods, podman-compose, the socket and systemd services, Docker-compatible API (DOCKER_HOST/CONTAINER_HOST), networking, volumes, SELinux labels, Docker migration, and CI/SSH provisioning of rootless sockets (user lingering, XDG_RUNTIME_DIR). Covers FailedToOpenSocket and systemctl --user DBUS/XDG errors."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Podman Operations

package/skills/content/article-review/SKILL.md

@@ -6,7 +6,7 @@ description: >
   Use when a user shares an article, pastes article text, sends a URL, or asks to
   review, rate, critique, evaluate, 评价, 点评, 分析, or 看看 any article, post, or 文章.
   Default template is 公众号-支付行业.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # 文章评审引擎

package/skills/content/article-to-image/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: article-to-image
 description: "Generate article cover images: WeChat banner/square (公众号封面), Xiaohongshu (小红书封面), LinkedIn banner, general wide. Brainstorms 4 visual directions from the article, then renders each format with correct aspect ratios and title-safe zones. Use when given an article and asked for covers, banners, or 出图."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Article-to-Image

package/skills/content/flowchart-svg/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: flowchart-svg
 description: Create polished flowcharts directly as SVG and export PNG copies. Use when asked to draw, design, render, or deliver process diagrams, architecture diagrams, consulting workflows, decision flows, swimlanes, or other flowcharts as image files, especially when final outputs must include .svg and .png versions.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Flowchart SVG

package/skills/content/image-gen/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: image-gen
 description: Generate an image from a text prompt with OpenAI gpt-image-2 or Google Nano Banana (Gemini), saved to an image file. Use whenever the user asks to generate, create, make, draw, paint, render, or design an image, picture, illustration, photo, artwork, logo, icon, avatar, banner, hero image, thumbnail, poster, wallpaper, sticker, or concept art — including phrasings like "an image of X", "a picture of X", "show me what X would look like", or a request for a visual for a slide, blog post, README, or social post. Also triggers on Chinese phrasings such as 生成图片, 画一张图, 做一张海报, 设计一个 logo. NOT for charts or data visualizations (dataviz), flowcharts or architecture diagrams (flowchart-svg), or editing an existing image file.
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Image Generation

package/skills/content/mermaid/SKILL.md

@@ -2,7 +2,7 @@
 name: mermaid
 description: Create and edit Mermaid diagrams for architecture, API flows, database schemas, workflows, and data models.
 user-invocable: true
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Mermaid Diagram Creation

package/skills/content/wechat-article-writer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: wechat-article-writer
 description: "Write WeChat 公众号 articles in Chinese content styles — 踩坑型 (pitfall-story), 实操型 (how-to), 对比型 (comparison), 观察型 (industry insight) — in the account's house style from the nearest WRITING.md. Use for drafting from scratch, rewriting a draft, adapting source material into a publishable article, or picking the right style. NOT for business or technical documents (write-doc)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # WeChat Article Writer (公众号写作)

package/skills/content/wechat-publisher/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: wechat-publisher
 description: "Publish articles to a WeChat Official Account (公众号) via API: push Markdown to the draft box (or auto-publish with --publish), convert Markdown to WeChat HTML, upload images to the media library. Requires AppID + AppSecret + whitelisted server IP on a 认证订阅号/服务号. Consumes wechat-article-writer's Markdown."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # WeChat Publisher (公众号发布)

package/skills/content/wechat-search/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: wechat-search
 description: "Search WeChat 公众号 articles via Sogou Weixin, or read/summarize an article from a mp.weixin.qq.com URL (读/分析/总结) — suggest proactively when such a URL appears. Use for Chinese WeChat content, industry reports, competitor or trending topics. Requires Chrome Browser Relay. NOT general web search (web_search)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # WeChat Article Search & Reader (搜狗微信搜索)

package/skills/content/xai-search/SKILL.md

@@ -9,7 +9,7 @@ metadata:
         type: secret
         required: true
         description: xAI API key (get from console.x.ai)
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # xAI Search (X/Twitter + Web)

package/skills/core/distill-writing/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: distill-writing
 description: "Learn a house writing style from approved sample documents into the project's WRITING.md and writing/templates/, with evidence per rule, conflicts surfaced and manual edits kept. Use when given reference documents to learn from, or to set up or refresh the house style. NOT for writing a document (write-doc)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Distill a writing style

package/skills/core/doc-to-md/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: doc-to-md
 description: "Convert documents (PDF, DOCX, PPTX, XLSX, images) to Markdown so agents can read them. Use as the preprocessing step whenever binary files need to enter agent context — contract review, compliance audit, document analysis, evidence review."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # doc-to-md

package/skills/core/editorial-review/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: editorial-review
 description: "Review a document or generated report for what it says (does the reader get the answer, is the argument sound, is anything unsupported, obvious or repeated), then fix the content. Use to review, tighten or clarify a doc or report, and as the review step of write-doc and the report skills. NOT for Chinese wording (polish-cn) or code review (better-review)."
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # Editorial review

package/skills/core/house-style/SKILL.md

@@ -3,7 +3,7 @@ name: house-style
 description: "Shared reference the writing skills read by path: WRITING.md lookup and precedence, template choice, gap markers, template shape, the bundled templates, and the default English and Chinese style guides. Never select or invoke it as a task."
 disable-model-invocation: true
 user-invocable: false
-release-version: 0.38.0
+release-version: 0.39.0
 ---
 **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
 # House style

package/skills/core/plain-language/LICENSE

@@ -0,0 +1,3 @@
+MIT License
+
+Copyright (c) 2026 1AboveIO