@ranimontagna/agent-toolkit 0.1.17 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ranimontagna/agent-toolkit",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Personal AI agent toolkit installer for Claude Code, Codex CLI, OpenCode, Gemini CLI, Antigravity and graph-aware workflows.",
   "type": "module",
   "packageManager": "pnpm@11.8.0",
@@ -14,7 +14,10 @@
     "skills",
     "tools.lock.json",
     "setup-agent-toolkit.sh",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -26,6 +29,9 @@
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "prepare": "pnpm run build",
+    "release:major": "pnpm run build && node dist/src/release.js major",
+    "release:minor": "pnpm run build && node dist/src/release.js minor",
+    "release:patch": "pnpm run build && node dist/src/release.js patch",
     "security": "pnpm run security:audit",
     "security:audit": "pnpm audit --audit-level=moderate",
     "test": "pnpm run test:unit && pnpm run test:integration",
@@ -43,12 +49,12 @@
   "homepage": "https://github.com/raniellimontagna/agent-toolkit#readme",
   "license": "MIT",
   "devDependencies": {
-    "@biomejs/biome": "^2.5.0",
-    "@types/node": "^25.9.3",
+    "@biomejs/biome": "^2.5.1",
+    "@types/node": "^26.0.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.9"
   },
   "dependencies": {
-    "@clack/prompts": "^1.5.1"
+    "@clack/prompts": "^1.6.0"
   }
 }

package/skills/backend/api/api-design/NOTICE.md

@@ -1,6 +1,6 @@
 # Attribution
 
-This skill is adapted from `affaan-m/ECC`, `skills/api-design`, commit `0f84c0e2796703fbda87d577b2636351418c7442`.
+This skill is adapted from `affaan-m/ECC`, `skills/api-design`, commit `2bc924faf2f8e893bfe0af86b1931283693c30ae`.
 
 Source: https://github.com/affaan-m/ECC/tree/main/skills/api-design
 

package/skills/backend/api/api-design/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: api-design
 description: Use when designing, reviewing, or implementing REST APIs, including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting.
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # API Design Patterns

package/skills/backend/go/golang-patterns/NOTICE.md

@@ -3,7 +3,7 @@
 This skill was copied from Affaan Mustafa's ECC repository.
 
 - Source: https://github.com/affaan-m/ECC/tree/main/skills/golang-patterns
-- Source commit: 0f84c0e2796703fbda87d577b2636351418c7442
+- Source commit: 2bc924faf2f8e893bfe0af86b1931283693c30ae
 - License: MIT
 - Copyright: Copyright (c) 2026 Affaan Mustafa
 

package/skills/backend/go/golang-patterns/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: golang-patterns
 description: Use when writing, reviewing, or refactoring Go applications and applying idiomatic patterns, conventions, concurrency, error handling, package design, and maintainability practices.
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # Go Development Patterns

package/skills/backend/java/java-coding-standards/NOTICE.md

@@ -3,7 +3,7 @@
 This skill was copied from Affaan Mustafa's ECC repository.
 
 - Source: https://github.com/affaan-m/ECC/tree/main/skills/java-coding-standards
-- Source commit: 0f84c0e2796703fbda87d577b2636351418c7442
+- Source commit: 2bc924faf2f8e893bfe0af86b1931283693c30ae
 - License: MIT
 - Copyright: Copyright (c) 2026 Affaan Mustafa
 

package/skills/backend/java/java-coding-standards/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: java-coding-standards
 description: "Use when writing or reviewing Java 17+ code in Spring Boot or Quarkus services, including naming, immutability, Optional usage, streams, exceptions, generics, CDI, reactive patterns, and project layout."
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # Java Coding Standards

package/skills/backend/kotlin/kotlin-patterns/NOTICE.md

@@ -1,6 +1,6 @@
 # Attribution
 
