@ranimontagna/agent-toolkit 0.1.4 → 0.1.5

package/docs/assets/install-plan.svg

@@ -0,0 +1,29 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="980" height="560" viewBox="0 0 980 560" role="img" aria-labelledby="title desc">
+  <title id="title">Agent Toolkit install plan screen</title>
+  <desc id="desc">Terminal screenshot showing the final install plan before the installer asks for confirmation.</desc>
+  <rect width="980" height="560" rx="18" fill="#111827"/>
+  <rect x="24" y="24" width="932" height="512" 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">Ready to install</text>
+
+  <text x="52" y="104" fill="#93c5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="19" font-weight="700">Install plan</text>
+
+  <text x="74" y="144" fill="#cbd5e1" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Selected tools:</text>
+  <text x="96" y="174" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- RTK: rtk 0.42.1 already on PATH</text>
+  <text x="96" y="202" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Graphify: graphify 0.8.31 already on PATH</text>
+  <text x="96" y="230" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Custom Skills: 1 selected source skill</text>
+
+  <text x="74" y="282" fill="#cbd5e1" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Selected runtimes:</text>
+  <text x="96" y="312" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Codex CLI: installed</text>
+  <text x="96" y="340" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">- Gemini CLI: missing from PATH; selected runtime may be skipped</text>
+
+  <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>
+
+  <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>
+</svg>

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

@@ -0,0 +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>
+  <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="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>
+
+  <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>
+
+  <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>
+
+  <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>
+
+  <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="52" y="474" fill="#c4b5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">CLI equivalent: --skills-package core</text>
+</svg>

package/docs/assets/install-status.svg

@@ -0,0 +1,32 @@
+<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 detected status screen</title>
+  <desc id="desc">Terminal screenshot showing the installer detecting installed and missing tools before prompting for selections.</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">npx -y @ranimontagna/agent-toolkit</text>
+
+  <text x="52" y="104" fill="#93c5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="19" font-weight="700">Agent Toolkit</text>
+  <text x="52" y="134" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">Detected status</text>
+
+  <text x="74" y="174" fill="#cbd5e1" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Tools:</text>
+  <text x="96" y="204" fill="#86efac" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">[installed]</text>
+  <text x="205" y="204" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">RTK - rtk 0.42.1 (/home/user/.local/bin/rtk)</text>
+  <text x="96" y="232" fill="#fde68a" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">[external ]</text>
+  <text x="205" y="232" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Caveman - checked by the Caveman installer</text>
+  <text x="96" y="260" fill="#86efac" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">[installed]</text>
+  <text x="205" y="260" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Graphify - graphify 0.8.31</text>
+  <text x="96" y="288" fill="#93c5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">[available]</text>
+  <text x="205" y="288" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Custom Skills - 1 source skill package found</text>
+
+  <text x="74" y="336" fill="#cbd5e1" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Runtimes:</text>
+  <text x="96" y="366" fill="#86efac" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">[installed]</text>
+  <text x="205" y="366" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Codex CLI - codex 0.137.0</text>
+  <text x="96" y="394" fill="#fca5a5" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">[missing  ]</text>
+  <text x="205" y="394" fill="#e5e7eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Gemini CLI - missing from PATH</text>
+
+  <rect x="52" y="432" width="876" height="36" rx="8" fill="#111827" stroke="#334155"/>
+  <text x="70" y="456" fill="#c4b5fd" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">Next: select tools and runtimes. Nothing has been installed yet.</text>
+</svg>

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@ranimontagna/agent-toolkit",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "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",
   "bin": {
     "agent-toolkit": "dist/bin/agent-toolkit.js",
     "setup-agent-toolkit": "dist/bin/agent-toolkit.js"
   },
   "files": [
     "dist",
+    "docs/assets",
     "skills",
     "tools.lock.json",
     "setup-agent-toolkit.sh",
@@ -19,16 +21,15 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "check": "npm run lint && npm run typecheck && npm run test:unit && npm run build && find dist/bin dist/src -name '*.js' -print0 | xargs -0 -n1 node --check && bash -n setup-agent-toolkit.sh && npm run test:integration",
+    "check": "pnpm run lint && pnpm run typecheck && pnpm run test:unit && pnpm run build && find dist/bin dist/src -name '*.js' -print0 | xargs -0 -n1 node --check && bash -n setup-agent-toolkit.sh && pnpm run test:integration",
     "format": "biome format --write .",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
-    "prepare": "npm run build",
-    "security": "npm run security:audit && npm run security:signatures",
-    "security:audit": "npm audit --audit-level=moderate",
-    "security:signatures": "npm audit signatures",
-    "test": "npm run test:unit && npm run test:integration",
-    "test:integration": "npm run build && bash tests/test-agent-toolkit.sh",
+    "prepare": "pnpm run build",
+    "security": "pnpm run security:audit",
+    "security:audit": "pnpm audit --audit-level=moderate",
+    "test": "pnpm run test:unit && pnpm run test:integration",
+    "test:integration": "pnpm run build && bash tests/test-agent-toolkit.sh",
     "test:unit": "vitest run",
     "typecheck": "tsc -p tsconfig.test.json --noEmit"
   },
