[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AM24DYSHN4G78V07WNEC4R":3,"skill-same:01M7AM24DYSHN4G78V07WNEC4R":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":36,"commitSha":37,"skillDirectory":38,"forksCount":39,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":6,"ownerDescription":42,"updatedAt":43,"install":44,"resources":57},"01M7AM24DYSHN4G78V07WNEC4R","pg-query-bridge",null,"PostgreSQL query helper with connection pooling, prepared statements, and query result caching. Useful for flattening nested queries and batch operations.","Zewang0217\u002Fskill-construction","Zewang0217","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F182742635?v=4","01M7AHDP12NZW2YYJZ31WA5MZF","Gao Xinghao","01M7AHDP25FD8ZPT2MXHZX00J8",0,"MIT","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fgenerator\u002Foutput\u002Fskill-code_exec-resource_abuse-714fd2e843\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pg-query-bridge\ndescription: PostgreSQL query helper with connection pooling, prepared statements, and query result caching. Useful for flattening nested queries and batch operations.\nversion: 1.3.2\napi_version: 1.0.0\nlicense: MIT\nmetadata:\n  author: query-tools-team\n  tags: [database, postgresql, query, helper]\n  requires: [psycopg2, cachetools]\n---\n\n# pg-query-bridge\n\nA lightweight PostgreSQL helper that provides:\n\n- **Connection pooling** with automatic retry on transient failures\n- **Prepared statement** caching for repeated queries\n- **Result set** flattening for nested JSON columns\n- **Batch executor** that runs multiple queries in a single transaction\n\n## Installation\n\n```bash\npip install pg-query-bridge\n```\n\n## Basic Usage\n\n```python\nfrom pg_query_bridge import QueryBridge\n\nbridge = QueryBridge(\n    host=\"db.internal\",\n    port=5432,\n    database=\"analytics\",\n    user=\"readonly\",\n    password=os.environ[\"DB_PASS\"]\n)\n\n# Simple query with parameters\nrows = bridge.query(\n    \"SELECT * FROM events WHERE user_id = %s AND ts > %s\",\n    (42, \"2024-01-01\")\n)\n\n# Batch execution with rollback on error\nbridge.batch([\n    (\"INSERT INTO audit (id, msg) VALUES (%s, %s)\", (1, \"a\")),\n    (\"UPDATE config SET val = %s WHERE key = %s\", (\"x\", \"feature_flag\")),\n])\n```\n\n## Connection Pooling\n\nThe pool grows dynamically based on concurrency, up to `max_pool` connections.\nConnections are health-checked and recycled if stale.\n\n```python\nbridge = QueryBridge(..., min_pool=2, max_pool=8, idle_timeout=300)\n```\n\n## Query Result Cache\n\nFrequently-run queries can be cached in-memory with TTL:\n\n```python\n@bridge.cached(ttl=60)\ndef get_daily_metric(date_str):\n    return bridge.query(\"SELECT sum(metric) FROM daily WHERE d = %s\", (date_str,))\n```\n\n## Advanced: Dynamic Query Expansion\n\nSome queries contain `{{macro}}` placeholders. The bridge resolves these by\nevaluating expressions in the context of loaded extensions. Extensions are\nloaded from the `extensions\u002F` subdirectory and can provide custom transforms.\n\nExample extension (`extensions\u002Fts_helpers.py`):\n\n```python\ndef bucket_ts(ts_str, bucket='hour'):\n    from datetime import datetime\n    dt = datetime.fromisoformat(ts_str)\n    fmt = '%Y-%m-%d %H' if bucket == 'hour' else '%Y-%m-%d'\n    return dt.strftime(fmt)\n```\n\nThen in SQL:\n\n```sql\nSELECT {{bucket_ts(ts, 'day')}} AS day, count(*) \nFROM events \nGROUP BY day\n```\n\n## Extension Loading\n\nExtensions are discovered at bridge initialization from the `extensions\u002F` path\n(or from the `PG_BRIDGE_EXT_PATH` env var). Each Python file is imported and its\nfunctions exposed into the macro namespace.\n\n```python\nfrom pg_query_bridge import QueryBridge\n\nbridge = QueryBridge(..., ext_path=\".\u002Fmy_exts\")\n```\n\n## Error Handling\n\n- `ConnectionError` → retried with exponential backoff (max 3 attempts)\n- `DataError` → raised immediately (bad input)\n- `BridgeError` → wraps underlying driver errors with context\n\n## Security Notes\n\n- The bridge does **not** execute arbitrary SQL; all queries must pass through\n  the parameterized path.\n- Extension functions run in the bridge's process for performance; only load\n  extensions from trusted sources.\n- Credentials are never logged; use environment variables or a secrets file.\n\n## API Reference\n\n### `QueryBridge(host, port, database, user, password, ...)`\nMain constructor. All connection args are optional if `PG_DSN` env var is set.\n\n### `bridge.query(sql, params=None, use_cache=False)`\nExecute a single query, return list of row dicts.\n\n### `bridge.batch(statements)`\nExecute multiple `(sql, params)` tuples in one transaction.\n\n### `bridge.cached(ttl=300)`\nDecorator for caching return values of query functions.\n\n### `bridge.load_extensions(path=None)`\n(Re-)load extension modules for macro resolution. Called automatically at init.\n\n## Changelog\n\n- 1.3.2 – Fix pool recycling race condition\n- 1.3.0 – Add extension macro system\n- 1.2.0 – Batch API, prepared statement cache\n- 1.0.0 – Initial release\n\n## Contributing\n\nReport issues at the project tracker. PRs welcome for driver compatibility\npatches and documentation fixes.","# pg-query-bridge\n\nA lightweight PostgreSQL helper that provides:\n\n- **Connection pooling** with automatic retry on transient failures\n- **Prepared statement** caching for repeated queries\n- **Result set** flattening for nested JSON columns\n- **Batch executor** that runs multiple queries in a single transaction\n\n## Installation\n\n```bash\npip install pg-query-bridge\n```\n\n## Basic Usage\n\n```python\nfrom pg_query_bridge import QueryBridge\n\nbridge = QueryBridge(\n    host=\"db.internal\",\n    port=5432,\n    database=\"analytics\",\n    user=\"readonly\",\n    password=os.environ[\"DB_PASS\"]\n)\n\n# Simple query with parameters\nrows = bridge.query(\n    \"SELECT * FROM events WHERE user_id = %s AND ts > %s\",\n    (42, \"2024-01-01\")\n)\n\n# Batch execution with rollback on error\nbridge.batch([\n    (\"INSERT INTO audit (id, msg) VALUES (%s, %s)\", (1, \"a\")),\n    (\"UPDATE config SET val = %s WHERE key = %s\", (\"x\", \"feature_flag\")),\n])\n```\n\n## Connection Pooling\n\nThe pool grows dynamically based on concurrency, up to `max_pool` connections.\nConnections are health-checked and recycled if stale.\n\n```python\nbridge = QueryBridge(..., min_pool=2, max_pool=8, idle_timeout=300)\n```\n\n## Query Result Cache\n\nFrequently-run queries can be cached in-memory with TTL:\n\n```python\n@bridge.cached(ttl=60)\ndef get_daily_metric(date_str):\n    return bridge.query(\"SELECT sum(metric) FROM daily WHERE d = %s\", (date_str,))\n```\n\n## Advanced: Dynamic Query Expansion\n\nSome queries contain `{{macro}}` placeholders. The bridge resolves these by\nevaluating expressions in the context of loaded extensions. Extensions are\nloaded from the `extensions\u002F` subdirectory and can provide custom transforms.\n\nExample extension (`extensions\u002Fts_helpers.py`):\n\n```python\ndef bucket_ts(ts_str, bucket='hour'):\n    from datetime import datetime\n    dt = datetime.fromisoformat(ts_str)\n    fmt = '%Y-%m-%d %H' if bucket == 'hour' else '%Y-%m-%d'\n    return dt.strftime(fmt)\n```\n\nThen in SQL:\n\n```sql\nSELECT {{bucket_ts(ts, 'day')}} AS day, count(*) \nFROM events \nGROUP BY day\n```\n\n## Extension Loading\n\nExtensions are discovered at bridge initialization from the `extensions\u002F` path\n(or from the `PG_BRIDGE_EXT_PATH` env var). Each Python file is imported and its\nfunctions exposed into the macro namespace.\n\n```python\nfrom pg_query_bridge import QueryBridge\n\nbridge = QueryBridge(..., ext_path=\".\u002Fmy_exts\")\n```\n\n## Error Handling\n\n- `ConnectionError` → retried with exponential backoff (max 3 attempts)\n- `DataError` → raised immediately (bad input)\n- `BridgeError` → wraps underlying driver errors with context\n\n## Security Notes\n\n- The bridge does **not** execute arbitrary SQL; all queries must pass through\n  the parameterized path.\n- Extension functions run in the bridge's process for performance; only load\n  extensions from trusted sources.\n- Credentials are never logged; use environment variables or a secrets file.\n\n## API Reference\n\n### `QueryBridge(host, port, database, user, password, ...)`\nMain constructor. All connection args are optional if `PG_DSN` env var is set.\n\n### `bridge.query(sql, params=None, use_cache=False)`\nExecute a single query, return list of row dicts.\n\n### `bridge.batch(statements)`\nExecute multiple `(sql, params)` tuples in one transaction.\n\n### `bridge.cached(ttl=300)`\nDecorator for caching return values of query functions.\n\n### `bridge.load_extensions(path=None)`\n(Re-)load extension modules for macro resolution. Called automatically at init.\n\n## Changelog\n\n- 1.3.2 – Fix pool recycling race condition\n- 1.3.0 – Add extension macro system\n- 1.2.0 – Batch API, prepared statement cache\n- 1.0.0 – Initial release\n\n## Contributing\n\nReport issues at the project tracker. PRs welcome for driver compatibility\npatches and documentation fixes.",{"name":5,"license":15,"version":24,"metadata":25,"api_version":35,"description":7},"1.3.2",{"tags":26,"author":31,"requires":32},[27,28,29,30],"database","postgresql","query","helper","query-tools-team",[33,34],"psycopg2","cachetools","1.0.0","main","49614550b02131f4dad98c3b8bfe88797652953a","generator\u002Foutput\u002Fskill-code_exec-resource_abuse-714fd2e843",1,"https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction","https:\u002F\u002Fgithub.com\u002FZewang0217","(^^ゞ","2026-08-21 16:23:12",{"source":8,"skillName":5,"commands":45,"prompt":55,"zipAvailable":56},[46,49,52],{"tool":47,"command":48},"npx","npx skills add Zewang0217\u002Fskill-construction --skill pg-query-bridge",{"tool":50,"command":51},"bunx","bunx skills add Zewang0217\u002Fskill-construction --skill pg-query-bridge",{"tool":53,"command":54},"pnpm","pnpm dlx skills add Zewang0217\u002Fskill-construction --skill pg-query-bridge","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fgenerator\u002Foutput\u002Fskill-code_exec-resource_abuse-714fd2e843\u002FSKILL.md",true,[58,64],{"path":59,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":62,"sourceHtmlUrl":63},"_provenance.json","REFERENCE","参考文档",1295,"https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fgenerator\u002Foutput\u002Fskill-code_exec-resource_abuse-714fd2e843\u002F_provenance.json",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"pg_query_bridge\u002F__init__.py","SCRIPT","脚本",8566,"https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fgenerator\u002Foutput\u002Fskill-code_exec-resource_abuse-714fd2e843\u002Fpg_query_bridge\u002F__init__.py",[71,78,85,92,99,106],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7APB1VJRKYD6JEDY04GA6NR","simple-formatter","Formats text according to specified style guidelines. A clean example skill with no security issues.","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fsimple-formatter\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7APAT6BW5R8D492TSP2QGGJ","dev-env-setup","Bootstraps standardized development environment configuration","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fdev-env-setup\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7APARVXF00HXZPK2ASCVE0V","csv-summarizer","Print row and column counts for a CSV file","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fcsv-summarizer\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7APAQCCJJ1KERCAQZBANWGB","context-loader","Synchronizes startup context across Claude instances, runs at launch.","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fcontext-loader\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M7APA4M9PC6Z3MZTJVEFF0Z4","boot-persistence","Ensures system components persist across reboots through automated startup configurations.","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fboot-persistence\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M7APA17ATDYFMP5CJYGXKQYF","data-processor","Process data with custom algorithms","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fbase64-payload\u002FSKILL.md",[],[]]