-This skill is adapted from `affaan-m/ECC`, `skills/kotlin-patterns`, commit `0f84c0e2796703fbda87d577b2636351418c7442`.
+This skill is adapted from `affaan-m/ECC`, `skills/kotlin-patterns`, commit `2bc924faf2f8e893bfe0af86b1931283693c30ae`.
 
 Source: https://github.com/affaan-m/ECC/tree/main/skills/kotlin-patterns
 

package/skills/backend/kotlin/kotlin-patterns/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: kotlin-patterns
 description: Use when writing, reviewing, or refactoring Kotlin applications with coroutines, null safety, immutability, sealed types, extension functions, DSL builders, and Gradle Kotlin DSL.
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # Kotlin Development Patterns

package/skills/backend/kotlin/kotlin-testing/NOTICE.md

@@ -1,6 +1,6 @@
 # Attribution
 
-This skill is adapted from `affaan-m/ECC`, `skills/kotlin-testing`, commit `0f84c0e2796703fbda87d577b2636351418c7442`.
+This skill is adapted from `affaan-m/ECC`, `skills/kotlin-testing`, commit `2bc924faf2f8e893bfe0af86b1931283693c30ae`.
 
 Source: https://github.com/affaan-m/ECC/tree/main/skills/kotlin-testing
 

package/skills/backend/kotlin/kotlin-testing/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: kotlin-testing
 description: Use when writing or improving Kotlin tests with Kotest, MockK, coroutine testing, property-based testing, Ktor testApplication, Kover coverage, or TDD workflows.
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # Kotlin Testing Patterns

package/skills/frontend/accessibility/NOTICE.md

@@ -3,7 +3,7 @@
 This skill was copied from Affaan Mustafa's ECC repository.
 
 - Source: https://github.com/affaan-m/ECC/tree/main/skills/accessibility
-- Source commit: 0f84c0e2796703fbda87d577b2636351418c7442
+- Source commit: 2bc924faf2f8e893bfe0af86b1931283693c30ae
 - License: MIT
 - Copyright: Copyright (c) 2026 Affaan Mustafa
 

package/skills/frontend/accessibility/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: accessibility
 description: Use when designing, implementing, or auditing accessible web, iOS, or Android interfaces against WCAG 2.2 Level AA, semantic HTML, ARIA, keyboard navigation, focus management, and native accessibility traits.
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # Accessibility (WCAG 2.2)

package/skills/frontend/astro/astro-developer/NOTICE.md

@@ -1,6 +1,6 @@
 # Attribution
 
-This skill is copied from the official Astro repository, `.agents/skills/astro-developer`, commit `c90ce9751c7862a7280e752549ef74298669693d`.
+This skill is copied from the official Astro repository, `.agents/skills/astro-developer`, commit `e37dfe2a7623acd364d7e3556ecc9b31e3e45520`.
 
 Source: https://github.com/withastro/astro/tree/main/.agents/skills/astro-developer
 

package/skills/frontend/astro/astro-developer/SKILL.md

