@ranimontagna/agent-toolkit 0.1.7 → 0.1.10

package/dist/src/usage.js

@@ -39,6 +39,7 @@ Install scope:
   --skills-dir DIR      Use another source directory for Custom Skills
   --skills-package NAME Install Custom Skills from a first-level package, repeatable
   --skills-scope SCOPE  Install skills under a relative scope path, repeatable
+  --skills-path PATH    Install exact Custom Skill path, repeatable
   --skills-list         List discovered Custom Skills and exit
 
 Other:
@@ -61,6 +62,7 @@ Environment:
   CUSTOM_SKILLS_DIR     Source directory for custom skills
   SKILLS_PACKAGE        Comma-separated first-level skill package filters
   SKILLS_SCOPE          Comma-separated skill scope filters
+  SKILLS_PATH           Comma-separated exact skill path filters
   CLAUDE_CLI_PACKAGE    npm package used to install Claude Code CLI
   CODEX_CLI_PACKAGE     npm package used to install Codex CLI
   OPENCODE_CLI_PACKAGE  npm package used to install OpenCode CLI

package/dist/src/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/usage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK;IACnB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAiEsD,CAAC;AAChE,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/usage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK;IACnB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAmEsD,CAAC;AAChE,CAAC"}

package/docs/assets/install-plan.svg

@@ -21,8 +21,8 @@
 
   <text x="74" y="392" fill="#cbd5e1" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Custom Skills:</text>
   <text x="96" y="422" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Selected packages: core</text>
-  <text x="96" y="450" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Selected source skills: core/agent-toolkit-maintainer</text>
-  <text x="96" y="478" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Codex CLI: 0/1 already present at ~/.codex/skills; 1 will be copied</text>
+  <text x="96" y="450" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Selected individual skills: core/agent-toolkit-maintainer</text>
+  <text x="96" y="478" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Selected source skills: core/agent-toolkit-maintainer</text>
 
   <rect x="52" y="506" width="876" height="36" rx="8" fill="#111827" stroke="#334155"/>
   <text x="70" y="530" fill="#86efac" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Continue with installation? Yes</text>

package/docs/assets/install-skill-packages.svg

@@ -1,31 +1,31 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="980" height="520" viewBox="0 0 980 520" role="img" aria-labelledby="title desc">
-  <title id="title">Agent Toolkit Custom Skill package selection screen</title>
-  <desc id="desc">Terminal screenshot showing selectable Custom Skill packages in the Clack installer.</desc>
+  <title id="title">Agent Toolkit Custom Skill selection screen</title>
+  <desc id="desc">Terminal screenshot showing selectable individual Custom Skills in the Clack installer.</desc>
   <rect width="980" height="520" rx="18" fill="#111827"/>
   <rect x="24" y="24" width="932" height="472" rx="14" fill="#0b1020" stroke="#263247"/>
   <circle cx="52" cy="52" r="7" fill="#ff5f57"/>
   <circle cx="76" cy="52" r="7" fill="#ffbd2e"/>
   <circle cx="100" cy="52" r="7" fill="#28c840"/>
-  <text x="126" y="57" fill="#9ca3af" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="14">Custom Skills package selection</text>
+  <text x="126" y="57" fill="#9ca3af" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="14">Custom Skills granular selection</text>
 
-  <text x="52" y="104" fill="#93c5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="19" font-weight="700">Select Custom Skill packages</text>
-  <text x="52" y="138" fill="#cbd5e1" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Space toggles a package. Enter confirms the selection.</text>
+  <text x="52" y="104" fill="#93c5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="19" font-weight="700">Select individual Custom Skills</text>
+  <text x="52" y="138" fill="#cbd5e1" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">After package and scope filters, choose exact skills or keep all selected.</text>
 
   <rect x="72" y="172" width="836" height="56" rx="10" fill="#172033" stroke="#3b82f6"/>
-  <text x="96" y="207" fill="#bfdbfe" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">(*) All skill packages</text>
-  <text x="388" y="207" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">install every bundled package</text>
+  <text x="96" y="207" fill="#bfdbfe" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">(*) All selected skills</text>
+  <text x="388" y="207" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">keep the current package/scope result</text>
 
   <rect x="72" y="244" width="836" height="56" rx="10" fill="#111827" stroke="#334155"/>
-  <text x="96" y="279" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">( ) core</text>
-  <text x="238" y="279" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">agent-toolkit-maintainer and repository workflow skills</text>
+  <text x="96" y="279" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">( ) backend/python/python-patterns</text>
+  <text x="458" y="279" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Pythonic design patterns</text>
 
   <rect x="72" y="316" width="836" height="56" rx="10" fill="#111827" stroke="#334155" opacity="0.72"/>
-  <text x="96" y="351" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">( ) backend</text>
-  <text x="266" y="351" fill="#64748b" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">appears automatically when skills/backend exists</text>
+  <text x="96" y="351" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">(*) backend/python/python-testing</text>
+  <text x="458" y="351" fill="#64748b" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">pytest fixtures, mocking and coverage</text>
 
   <rect x="72" y="388" width="836" height="56" rx="10" fill="#111827" stroke="#334155" opacity="0.72"/>
-  <text x="96" y="423" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">( ) frontend</text>
-  <text x="278" y="423" fill="#64748b" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">appears automatically when skills/frontend exists</text>
+  <text x="96" y="423" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">( ) backend/kotlin/kotlin-testing</text>
+  <text x="466" y="423" fill="#64748b" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Kotest, MockK and coroutine testing</text>
 
-  <text x="52" y="474" fill="#c4b5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">CLI equivalent: --skills-package core</text>
+  <text x="52" y="474" fill="#c4b5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">CLI equivalent: --skills-path backend/python/python-testing</text>
 </svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ranimontagna/agent-toolkit",
-  "version": "0.1.7",
+  "version": "0.1.10",
   "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`.