@indiekitai/pi-skills 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IndieKit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @indiekitai/pi-skills
+
+[Pi coding agent](https://pi.dev) skills for PostgreSQL development, rate limiting, and debugging.
+
+## Install
+
+```bash
+npm install -g @indiekitai/pi-skills
+```
+
+Or add to your project:
+
+```bash
+npm install --save-dev @indiekitai/pi-skills
+```
+
+Pi auto-discovers skills from installed packages.
+
+## Skills
+
+| Skill | Description | Backed by |
+|-------|-------------|-----------|
+| `pg-toolkit` | All-in-one PG CLI: inspect, diff, top, health, types, analyze | [@indiekitai/pg-toolkit](https://www.npmjs.com/package/@indiekitai/pg-toolkit) |
+| `pg-inspect` | Schema introspection: tables, columns, indexes, views, functions | [@indiekitai/pg-inspect](https://www.npmjs.com/package/@indiekitai/pg-inspect) |
+| `pg-diff` | Compare schemas & generate migration SQL | [@indiekitai/pg-diff](https://www.npmjs.com/package/@indiekitai/pg-diff) |
+| `pg-top` | Real-time monitoring (htop for Postgres) | [@indiekitai/pg-top](https://www.npmjs.com/package/@indiekitai/pg-top) |
+| `pg-complete` | SQL autocompletion engine | [@indiekitai/pg-complete](https://www.npmjs.com/package/@indiekitai/pg-complete) |
+| `inspect` | Pretty-print objects (like Python's Rich inspect) | [@indiekitai/inspect](https://www.npmjs.com/package/@indiekitai/inspect) |
+| `throttled` | Rate limiting (fixed/sliding window, token bucket, GCRA) | [@indiekitai/throttled](https://www.npmjs.com/package/@indiekitai/throttled) |
+
+## Usage in Pi
+
+Once installed, skills appear automatically. Use them via:
+
+```
+/skill:pg-toolkit
+/skill:pg-inspect
+/skill:pg-diff
+...
+```
+
+Or just describe your task — Pi will pick the right skill based on descriptions.
+
+## Dependencies
+
+Each skill wraps an `@indiekitai/*` npm package. Install the ones you need:
+
+```bash
+# All PG tools at once
+npm install -g @indiekitai/pg-toolkit
+
+# Or individual tools
+npm install -g @indiekitai/pg-inspect @indiekitai/pg-diff @indiekitai/pg-top
+```
+
+## License
+
+MIT

package/inspect/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: inspect
+description: "Pretty-print any JavaScript/TypeScript object with full details: properties, methods, prototype chain, types. Like Python's Rich inspect(). Use when debugging or exploring objects."
+---
+
+# inspect
+
+Beautiful object inspection for Node.js. TypeScript port of Python Rich's inspect().
+
+## Setup
+
+```bash
+npm install -g @indiekitai/inspect
+```
+
+## Usage (CLI)
+
+```bash
+npx @indiekitai/inspect '{"name": "test", "count": 42}'
+npx @indiekitai/inspect --methods Array
+npx @indiekitai/inspect --all Promise
+npx @indiekitai/inspect --json '{"name": "test"}'
+```
+
+## Usage (API)
+
+```typescript
+import { inspect } from '@indiekitai/inspect';
+
+inspect(myObject);                    // Pretty print
+inspect(myObject, { methods: true }); // Include methods
+inspect(myObject, { all: true });     // Include private/dunder
+```

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@indiekitai/pi-skills",
+  "version": "0.1.0",
+  "description": "Pi coding agent skills for PostgreSQL, rate limiting, and object inspection — powered by IndieKit",
+  "keywords": ["pi", "coding-agent", "skills", "postgresql", "rate-limiting", "developer-tools"],
+  "author": "IndieKit <hello@indiekit.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/indiekitai/pi-skills.git"
+  },
+  "homepage": "https://github.com/indiekitai/pi-skills",
+  "pi": {
+    "skills": [
+      "pg-toolkit",
+      "pg-inspect",
+      "pg-diff",
+      "pg-top",
+      "pg-complete",
+      "inspect",
+      "throttled"
+    ]
+  }
+}

package/pg-complete/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: pg-complete
+description: "PostgreSQL SQL autocompletion engine: table names, columns, functions, keywords, joins. Use when building SQL editors, REPLs, or any tool that needs SQL completion."
+---
+
+# pg-complete
+
+PostgreSQL SQL autocompletion engine. TypeScript port of pgcli's completer.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/pg-complete
+```
+
+## Usage
+
+```bash
+export DATABASE_URL="postgresql://user:pass@host:5432/dbname"
+
+pg-complete "SELECT * FROM u"              # Complete table names
+pg-complete "SELECT users." --context      # Complete column names
+pg-complete --json "SELECT * FROM u"       # JSON output
+```
+
+## MCP Server
+
+```bash
+pg-complete --mcp                 # Start as MCP server
+```

package/pg-diff/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: pg-diff
+description: "Compare two PostgreSQL databases and generate migration SQL. Use when migrating schemas, reviewing database changes, or syncing environments."
+---
+
+# pg-diff
+
+Compare PostgreSQL schemas and generate migration SQL. TypeScript port of Python's migra.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/pg-diff
+```
+
+## Usage
+
+```bash
+pg-diff --from $DB_SOURCE --to $DB_TARGET          # Show diff
+pg-diff --from $DB_SOURCE --to $DB_TARGET --sql    # Generate migration SQL
+pg-diff --from $DB_SOURCE --to $DB_TARGET --json   # JSON output
+```
+
+## MCP Server
+
+```bash
+pg-diff --mcp                     # Start as MCP server (2 tools)
+```

package/pg-inspect/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: pg-inspect
+description: "Introspect PostgreSQL schemas: tables, columns, indexes, constraints, views, functions, enums, sequences, extensions. Use when you need to understand a database structure or generate documentation."
+---
+
+# pg-inspect
+
+PostgreSQL schema introspection. TypeScript port of Python's schemainspect.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/pg-inspect
+```
+
+## Usage
+
+```bash
+export DATABASE_URL="postgresql://user:pass@host:5432/dbname"
+
+pg-inspect                        # Full schema summary
+pg-inspect --tables               # List tables with columns
+pg-inspect --table users          # Specific table details
+pg-inspect --indexes              # All indexes
+pg-inspect --constraints          # All constraints
+pg-inspect --views                # All views
+pg-inspect --functions            # All functions
+pg-inspect --enums                # All enums
+pg-inspect --sequences            # All sequences
+pg-inspect --extensions           # All extensions
+pg-inspect --json                 # JSON output (all of the above)
+```
+
+## MCP Server
+
+```bash
+pg-inspect --mcp                  # Start as MCP server (9 tools)
+```

package/pg-toolkit/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: pg-toolkit
+description: "All-in-one PostgreSQL toolkit: inspect schemas, diff databases, monitor live queries, health checks, generate TypeScript types, and detect N+1/EAV anti-patterns. Use when working with PostgreSQL databases."
+---
+
+# pg-toolkit
+
+Unified PostgreSQL CLI that combines schema inspection, diffing, monitoring, health checks, type generation, and query analysis.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/pg-toolkit
+```
+
+## Usage
+
+Set your database connection:
+
+```bash
+export DATABASE_URL="postgresql://user:pass@host:5432/dbname"
+```
+
+### Inspect schema
+
+```bash
+pg-toolkit inspect                    # Full schema overview
+pg-toolkit inspect --tables           # List all tables
+pg-toolkit inspect --table users      # Inspect specific table
+pg-toolkit inspect --functions        # List functions
+pg-toolkit inspect --indexes          # List indexes
+pg-toolkit inspect --json             # JSON output
+```
+
+### Diff two databases
+
+```bash
+pg-toolkit diff --from $DB_A --to $DB_B          # Show differences
+pg-toolkit diff --from $DB_A --to $DB_B --sql    # Generate migration SQL
+pg-toolkit diff --from $DB_A --to $DB_B --json   # JSON output
+```
+
+### Monitor live queries
+
+```bash
+pg-toolkit top                        # Live dashboard (like htop for PG)
+pg-toolkit top --json                 # Snapshot as JSON
+pg-toolkit top --sort duration        # Sort by duration
+```
+
+### Health check
+
+```bash
+pg-toolkit health                     # Run all health checks
+pg-toolkit health --json              # JSON output
+```
+
+### Generate TypeScript types
+
+```bash
+pg-toolkit types                      # Generate types for all tables
+pg-toolkit types --table users        # Specific table
+pg-toolkit types --output types.ts    # Write to file
+```
+
+### Analyze queries (detect N+1, EAV)
+
+```bash
+pg-toolkit analyze                    # Detect anti-patterns
+pg-toolkit analyze --json             # JSON output
+```
+
+## JSON Output
+
+All subcommands support `--json` for structured output, making this tool ideal for AI agent consumption.

package/pg-top/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: pg-top
+description: "Monitor PostgreSQL in real-time: active queries, locks, connections, replication lag. Like htop for Postgres. Use when debugging slow queries or monitoring database load."
+---
+
+# pg-top
+
+Real-time PostgreSQL monitoring. TypeScript port of Python's pg_activity.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/pg-top
+```
+
+## Usage
+
+```bash
+export DATABASE_URL="postgresql://user:pass@host:5432/dbname"
+
+pg-top                            # Live TUI dashboard
+pg-top --json                     # One-shot JSON snapshot
+pg-top --sort duration            # Sort by query duration
+pg-top --sort cpu                 # Sort by CPU usage
+pg-top --filter waiting           # Show only waiting queries
+```
+
+## MCP Server
+
+```bash
+pg-top --mcp                      # Start as MCP server (5 tools)
+```

package/throttled/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: throttled
+description: "Rate limiting for Node.js: fixed window, sliding window, token bucket, GCRA, leaky bucket. Use when implementing API rate limiting or request throttling."
+---
+
+# throttled
+
+Production-grade rate limiting. TypeScript port of Python's throttled-py.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/throttled
+```
+
+## Usage (API)
+
+```typescript
+import { RateLimiter, FixedWindowStrategy, MemoryStore } from '@indiekitai/throttled';
+
+const limiter = new RateLimiter({
+  strategy: new FixedWindowStrategy({ limit: 100, window: '1m' }),
+  store: new MemoryStore(),
+});
+
+const result = await limiter.hit('user:123');
+// { allowed: true, remaining: 99, resetAt: ... }
+```
+
+## Strategies
+
+- Fixed Window
+- Sliding Window
+- Token Bucket
+- GCRA (Generic Cell Rate Algorithm)
+- Leaky Bucket
+
+## MCP Server
+
+```bash
+npx @indiekitai/throttled --mcp    # Start as MCP server (3 tools)
+```