@indiekitai/pi-skills 0.1.0 → 1.0.0

package/README.md

@@ -1,58 +1,59 @@
 # @indiekitai/pi-skills
 
-[Pi coding agent](https://pi.dev) skills for PostgreSQL development, rate limiting, and debugging.
+Developer tools as agent skills for [Pi](https://pi.dev), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex CLI](https://github.com/openai/codex), and [Amp](https://amp.dev).
 
 ## Install
 
+### Pi
 ```bash
-npm install -g @indiekitai/pi-skills
+pi install npm:@indiekitai/pi-skills
 ```
 
-Or add to your project:
-
+### Claude Code
 ```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
-...
+git clone https://github.com/indiekitai/pi-skills ~/indiekit-skills
+mkdir -p ~/.claude/skills
+for skill in ~/indiekit-skills/skills/*/; do
+  ln -s "$skill" ~/.claude/skills/$(basename "$skill")
+done
 ```
 
-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:
-
+### Codex CLI
 ```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
+git clone https://github.com/indiekitai/pi-skills ~/.codex/skills/indiekit-skills
 ```
 
+## Available Skills
+
+### PostgreSQL Suite
+| Skill | Description |
+|-------|-------------|
+| [pg-health](skills/pg-health/SKILL.md) | Database health diagnostics (20+ checks) |
+| [pg-inspect](skills/pg-inspect/SKILL.md) | Schema inspector (tables, indexes, functions, enums) |
+| [pg-diff](skills/pg-diff/SKILL.md) | Schema diff & migration SQL generator |
+| [pg-top](skills/pg-top/SKILL.md) | Real-time query & lock monitor |
+| [pg2ts](skills/pg2ts/SKILL.md) | Generate TypeScript types from schemas |
+
+### Developer Tools
+| Skill | Description |
+|-------|-------------|
+| [env-audit](skills/env-audit/SKILL.md) | Scan codebases for env vars, generate .env.example |
+| [throttled](skills/throttled/SKILL.md) | Rate limiting (fixed/sliding window, token bucket, GCRA) |
+| [llm-context](skills/llm-context/SKILL.md) | Estimate LLM context usage for codebases |
+| [just](skills/just/SKILL.md) | Task runner (Justfile format, like make but better) |
+
+### Terminal Rendering
+| Skill | Description |
+|-------|-------------|
+| [glamour](skills/glamour/SKILL.md) | Render Markdown in terminals with themes |
+| [lipgloss](skills/lipgloss/SKILL.md) | CSS-like terminal text styling |
+
+## Each tool also has
+
+- **CLI** with `--json` output
+- **MCP Server** for direct AI agent integration
+- **npm package** under `@indiekitai/` scope
+
 ## License
 
 MIT

package/package.json

@@ -1,24 +1,15 @@
 {
   "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"],
+  "version": "1.0.0",
+  "description": "IndieKit developer tools as Pi/Claude Code/Codex skills — PostgreSQL health, schema diff, type generation, rate limiting, terminal styling, and more",
+  "keywords": ["pi-package", "agent-skills", "postgresql", "developer-tools", "indiekit"],
   "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"
-    ]
+    "skills": ["./skills"]
   }
 }

package/skills/env-audit/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: env-audit
+description: Scan codebases for environment variable usage and generate documented .env.example files. Supports Python, Node, Go, Rust, Ruby, Shell, Docker. Use when auditing env vars, creating .env templates, or checking for undocumented variables in CI.
+---
+
+# env-audit
+
+Scan source code for environment variable references and generate documented templates.
+
+## Setup
+
+```bash
+pip install env-audit  # or just download env_audit.py
+```
+
+## Usage
+
+```bash
+# Scan current directory, output .env.example format
+python env_audit.py .
+
+# JSON output
+python env_audit.py . --json
+
+# Stats only
+python env_audit.py . --stats
+
+# CI check mode (exit 1 if undocumented vars)
+python env_audit.py . --check
+
+# Output to file
+python env_audit.py . -o .env.example
+
+# Alternative output formats
+python env_audit.py . --format typescript
+python env_audit.py . --format zod
+```
+
+## Supported Languages
+
+Python, JavaScript/TypeScript (Node), Go, Rust, Ruby, Shell/Bash, Docker
+
+## Output
+
+Categorized environment variables with:
+- Required vs optional detection
+- Sensitive variable marking (passwords, keys, secrets)
+- Default value extraction
+- File location references