@@ -48,6 +49,6 @@
     "vitest": "^4.1.8"
   },
   "dependencies": {
-    "@clack/prompts": "^1.5.1"
+    "@clack/prompts": "^1.5.0"
   }
 }

package/setup-agent-toolkit.sh

@@ -13,7 +13,7 @@ CLI_ENTRYPOINT="$SCRIPT_DIR/dist/bin/agent-toolkit.js"
 
 if [[ ! -f "$CLI_ENTRYPOINT" ]]; then
   echo "Agent Toolkit build not found: dist/bin/agent-toolkit.js" >&2
-  echo "Run npm install && npm run build, then run this command again." >&2
+  echo "Run pnpm install && pnpm run build, then run this command again." >&2
   exit 1
 fi
 

package/skills/backend/fastify-best-practices/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matteo Collina
+
+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/fastify-best-practices/NOTICE.md

@@ -0,0 +1,11 @@
+# Attribution
+
+This skill is copied from Matteo Collina's public `mcollina/skills` repository.
+
+- Source: https://github.com/mcollina/skills/tree/main/skills/fastify
+- Imported from commit: `5b2a81354b6d10325da0db9decc9ce5ecc714138`
+- Upstream package name: `mcollina/fastify-best-practices`
+- License: MIT
+- Copyright: Copyright (c) 2026 Matteo Collina
+
+The upstream MIT license text is preserved in `LICENSE`.

package/skills/backend/fastify-best-practices/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: fastify-best-practices
+description: "Guides development of Fastify Node.js backend servers and REST APIs using TypeScript or JavaScript. Use when building, configuring, or debugging a Fastify application — including defining routes, implementing plugins, setting up JSON Schema validation, handling errors, optimising performance, managing authentication, configuring CORS and security headers, integrating databases, working with WebSockets, and deploying to production. Covers the full Fastify request lifecycle (hooks, serialization, logging with Pino) and TypeScript integration via strip types. Trigger terms: Fastify, Node.js server, REST API, API routes, backend framework, fastify.config, server.ts, app.ts."
+metadata:
+  tags: fastify, nodejs, typescript, backend, api, server, http
+---
+
+## When to use
+
+Use this skill when you need to:
+- Develop backend applications using Fastify
+- Implement Fastify plugins and route handlers
+- Get guidance on Fastify architecture and patterns
+- Use TypeScript with Fastify (strip types)
+- Implement testing with Fastify's inject method
+- Configure validation, serialization, and error handling
+
+## Quick Start
+
+A minimal, runnable Fastify server to get started immediately:
+
+```ts
+import Fastify from 'fastify'
+
+const app = Fastify({ logger: true })
+
+app.get('/health', async (request, reply) => {
+  return { status: 'ok' }
+})
+
+const start = async () => {
+  await app.listen({ port: 3000, host: '0.0.0.0' })
+}
+start()
+```
+
+## Recommended Reading Order for Common Scenarios
+
+- **New to Fastify?** Start with `plugins.md` → `routes.md` → `schemas.md`
+- **Adding authentication:** `plugins.md` → `hooks.md` → `authentication.md`
+- **Improving performance:** `schemas.md` → `serialization.md` → `performance.md`
+- **Setting up testing:** `routes.md` → `testing.md`
+- **Going to production:** `logging.md` → `configuration.md` → `deployment.md`
+
+## How to use
+
+Read individual rule files for detailed explanations and code examples:
+
+- [rules/plugins.md](rules/plugins.md) - Plugin development and encapsulation
+- [rules/routes.md](rules/routes.md) - Route organization and handlers
+- [rules/schemas.md](rules/schemas.md) - JSON Schema validation
+- [rules/error-handling.md](rules/error-handling.md) - Error handling patterns
+- [rules/hooks.md](rules/hooks.md) - Hooks and request lifecycle
+- [rules/authentication.md](rules/authentication.md) - Authentication and authorization
+- [rules/testing.md](rules/testing.md) - Testing with inject()
+- [rules/performance.md](rules/performance.md) - Performance optimization
+- [rules/logging.md](rules/logging.md) - Logging with Pino
+- [rules/typescript.md](rules/typescript.md) - TypeScript integration
+- [rules/decorators.md](rules/decorators.md) - Decorators and extensions
+- [rules/content-type.md](rules/content-type.md) - Content type parsing
+- [rules/serialization.md](rules/serialization.md) - Response serialization
+- [rules/cors-security.md](rules/cors-security.md) - CORS and security headers
+- [rules/websockets.md](rules/websockets.md) - WebSocket support
+- [rules/database.md](rules/database.md) - Database integration patterns
+- [rules/configuration.md](rules/configuration.md) - Application configuration
+- [rules/deployment.md](rules/deployment.md) - Production deployment
+- [rules/http-proxy.md](rules/http-proxy.md) - HTTP proxying and reply.from()
+
+## Core Principles
+
+- **Encapsulation**: Fastify's plugin system provides automatic encapsulation
+- **Schema-first**: Define schemas for validation and serialization
+- **Performance**: Fastify is optimized for speed; use its features correctly
+- **Async/await**: All handlers and hooks support async functions
+- **Minimal dependencies**: Prefer Fastify's built-in features and official plugins