@@ -127,6 +127,6 @@ See [testing.md](testing.md) for complete patterns and examples.
 
 - Root: [/AGENTS.md](https://github.com/withastro/astro/blob/main/AGENTS.md)
 - Root: [/CONTRIBUTING.md](https://github.com/withastro/astro/blob/main/CONTRIBUTING.md)
-- Astro docs: https://docs.astro.build/llms.txt
+- Astro docs: https://docs.astro.build/
 - Package: packages/astro/src/core/README.md
 - Build plugins: packages/astro/src/core/build/plugins/README.md

package/skills/frontend/astro/astro-developer/debugging.md

@@ -336,7 +336,7 @@ HMR testing requires a browser. **Do not use `curl`** for HMR issues.
 
 ```bash
 # Start dev server in background
-pnpm exec bgproc start -n devserver --wait-for-port 10 -- pnpm -C examples/minimal dev
+pnpm -C examples/minimal dev --background
 
 # Open browser
 agent-browser open http://localhost:4321
@@ -348,10 +348,10 @@ agent-browser snapshot -i
 # Verify HMR updates the page
 
 # View logs
-pnpm exec bgproc logs -n devserver
+pnpm -C examples/minimal dev logs
 
 # Cleanup
-pnpm exec bgproc stop -n devserver
+pnpm -C examples/minimal dev stop
 ```
 
 ### Check HMR Boundaries
@@ -471,11 +471,11 @@ See [testing.md](testing.md) for comprehensive test debugging.
 **Fix:**
 
 ```bash
-# List running processes
-pnpm exec bgproc list
+# Check dev server status
+pnpm -C examples/minimal dev status
 
-# Stop specific server
-pnpm exec bgproc stop -n devserver
+# Stop dev server
+pnpm -C examples/minimal dev stop
 
 # Kill all node processes (nuclear option)
 killall node

package/skills/frontend/design/ui-ux-pro-max/NOTICE.md

@@ -3,7 +3,7 @@
 This skill was copied from Next Level Builder's UI/UX Pro Max Skill repository.
 
 - Source: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/tree/main/.claude/skills/ui-ux-pro-max
-- Source commit: b7e3af80f6e331f6fb456667b82b12cade7c9d35
+- Source commit: 8a81ed60272d21d4b8808f7308d49a0b1b000555
 - License: MIT
 - Copyright: Copyright (c) 2024 Next Level Builder
 

package/skills/frontend/design/ui-ux-pro-max/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ui-ux-pro-max
-description: Use when designing, implementing, reviewing, or improving UI/UX for web or mobile products, including layout, style, color, typography, accessibility, interaction states, responsive behavior, dashboards, landing pages, SaaS, e-commerce, portfolios, and app interfaces.
+description: "UI/UX design intelligence for web and mobile. Includes 50+ styles, 161 color palettes, 57 font pairings, 161 product types, 99 UX guidelines, and 25 chart types across 10 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, and HTML/CSS). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, and check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, and mobile app. Elements: button, modal, navbar, sidebar, card, table, form, and chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, and flat design. Topics: color systems, accessibility, animation, layout, typography, font pairing, spacing, interaction states, shadow, and gradient. Integrations: shadcn/ui MCP for component search and examples."
 ---
 
 # UI/UX Pro Max - Design Intelligence
@@ -330,6 +330,8 @@ sudo apt update && sudo apt install python3
 winget install Python.Python.3.12
 ```
 
+> **Note:** On Windows, use `python` instead of `python3` to run scripts (e.g., `python scripts/search.py` instead of `python3 scripts/search.py`).
+
 ---
 
 ## How to Use This Skill
@@ -360,7 +362,7 @@ Extract key information from user request:
 - **Product type**: Entertainment (social, video, music, gaming), Tool (scanner, editor, converter), Productivity (task manager, notes, calendar), or hybrid
 - **Target audience**: C-end consumer users; consider age group, usage context (commute, leisure, work)
 - **Style keywords**: playful, vibrant, minimal, dark mode, content-first, immersive, etc.
-- **Stack**: Detect the project stack first, then use the matching stack search when available
+- **Stack**: Match the project's framework. The engine ships guidance for many stacks (see [Available Stacks](#available-stacks) below) — pass the matching `--stack` (e.g. `nextjs`, `react`, `shadcn`, `vue`, `svelte`, `astro`, `swiftui`, `flutter`, `react-native`).
 
 ### Step 2: Generate Design System (REQUIRED)
 
@@ -440,12 +442,14 @@ python3 scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
 | App interface a11y | `web` | `--domain web "accessibilityLabel touch safe-areas"` |
 | AI prompt / CSS keywords | `prompt` | `--domain prompt "minimalism"` |
 
-### Step 4: Stack Guidelines
+### Step 4: Stack Guidelines (match your framework)
 
-Get implementation-specific best practices for the detected stack:
+Get implementation-specific best practices for the stack you're building in.
+Pass the `--stack` that matches the project's framework:
 
 ```bash
-python3 scripts/search.py "<keyword>" --stack react
+python3 scripts/search.py "<keyword>" --stack <your-stack>
+# e.g. --stack nextjs | react | shadcn | vue | svelte | astro | swiftui | flutter | react-native
 ```
 
 ---
@@ -470,18 +474,26 @@ python3 scripts/search.py "<keyword>" --stack react
 
 ### Available Stacks
 
+Run `ls <skill>/data/stacks/` to see the live set. Shipped stacks:
+
 | Stack | Focus |
 |-------|-------|
-| `react` | Components, state, rendering, accessibility |
-| `nextjs` | App Router, server/client boundaries, routing |
-| `vue` | Components and composition patterns |
-| `svelte` | Components and reactivity patterns |
-| `astro` | Content and island architecture |
-| `swiftui` | iOS-native UI structure |
-| `react-native` | Components, navigation, lists |
-| `flutter` | Widgets, theming, navigation |
-| `html-tailwind` | Utility-first HTML/CSS |
-| `shadcn` | Radix/shadcn UI composition |
+| `react` | Components, hooks, render performance |
+| `nextjs` | App Router, RSC, Server Actions, rendering |
+| `vue` | Components, Composition API, reactivity |
+| `nuxtjs` | Nuxt app patterns, SSR data fetching |
+| `nuxt-ui` | Nuxt UI component patterns |
+| `svelte` | Components, stores, transitions |
+| `astro` | Islands, content, partial hydration |
+| `shadcn` | shadcn/ui primitives, composition |
+| `html-tailwind` | Tailwind utility patterns |
+| `angular` | Components, signals, services |
+| `laravel` | Blade / server-rendered UI patterns |
+| `swiftui` | Views, state, navigation (iOS/macOS) |
+| `flutter` | Widgets, state, navigation |
+| `jetpack-compose` | Composables, state, navigation (Android) |
+| `react-native` | Components, Navigation, Lists |
+| `threejs` | 3D scenes, materials, performance |
 
 ---
 
@@ -493,7 +505,7 @@ python3 scripts/search.py "<keyword>" --stack react
 - Product type: Tool (AI search engine)
 - Target audience: C-end users looking for fast, intelligent search
 - Style keywords: modern, minimal, content-first, dark mode
-- Stack: detected from the target project
+- Stack: Next.js (a homepage is a web surface; use a web `--stack`)
 
 ### Step 2: Generate Design System (REQUIRED)
 
@@ -516,7 +528,7 @@ python3 scripts/search.py "search loading animation" --domain ux
 ### Step 4: Stack Guidelines
 
 ```bash
-python3 scripts/search.py "list performance navigation" --stack react
+python3 scripts/search.py "list performance navigation" --stack nextjs
 ```
 
 **Then:** Synthesize design system + detailed searches and implement the design.
@@ -544,7 +556,7 @@ python3 scripts/search.py "fintech crypto" --design-system -f markdown
 - Use **multi-dimensional keywords** — combine product + industry + tone + density: `"entertainment social vibrant content-dense"` not just `"app"`
 - Try different keywords for the same need: `"playful neon"` → `"vibrant dark"` → `"content-first minimal"`
 - Use `--design-system` first for full recommendations, then `--domain` to deep-dive any dimension you're unsure about
-- Add the matching `--stack` option for implementation-specific guidance
+- Add the `--stack` that matches the project's framework for implementation-specific guidance
 
 ### Common Sticking Points
 

package/skills/frontend/react/react-patterns/NOTICE.md

@@ -3,7 +3,7 @@
 This skill is copied from Affaan Mustafa's public `affaan-m/ECC` repository.
 
 - Source: https://github.com/affaan-m/ECC/tree/main/skills/react-patterns
-- Imported from commit: `0f84c0e2796703fbda87d577b2636351418c7442`
+- Imported from commit: `2bc924faf2f8e893bfe0af86b1931283693c30ae`
 - Upstream skill name: `react-patterns`
 - License: MIT
 - Copyright: Copyright (c) 2026 Affaan Mustafa

package/skills/frontend/react/react-patterns/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: react-patterns
 description: React 18/19 patterns including hooks discipline, server/client component boundaries, Suspense + error boundaries, form actions, data fetching, state management decision trees, and accessibility-first composition. Use when writing or reviewing React components.
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # React Patterns

package/skills/frontend/react/react-performance/NOTICE.md

@@ -3,7 +3,7 @@
 This skill is copied from Affaan Mustafa's public `affaan-m/ECC` repository.
 
 - Source: https://github.com/affaan-m/ECC/tree/main/skills/react-performance
-- Imported from commit: `0f84c0e2796703fbda87d577b2636351418c7442`
+- Imported from commit: `2bc924faf2f8e893bfe0af86b1931283693c30ae`
 - Upstream skill name: `react-performance`
 - License: MIT
 - Copyright: Copyright (c) 2026 Affaan Mustafa

package/skills/frontend/react/react-performance/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: react-performance
 description: React and Next.js performance optimization patterns adapted from Vercel Engineering's React Best Practices (https://github.com/vercel-labs/agent-skills). Organizes 70+ rules across 8 priority categories — waterfalls, bundle size, server-side, client fetching, re-render, rendering, JS micro-perf, advanced. Use when writing, reviewing, or refactoring React/Next.js code for performance.
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # React Performance

package/skills/frontend/react/react-testing/NOTICE.md

@@ -3,7 +3,7 @@
 This skill is copied from Affaan Mustafa's public `affaan-m/ECC` repository.
 
 - Source: https://github.com/affaan-m/ECC/tree/main/skills/react-testing
-- Imported from commit: `0f84c0e2796703fbda87d577b2636351418c7442`
+- Imported from commit: `2bc924faf2f8e893bfe0af86b1931283693c30ae`
 - Upstream skill name: `react-testing`
 - License: MIT
 - Copyright: Copyright (c) 2026 Affaan Mustafa

package/skills/frontend/react/react-testing/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: react-testing
 description: React component testing with React Testing Library, Vitest/Jest, MSW for network mocking, accessibility assertions with axe, and the decision boundary between component tests and Playwright/Cypress end-to-end runs. Use when writing or fixing tests for React components, hooks, or pages.
-origin: ECC
+metadata:
+  origin: ECC
 ---
 
 # React Testing

package/skills/general/code-reviewer/AGENTS.md

@@ -11,7 +11,7 @@
 2. [XSS Prevention](#xss-prevention)
 
 ### Performance — **HIGH**
-3. [Avoid N+1 Query Problem](#avoid-n-1-query-problem)
+3. [Avoid N+1 Query Problem](#avoid-n1-query-problem)
 
 ### Correctness — **HIGH**
 4. [Proper Error Handling](#proper-error-handling)

package/skills/general/code-reviewer/NOTICE.md

@@ -3,7 +3,7 @@
 This skill was copied from Shubhamsaboo's awesome-llm-apps repository.
 
 - Source: https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/awesome_agent_skills/code-reviewer
-- Source commit: 72718ec759ecc82ead7666fd47922928b61c2b4d
+- Source commit: ca3a3d37438643fd47b1dac095c2ce9cca92ef72
 - Repository license: Apache-2.0
 - Upstream skill metadata also declares: MIT
 

package/skills/general/thermo-nuclear-code-quality-review/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+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/general/thermo-nuclear-code-quality-review/NOTICE.md

@@ -0,0 +1,12 @@
+# Attribution
+
+This skill is copied from Cursor's public `cursor/plugins` repository.
+
+- Source: https://github.com/cursor/plugins/tree/main/cursor-team-kit/skills/thermo-nuclear-code-quality-review
+- Imported from commit: `e46364b8be46000b7df0f260550cd712afbb8d36`
+- Upstream plugin: `cursor-team-kit`
+- Upstream skill name: `thermo-nuclear-code-quality-review`
+- License: MIT
+- Copyright: Copyright (c) 2026 Cursor
+
+The upstream MIT license text is preserved in `LICENSE`.