package/skills/glamour/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: glamour
+description: Render Markdown beautifully in the terminal with ANSI styling. Supports themes (dark, light, dracula, tokyo-night, etc.), custom styles, and word wrapping. Use when displaying formatted Markdown content in CLI tools or terminal UIs.
+---
+
+# glamour
+
+Stylesheet-based Markdown rendering for terminals. TypeScript port of charmbracelet/glamour.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/glamour
+```
+
+## CLI Usage
+
+```bash
+# Render a Markdown file
+npx @indiekitai/glamour README.md
+
+# Choose a theme
+npx @indiekitai/glamour README.md --style dark
+npx @indiekitai/glamour README.md --style dracula
+npx @indiekitai/glamour README.md --style tokyo-night
+
+# Set width
+npx @indiekitai/glamour README.md --width 80
+
+# JSON output (rendered text + metadata)
+npx @indiekitai/glamour README.md --json
+
+# Pipe markdown
+echo "# Hello **world**" | npx @indiekitai/glamour
+```
+
+## Programmatic Usage
+
+```typescript
+import { render } from '@indiekitai/glamour';
+
+const output = render('# Hello **world**', { style: 'dark', width: 80 });
+console.log(output);
+```
+
+## Built-in Themes
+
+dark, light, ascii, notty, pink, dracula, tokyo-night
+
+## MCP Tools
+
+- `render_markdown` — Render with theme and width options
+- `render_plain` — Strip formatting, plain text output
+- `list_styles` — Show available themes

package/skills/just/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: just
+description: JavaScript/TypeScript task runner inspired by casey/just. Define tasks in a Justfile with dependencies, arguments, and shell recipes. Use when you need a simple, modern alternative to make/npm scripts for project automation.
+---
+
+# just-ts
+
+Task runner for JavaScript/TypeScript projects. Port of casey/just (Rust).
+
+## Setup
+
+```bash
+npm install -g @indiekitai/just-ts
+```
+
+## CLI Usage
+
+```bash
+# Run default task
+just
+
+# Run specific task
+just build
+just test
+just deploy staging
+
+# List available tasks
+just --list
+
+# JSON output (task definitions)
+just --json
+
+# Dry run
+just --dry-run build
+```
+
+## Justfile Format
+
+Create a `Justfile` in your project root:
+
+```just
+# Build the project
+build:
+  npm run build
+
+# Run tests with optional filter
+test filter="":
+  npm test -- {{filter}}
+
+# Deploy to environment
+deploy env: build test
+  ./scripts/deploy.sh {{env}}
+
+# Clean build artifacts
+clean:
+  rm -rf dist node_modules
+```
+
+## Features
+
+- **Dependencies**: Tasks can depend on other tasks
+- **Arguments**: Pass arguments to tasks with default values
+- **Shell recipes**: Each line runs in a shell
+- **Comments**: `#` comments become task descriptions in `--list`

package/skills/lipgloss/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: lipgloss
+description: Terminal styling library with CSS-like API. Apply colors, borders, padding, margins, and alignment to terminal text. Use when building beautiful CLI output or terminal UIs in TypeScript/Node.js.
+---
+
+# lipgloss
+
+CSS-like terminal styling for TypeScript/Node.js. Port of charmbracelet/lipgloss.
+
+## Setup
+
+```bash
+npm install @indiekitai/lipgloss
+```
+
+## CLI Usage
+
+```bash
+# Style text from CLI
+npx @indiekitai/lipgloss "Hello World" --fg "#FF69B4" --bold --border rounded --padding 1
+
+# JSON output
+npx @indiekitai/lipgloss "Hello World" --fg red --json
+```
+
+## Programmatic Usage
+
+```typescript
+import { NewStyle, Color } from '@indiekitai/lipgloss';
+
+const style = NewStyle()
+  .Foreground(Color('#FF69B4'))
+  .Bold(true)
+  .Border('rounded')
+  .Padding(1, 2)
+  .MarginTop(1);
+
+console.log(style.Render('Hello World'));
+```
+
+## Features
+
+- **Colors**: Hex, ANSI 256, named colors, adaptive (light/dark)
+- **Text**: Bold, italic, underline, strikethrough, faint, blink
+- **Layout**: Padding, margins, width/height, alignment (left/center/right)
+- **Borders**: Rounded, thick, double, hidden, custom
+- **Composition**: JoinHorizontal, JoinVertical, Place

