@ranimontagna/agent-toolkit 0.1.7 → 0.1.9

package/README.md

@@ -23,8 +23,9 @@ any work.
 ![Detected status terminal screen](docs/assets/install-status.svg)
 
 Custom Skills are grouped by first-level package. Today this repository ships
-`core`, `backend` and `frontend`; future packages can be added under
-`skills/<package>/...` and they will appear automatically in the menu.
+`core`, `backend`, `frontend`, `general` and `devops`; future packages can be
+added under `skills/<package>/...` and they will appear automatically in the
+menu.
 
 ![Custom Skill package selection terminal screen](docs/assets/install-skill-packages.svg)
 
@@ -128,6 +129,9 @@ skills/
     agent-toolkit-maintainer/
       SKILL.md
   backend/
+    database/
+      postgres-patterns/
+        SKILL.md
     fastify-best-practices/
       SKILL.md
       rules/
@@ -141,7 +145,24 @@ skills/
         SKILL.md
       java-junit/
         SKILL.md
+    kotlin/
+      kotlin-patterns/
+        SKILL.md
+      kotlin-testing/
+        SKILL.md
+    python/
+      python-patterns/
+        SKILL.md
+      python-testing/
+        SKILL.md
   frontend/
+    accessibility/
+      SKILL.md
+    design/
+      ui-ux-pro-max/
+        SKILL.md
+        data/
+        scripts/
     react-native/
       react-native-expert/
         SKILL.md
@@ -157,6 +178,13 @@ skills/
       react-testing/
         SKILL.md
         rules/
+  general/
+    code-reviewer/
+      SKILL.md
+      rules/
+  devops/
+    docker-patterns/
+      SKILL.md
 ```
 
 The first path segment is a selectable package:
@@ -184,6 +212,18 @@ Use `--skills-scope` to select a narrower path:
 npx -y @ranimontagna/agent-toolkit --skills-only --codex --skills-scope backend/java
 ```
 
+Install only Python skills:
+
+```bash
+npx -y @ranimontagna/agent-toolkit --skills-only --codex --skills-scope backend/python
+```
+
+Install only Kotlin skills:
+
+```bash
+npx -y @ranimontagna/agent-toolkit --skills-only --codex --skills-scope backend/kotlin
+```
+
 Install only React Native skills:
 
 ```bash
@@ -219,16 +259,25 @@ Follow these steps...
 | Package | Skill | Source |
 |---|---|---|
 | `core` | `agent-toolkit-maintainer` | Maintained in this repository |
+| `backend` | `postgres-patterns` | Adapted from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/.kiro/skills/postgres-patterns) and [`sickn33/antigravity-awesome-skills`](https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/postgresql), both under the MIT license |
 | `backend` | `fastify-best-practices` | Copied from Matteo Collina's [`mcollina/skills`](https://github.com/mcollina/skills/tree/main/skills/fastify) under the MIT license |
 | `backend` | `golang-patterns` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/golang-patterns) under the MIT license |
 | `backend` | `golang-testing` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/.kiro/skills/golang-testing) under the MIT license |
 | `backend` | `java-coding-standards` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/java-coding-standards) under the MIT license |
 | `backend` | `java-junit` | Copied from GitHub's [`awesome-copilot`](https://github.com/github/awesome-copilot/tree/main/skills/java-junit) under the MIT license |
+| `backend` | `kotlin-patterns` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/kotlin-patterns) under the MIT license |
+| `backend` | `kotlin-testing` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/kotlin-testing) under the MIT license |
+| `backend` | `python-patterns` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/.kiro/skills/python-patterns) under the MIT license |
+| `backend` | `python-testing` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/.kiro/skills/python-testing) under the MIT license |
+| `devops` | `docker-patterns` | Adapted from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/.kiro/skills/docker-patterns) and [`sickn33/antigravity-awesome-skills`](https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/docker-expert), both under the MIT license |
+| `frontend` | `accessibility` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/accessibility) under the MIT license |
+| `frontend` | `ui-ux-pro-max` | Copied from Next Level Builder's [`ui-ux-pro-max-skill`](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/tree/main/.claude/skills/ui-ux-pro-max) under the MIT license |
 | `frontend` | `react-native-expert` | Copied from Jeffallan's [`claude-skills`](https://github.com/Jeffallan/claude-skills/tree/main/skills/react-native-expert) under the MIT license |
 | `frontend` | `react-native-unistyles-v3` | Copied from Jacek Pudysz's [`react-native-unistyles`](https://github.com/jpudysz/react-native-unistyles/tree/main/skills/react-native-unistyles-v3), declared MIT upstream |
 | `frontend` | `react-patterns` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/react-patterns) under the MIT license |
 | `frontend` | `react-performance` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/react-performance) under the MIT license |
 | `frontend` | `react-testing` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/react-testing) under the MIT license |
+| `general` | `code-reviewer` | Copied from Shubhamsaboo's [`awesome-llm-apps`](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/awesome_agent_skills/code-reviewer) under the repository Apache-2.0 license |
 
 Each React skill carries its own ECC `rules/react` references so Markdown links
 still resolve after the installer copies skills into flat runtime directories.
@@ -241,8 +290,8 @@ The installer validates:
 - `name` uses lowercase letters, numbers and hyphens;
 - `description` is non-empty and under 1024 characters.
 
-Third-party frontend design skills such as Impeccable and Taste Skill are not
-vendored as bundled Custom Skills. The `frontend-skills` tool installs them
+Other third-party frontend design skills such as Impeccable and Taste Skill are
+not vendored as bundled Custom Skills. The `frontend-skills` tool installs them
 externally through the Agent Skills CLI from pinned public sources.
 
 ## CLI Reference
@@ -369,6 +418,10 @@ Bundled third-party skills preserve upstream attribution and license files:
 | `react-patterns` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
 | `react-performance` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
 | `react-testing` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
+| `python-patterns` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
+| `python-testing` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
+| `kotlin-patterns` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
+| `kotlin-testing` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
 
 Releases use npm trusted publishing through GitHub Actions OIDC. The npm
 package is published without a long-lived npm token, and npm automatically
@@ -483,8 +536,8 @@ Release a new npm version by updating `package.json`, pushing the change to
 `main`, then pushing a matching tag:
 
 ```bash
