@ranimontagna/agent-toolkit 0.1.1

package/setup-agent-toolkit.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js 22+ is required to run Agent Toolkit." >&2
+  echo "Install Node.js, then run this command again." >&2
+  exit 1
+fi
+
+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
+  exit 1
+fi
+
+exec node "$CLI_ENTRYPOINT" "$@"

package/skills/core/agent-toolkit-maintainer/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: agent-toolkit-maintainer
+description: Use when modifying, publishing, or validating the Agent Toolkit installer, bundled personal skills, runtime support, README, or public-safe repository hygiene.
+---
+
+# Agent Toolkit Maintainer
+
+Use this skill when working in the Agent Toolkit repository.
+
+## Priorities
+
+- Keep the repository public-safe: no internal company names, private URLs, tokens, or credentials.
+- Keep the installer focused on Claude Code, Codex CLI, OpenCode and Gemini CLI.
+- Keep bundled skills organized by scope under `skills/<scope>/<skill-name>/SKILL.md`.
+- Keep third-party skills out of `skills/`; install them through CLI-backed tool installers.
+- Install skills flat into runtime skill directories using the skill directory name.
+- Prefer configurable sources over hard-coded local paths.
+- Keep external tool defaults pinned in `tools.lock.json`; do not reintroduce mutable defaults like `@latest`.
+- Use `rtk` for shell commands when the local project instructions require it.
+- Use Conventional Commits for repository commits.
+
+## Installer Changes
+
+When changing `bin/agent-toolkit.ts`, `src/**/*.ts` or `setup-agent-toolkit.sh`:
+
+1. Add or update focused Vitest tests in `tests/unit/` for pure module behavior.
+2. Add or update behavior tests in `tests/test-agent-toolkit.sh` for installer flows.
+3. Keep `bin/agent-toolkit.ts` as a thin entrypoint into `src/main.ts`.
+4. Keep each install concern in a focused module under `src/installers/`.
+5. Keep TypeScript imports using `.js` extensions so compiled ESM works in Node.
+6. Keep the published runtime CLI dependency-free unless there is a strong reason to add a production package.
+7. Keep `package.json` bin entries pointed at `dist/bin/agent-toolkit.js`.
+8. Preserve non-interactive flags for automation.
+9. Keep interactive runs explicit: the user should select tools, runtimes and skill scopes.
+10. Keep external source provenance checks active unless an explicit override is documented.
+11. Do not make runtime support claims unless the install path is implemented.
+12. Run TypeScript build/typecheck, Biome, Vitest and the integration test before claiming completion.
+13. Run lint and tests before every commit.
+
+## Skill Changes
+
+When adding a personal skill:
+
+1. Create `skills/<scope>/<skill-name>/SKILL.md`.
+2. Use concise YAML frontmatter with `name` and `description`.
+3. Keep `SKILL.md` procedural and short.
+4. Move large examples or detailed references into `references/`.
+5. Do not add README or changelog files inside a skill directory.
+
+When adding third-party skills, add a dedicated installer or extend an existing
+external-skill installer, pin sources in `tools.lock.json`, and document the
+license/source in README.
+
+## Verification
+
+Run:
+
+```bash
+rtk npm run check
+rtk npm run security
+rtk npm run lint
+rtk npm run build
+rtk npm run typecheck
+rtk npm run test:unit
+rtk npm run test:integration
+rtk rg -n "private-company-or-old-tooling-pattern" .
+rtk graphify update .
+```

package/tools.lock.json

@@ -0,0 +1,84 @@
+{
+  "version": 1,
+  "tools": {
+    "rtk": {
+      "source": "github-release",
+      "repository": "rtk-ai/rtk",
+      "tag": "v0.42.1",
+      "assets": {
+        "rtk-aarch64-apple-darwin.tar.gz": {
+          "sha256": "401d72a80c0efc597ae9469f053ce51c70334ea427527464ab76f8e298da2447"
+        },
+        "rtk-aarch64-unknown-linux-gnu.tar.gz": {
+          "sha256": "32f4d78766e2f5b43756efce3c699dc4da8beef5296deb02fa7756f3257eb25c"
+        },
+        "rtk-x86_64-apple-darwin.tar.gz": {
+          "sha256": "6165d80f40db0f46f8af2ea15d0132e957e2717aa74507906c7ce5b3c20c655e"
+        },
+        "rtk-x86_64-pc-windows-msvc.zip": {
+          "sha256": "5f292b031595405671b41e29aa5016931e8598949c25d9751f0eebd2eccefe0b"
+        },
+        "rtk-x86_64-unknown-linux-musl.tar.gz": {
+          "sha256": "a37ca300a42510a964453f2bc2e217769ef0872780af802db8a7d698f1da2465"
+        }
+      }
+    },
+    "caveman": {
+      "source": "github",
+      "repository": "JuliusBrussee/caveman",
+      "ref": "655b7d9c5431f822264b7732e9901c5578ac84cf"
+    },
+    "graphify": {
+      "source": "pypi",
+      "package": "graphifyy",
+      "version": "0.8.31"
+    },
+    "gsd": {
+      "source": "npm",
+      "package": "get-shit-done-cc",
+      "version": "1.42.3"
+    },
+    "frontendSkills": {
+      "source": "skills-cli",
+      "skillsCli": {
+        "source": "npm",
+        "package": "skills",
+        "version": "1.5.10"
+      },
+      "impeccable": {
+        "source": "github",
+        "repository": "pbakaus/impeccable",
+        "ref": "1d5d745823aae7019044e8b0a621af4366dae224",
+        "skill": "impeccable"
+      },
+      "tasteSkill": {
+        "source": "github",
+        "repository": "Leonxlnx/taste-skill",
+        "ref": "3c7017d636c3a4aad378433ea6d0cfa6c921da4a",
+        "skill": "design-taste-frontend"
+      }
+    }
+  },
+  "runtimeClis": {
+    "claude": {
+      "source": "npm",
+      "package": "@anthropic-ai/claude-code",
+      "version": "2.1.162"
+    },
+    "codex": {
+      "source": "npm",
+      "package": "@openai/codex",
+      "version": "0.137.0"
+    },
+    "opencode": {
+      "source": "npm",
+      "package": "opencode-ai",
+      "version": "1.15.13"
+    },
+    "gemini": {
+      "source": "npm",
+      "package": "@google/gemini-cli",
+      "version": "0.45.0"
+    }
+  }
+}