package/skills/llm-context/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: llm-context
+description: Scan a codebase and estimate LLM context usage. Shows file sizes, token counts, and identifies large files that may blow context windows. Use when preparing codebases for AI coding agents or optimizing what to include in prompts.
+---
+
+# llm-context
+
+Analyze codebase context size for LLM consumption.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/llm-context
+```
+
+## Usage
+
+```bash
+# Scan current directory
+npx @indiekitai/llm-context .
+
+# JSON output
+npx @indiekitai/llm-context . --json
+
+# Set context limit (tokens)
+npx @indiekitai/llm-context . --limit 128000
+
+# Exclude patterns
+npx @indiekitai/llm-context . --exclude "*.test.ts" --exclude "dist/**"
+
+# Show top N largest files
+npx @indiekitai/llm-context . --top 20
+```
+
+## Output
+
+- Total token count estimate
+- Per-file token breakdown
+- Files exceeding context budget
+- Suggestions for reducing context size

package/skills/pg-diff/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: pg-diff
+description: PostgreSQL schema diff and migration generator. Compare two database schemas and generate SQL migration statements. Use when planning migrations, reviewing schema 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
+# Compare two databases
+pg-diff --from "postgres://user:pass@host/db1" --to "postgres://user:pass@host/db2"
+
+# JSON output
+pg-diff --from "..." --to "..." --json
+
+# Generate migration SQL only
+pg-diff --from "..." --to "..." --sql
+
+# Exclude specific object types
+pg-diff --from "..." --to "..." --ignore-indexes
+```
+
+## Output
+
+Shows schema differences (added/removed/changed tables, columns, indexes, etc.) and generates the SQL needed to migrate from source to target schema.

package/skills/pg-health/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: pg-health
+description: PostgreSQL health checker. Run diagnostics on connection bloat, cache hit ratios, index usage, table stats, vacuum status, and replication lag. Use when analyzing PostgreSQL performance or troubleshooting database issues.
+---
+
+# pg-health
+
+PostgreSQL health diagnostics tool. Checks 20+ metrics including connections, cache, indexes, bloat, locks, vacuum, and replication.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/pg-health
+```
+
+## Usage
+
+```bash
+# Full health check
+pg-health --url "postgres://user:pass@host:5432/db"
+
+# JSON output for programmatic use
+pg-health --url "postgres://user:pass@host:5432/db" --json
+
+# Check specific category
+pg-health --url "..." --check connections
+pg-health --url "..." --check cache
+pg-health --url "..." --check indexes
+pg-health --url "..." --check bloat
+pg-health --url "..." --check vacuum
+pg-health --url "..." --check replication
+```
+
+## Output
+
+Returns health status (healthy/warning/critical) for each check with actionable recommendations. JSON mode outputs structured data suitable for dashboards or CI pipelines.

package/skills/pg-inspect/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: pg-inspect
+description: PostgreSQL schema inspector. Extract detailed schema information including tables, columns, indexes, constraints, views, functions, enums, and sequences. Use when you need to understand a database structure or generate documentation.
+---
+
+# pg-inspect
+
+Inspect PostgreSQL database schemas programmatically. TypeScript port of Python's schemainspect.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/pg-inspect
+```
+
+## Usage
+
+```bash
+# Full schema inspection
+pg-inspect --url "postgres://user:pass@host:5432/db"
+
+# JSON output
+pg-inspect --url "postgres://user:pass@host:5432/db" --json
+
+# Inspect specific objects
+pg-inspect --url "..." --tables
+pg-inspect --url "..." --views
+pg-inspect --url "..." --functions
+pg-inspect --url "..." --indexes
+pg-inspect --url "..." --enums
+pg-inspect --url "..." --sequences
+pg-inspect --url "..." --constraints
+
+# Filter by schema
+pg-inspect --url "..." --schema public
+```
+
+## Output
+
+Returns structured schema information. JSON mode provides complete schema metadata for code generation, migration planning, or documentation.