-git tag v0.1.7
-git push origin v0.1.7
+git tag v0.1.9
+git push origin v0.1.9
 ```
 
 The `Release` workflow runs the full check and publishes the scoped package to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ranimontagna/agent-toolkit",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Personal AI agent toolkit installer for Claude Code, Codex CLI, OpenCode, Gemini CLI and graph-aware workflows.",
   "type": "module",
   "packageManager": "pnpm@11.0.6",

package/skills/backend/database/postgres-patterns/LICENSE.ANTIGRAVITY

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antigravity User
+
+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/skills/backend/database/postgres-patterns/LICENSE.ECC

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Affaan Mustafa
+
+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/skills/backend/database/postgres-patterns/NOTICE.md

@@ -0,0 +1,11 @@
+# Third-party notice
+
+This skill is adapted from two MIT-licensed community skills:
+
+- ECC postgres-patterns: https://github.com/affaan-m/ECC/tree/main/.kiro/skills/postgres-patterns
+- ECC source commit: 0f84c0e2796703fbda87d577b2636351418c7442
+- Antigravity postgresql: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/postgresql
+- Antigravity source commit: b806b97a9a48063f7bdbee5611caf40edd17e305
+
+The upstream MIT license texts are included in `LICENSE.ECC` and
+`LICENSE.ANTIGRAVITY`.

package/skills/backend/database/postgres-patterns/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: postgres-patterns
+description: Use when writing PostgreSQL queries or migrations, designing schemas, choosing data types, adding indexes, implementing RLS, tuning slow queries, reviewing DDL safety, or configuring production database behavior.
+metadata:
+  origin: ECC and antigravity-awesome-skills
+  credit: Supabase team, Affaan Mustafa, and Antigravity User
+---
+
+# PostgreSQL Patterns
+
+Quick reference for PostgreSQL best practices. For detailed guidance, use the `database-reviewer` agent.
+
+## When to Activate
+
+- Writing SQL queries or migrations
+- Designing database schemas
+- Troubleshooting slow queries
+- Implementing Row Level Security
+- Setting up connection pooling
+
+## Schema Review Guardrails
+
+Before changing DDL, capture entities, access patterns, expected row counts,
+QPS, retention, and migration constraints. Optimize for correctness first,
+then tune for measured hot paths.
+
+- Prefer `snake_case` unquoted identifiers.
+- Define primary keys where rows are referenced by other tables.
+- Prefer `bigint generated always as identity` for local IDs; use UUID only
+  when global uniqueness, opacity, or distributed creation is required.
+- Normalize first; denormalize only after measuring read bottlenecks.
+- Add `not null`, `check`, `unique`, and foreign key constraints to enforce
+  invariants in the database.
+- Index foreign keys manually. PostgreSQL does not auto-index FK columns.
+- Prefer `timestamptz` for event time and `numeric(p,s)` for money.
+- Prefer `text` plus optional `check (length(col) <= n)` over arbitrary
+  `varchar(n)`.
+- Use `jsonb` for optional or semi-structured attributes, not for relations
+  that need joins, constraints, or frequent filtering.
+- Validate important queries with `explain (analyze, buffers)` before adding
+  indexes or denormalized columns.
+
+## Quick Reference
+
+### Index Cheat Sheet
+
+| Query Pattern | Index Type | Example |
+|--------------|------------|---------|
+| `WHERE col = value` | B-tree (default) | `CREATE INDEX idx ON t (col)` |
+| `WHERE col > value` | B-tree | `CREATE INDEX idx ON t (col)` |
+| `WHERE a = x AND b > y` | Composite | `CREATE INDEX idx ON t (a, b)` |
+| `WHERE jsonb @> '{}'` | GIN | `CREATE INDEX idx ON t USING gin (col)` |
+| `WHERE tsv @@ query` | GIN | `CREATE INDEX idx ON t USING gin (col)` |
+| Time-series ranges | BRIN | `CREATE INDEX idx ON t USING brin (col)` |
+
+### Data Type Quick Reference
+
+| Use Case | Correct Type | Avoid |
+|----------|-------------|-------|
+| IDs | `bigint` | `int`, random UUID |
+| Strings | `text` | `varchar(255)` |
+| Timestamps | `timestamptz` | `timestamp` |
+| Money | `numeric(10,2)` | `float` |
+| Flags | `boolean` | `varchar`, `int` |
+
+### Common Patterns
+
+**Composite Index Order:**
+```sql
+-- Equality columns first, then range columns
+CREATE INDEX idx ON orders (status, created_at);
+-- Works for: WHERE status = 'pending' AND created_at > '2024-01-01'
+```
+
+**Covering Index:**
+```sql
+CREATE INDEX idx ON users (email) INCLUDE (name, created_at);
+-- Avoids table lookup for SELECT email, name, created_at
+```
+
+**Partial Index:**
+```sql
+CREATE INDEX idx ON users (email) WHERE deleted_at IS NULL;
+-- Smaller index, only includes active users
+```
+
+**RLS Policy (Optimized):**
+```sql
+CREATE POLICY policy ON orders
+  USING ((SELECT auth.uid()) = user_id);  -- Wrap in SELECT!
+```
+
+**UPSERT:**
+```sql
+INSERT INTO settings (user_id, key, value)
+VALUES (123, 'theme', 'dark')
+ON CONFLICT (user_id, key)
+DO UPDATE SET value = EXCLUDED.value;
+```
+
+**Cursor Pagination:**
+```sql
+SELECT * FROM products WHERE id > $last_id ORDER BY id LIMIT 20;
+-- O(1) vs OFFSET which is O(n)
+```
+
+**Queue Processing:**
+```sql
+UPDATE jobs SET status = 'processing'
+WHERE id = (
+  SELECT id FROM jobs WHERE status = 'pending'
+  ORDER BY created_at LIMIT 1
+  FOR UPDATE SKIP LOCKED
+) RETURNING *;
+```
+
+### Anti-Pattern Detection
+
+```sql
+-- Find unindexed foreign keys
+SELECT conrelid::regclass, a.attname
+FROM pg_constraint c
+JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = ANY(c.conkey)
+WHERE c.contype = 'f'
+  AND NOT EXISTS (
+    SELECT 1 FROM pg_index i
+    WHERE i.indrelid = c.conrelid AND a.attnum = ANY(i.indkey)
+  );
+
+-- Find slow queries
+SELECT query, mean_exec_time, calls
+FROM pg_stat_statements
+WHERE mean_exec_time > 100
+ORDER BY mean_exec_time DESC;
+
+-- Check table bloat
+SELECT relname, n_dead_tup, last_vacuum
+FROM pg_stat_user_tables
+WHERE n_dead_tup > 1000
+ORDER BY n_dead_tup DESC;
+```
+
+### Configuration Template
+
+```sql
+-- Connection limits (adjust for RAM)
+ALTER SYSTEM SET max_connections = 100;
+ALTER SYSTEM SET work_mem = '8MB';
+
+-- Timeouts
+ALTER SYSTEM SET idle_in_transaction_session_timeout = '30s';
+ALTER SYSTEM SET statement_timeout = '30s';
+
+-- Monitoring
+CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
+
+-- Security defaults
+REVOKE ALL ON SCHEMA public FROM public;
+
+SELECT pg_reload_conf();
+```
+
+## Related
+
+- Agent: `database-reviewer` - Full database review workflow
+- Skill: `backend-patterns` - API and backend patterns
+- Skill: `database-migrations` - Safe schema changes
+
+## When to Use This Skill
+
+- Writing SQL queries
+- Designing database schemas
+- Optimizing query performance
+- Implementing Row Level Security
+- Troubleshooting database issues
+- Setting up PostgreSQL configuration
+
+---
+
+*Based on Supabase Agent Skills (credit: Supabase team) (MIT License)*

package/skills/backend/kotlin/kotlin-patterns/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Affaan Mustafa
+
+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/skills/backend/kotlin/kotlin-patterns/NOTICE.md

@@ -0,0 +1,7 @@
+# Attribution
+
+This skill is adapted from `affaan-m/ECC`, `skills/kotlin-patterns`, commit `0f84c0e2796703fbda87d577b2636351418c7442`.
+
+Source: https://github.com/affaan-m/ECC/tree/main/skills/kotlin-patterns
+
+License: MIT. See `LICENSE`.