package/skills/pg-top/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: pg-top
+description: PostgreSQL real-time activity monitor. Show running queries, locks, blocking chains, and per-database stats. Use when debugging slow queries, investigating locks, or monitoring database load.
+---
+
+# pg-top
+
+Real-time PostgreSQL activity monitor. TypeScript port of Python's pg_activity.
+
+## Setup
+
+```bash
+npm install -g @indiekitai/pg-top
+```
+
+## Usage
+
+```bash
+# Show current activity
+pg-top --url "postgres://user:pass@host:5432/db"
+
+# JSON output (snapshot mode)
+pg-top --url "..." --json
+
+# Show only active queries
+pg-top --url "..." --active
+
+# Show locks and blocking chains
+pg-top --url "..." --locks
+
+# Show database-level stats
+pg-top --url "..." --stats
+
+# Filter by duration (show queries running > 5s)
+pg-top --url "..." --min-duration 5
+```
+
+## Output
+
+Displays running queries with PID, duration, state, and SQL text. Lock mode shows blocking chains. JSON mode provides structured data for automation.

package/skills/pg2ts/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: pg2ts
+description: Generate TypeScript types from PostgreSQL schemas. Connects to a database and outputs TypeScript interfaces for all tables. Use when setting up type-safe database access or keeping types in sync with schema.
+---
+
+# pg2ts
+
+Generate TypeScript type definitions from PostgreSQL database schemas.
+
+## Setup
+
+```bash
+pip install pg2ts  # or just download pg2ts.py
+```
+
+## Usage
+
+```bash
+# Generate types for all tables
+python pg2ts.py --url "postgres://user:pass@host:5432/db"
+
+# Output to file
+python pg2ts.py --url "..." -o types.ts
+
+# JSON metadata output
+python pg2ts.py --url "..." --json
+
+# Filter by schema
+python pg2ts.py --url "..." --schema public
+
+# Include enums
+python pg2ts.py --url "..." --enums
+```
+
+## Output
+
+Generates TypeScript interfaces matching database tables, with proper type mappings (int→number, text→string, jsonb→Record, etc.). JSON mode outputs metadata about the generated types.

package/skills/throttled/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: throttled
+description: Rate limiting library with multiple strategies (fixed window, sliding window, token bucket, leaky bucket, GCRA). Use when implementing API rate limiting, request throttling, or quota management in TypeScript/Node.js projects.
+---
+
+# throttled
+
+Full-featured rate limiting for TypeScript/Node.js. Port of Python's throttled-py.
+
+## Setup
+
+```bash
+npm install @indiekitai/throttled
+```
+
+## CLI Usage
+
+```bash
+# Test rate limiter interactively
+npx @indiekitai/throttled --strategy fixed-window --rate "10/minute"
+
+# JSON output
+npx @indiekitai/throttled --strategy token-bucket --rate "100/hour" --json
+```
+
+## Programmatic Usage
+
+```typescript
+import { FixedWindow, SlidingWindow, TokenBucket, LeakyBucket, GCRA } from '@indiekitai/throttled';
+
+// Fixed window: 10 requests per minute
+const limiter = new FixedWindow({ rate: 10, period: 60_000 });
+const result = limiter.allow('user-123');
+// { allowed: true, remaining: 9, resetAt: ... }
+
+// Token bucket: burst-friendly
+const bucket = new TokenBucket({ rate: 10, period: 60_000, burst: 20 });
+
+// Sliding window: smooth distribution
+const sliding = new SlidingWindow({ rate: 100, period: 3600_000 });
+```
+
+## Strategies
+
+- **FixedWindow** — Simple time-window counting
+- **SlidingWindow** — Weighted window for smoother limits
+- **TokenBucket** — Allows bursts up to bucket size
+- **LeakyBucket** — Constant drain rate, smooths traffic
+- **GCRA** — Generic Cell Rate Algorithm, telco-grade precision

package/inspect/SKILL.md

@@ -1,33 +0,0 @@
----
-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/pg-complete/SKILL.md

@@ -1,30 +0,0 @@
----
-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

@@ -1,28 +0,0 @@
----
-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

@@ -1,38 +0,0 @@
----
-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

@@ -1,75 +0,0 @@
----
-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

@@ -1,32 +0,0 @@
----
-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

@@ -1,42 +0,0 @@
----
-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)
-```