geekmidas-toolbox
GeekMidas toolbox — tier-1 always-on rules + tier-2 task-scoped skills.
Open source Open in the app JSON README (API)
About
GeekMidas toolbox — tier-1 always-on rules + tier-2 task-scoped skills.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- technanimals
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.4.0
- Last push
- 2026-05-13T07:37:16Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
technanimals/geekmidas-skills
README
# @geekmidas/toolbox
Agent skills for building with the GeekMidas toolbox — a TypeScript monorepo of type-safe packages for modern web applications.
Works across Claude Code, Cursor, Windsurf, Cline, GitHub Copilot, Codex, Gemini CLI, and 40+ other agents.
---
## Before / After
**Before (cold agent in a fresh worktree):**
> User: "Add a rate-limit middleware to the `/api/messages` endpoint."
>
> Agent: *writes a manual throttle function with a `Map`, doesn't link it to `@geekmidas/cache`, and finishes without checking the build.*
**After (geekmidas-toolbox installed):**
> User: same request.
>
> Agent: uses `.rateLimit(rateLimit({ ... }))` from `@geekmidas/rate-limit`, links `InMemoryCache` from `@geekmidas/cache`, runs `pnpm build && pnpm test && pnpm lint`, then: "About to commit to branch `rate-limit` targeting stage `dev` — confirm?"
---
## What You Get
**Tier 1 — always-on (injected every session):**
| Skill | Enforces |
|-------|----------|
| `gkm-standing-rules` | No silent deploy. Worktree context (branch + stage). Confirm before merge. |
| `gkm-build-test-lint-gate` | `pnpm build && pnpm test && pnpm lint` before "done". No `@ts-ignore`, no `.skip`, no `--no-verify`. |
**Tier 2 — task-scoped (activated by context):**
| Skill | Fires on |
|-------|----------|
| `gkm-constructs` | `@geekmidas/constructs` endpoint, function, cron, subscriber edits |
| `gkm-client` | `@geekmidas/client` typed query client and React Query hooks |
| `gkm-cli` | `@geekmidas/cli`, defineWorkspace, turbo.json, tsdown config |
| `gkm-envkit` | `@geekmidas/envkit`, EnvironmentParser, Zod env validation |
| `gkm-services` | `@geekmidas/services`, ServiceDiscovery, lazy service registration |
| `gkm-db` | `@geekmidas/db`, Kysely queries, withTransaction, migration files |
| `gkm-cache` | `@geekmidas/cache`, InMemoryCache, UpstashCache, cache.get/set |
| `gkm-storage` | `@geekmidas/storage`, AmazonStorageClient, presigned URLs, S3 |
| `gkm-events` | `@geekmidas/events`, Publisher, Subscriber, RabbitMQ/SQS/SNS |
| `gkm-auth` | `@geekmidas/auth`, TokenClient, JWT refresh, server-side validation |
| `gkm-errors` | `@geekmidas/errors`, createError factories, HTTP error classes |
| `gkm-rate-limit` | `@geekmidas/rate-limit`, sliding window limiter, .rateLimit() |
| `gkm-audit` | `@geekmidas/audit`, auditor.audit(), KyselyAuditStorage |
| `gkm-logger` | `@geekmidas/logger`, structured logging, child loggers |
| `gkm-testkit` | `@geekmidas/testkit`, KyselyFactory, test factories, transaction isolation |
| `gkm-telescope` | `@geekmidas/telescope`, debugging dashboard, API inspection |
| `gkm-studio` | `@geekmidas/studio`, database browser, Kysely schema explorer |
| `gkm-cloud` | `@geekmidas/cloud`, SST resources, stage-based infra config |
| `gkm-schema` | `@geekmidas/schema`, InferStandardSchema, StandardSchema type utils |
| `gkm-emailkit` | `@geekmidas/emailkit`, React email templates, SMTP client |
| `gkm-ui` | `@geekmidas/ui`, shadcn/ui components, Tailwind className patterns |
**Universal (always available):**
| Skill | Enforces |
|-------|----------|
| `code-quality` | DRY, SRP, early returns, no `any`, Zod at boundaries. |
| `naming-imports-exports` | camelCase/PascalCase/kebab-case, named exports, `~` alias. |
**Companion slash commands:**
| Command | Description |
|---------|-------------|
| `/gkm-help` | Quick-reference card for all skills |
| `/gkm-commit` | Gitmoji + Conventional Commits + branch/stage confirm |
| `/gkm-review` | Audit current diff against all skills |
---
## Install
Pick your agent. One command. Done.
| Agent | Install |
|-------|---------|
| **Claude Code** | `claude plugin marketplace add geekmidas/skills && claude plugin install geekmidas-toolbox@skills` |
| **Codex** | Clone repo → `.codex/hooks.json` auto-starts within the repo clone |
| **Gemini CLI** | `gemini extensions install https://github.com/geekmidas/skills` |
| **Cursor** | `npx skills add geekmidas/skills -a cursor` |
| **Windsurf** | `npx skills add geekmidas/skills -a windsurf` |
| **Copilot** | `npx skills add geekmidas/skills -a github-copilot` |
| **Cline** | `npx skills add geekmidas/skills -a cline` |
| **Any other** | `npx skills add geekmidas/skills` |
Install once. Use in every session after that.
These commands pull from GitHub (`geekmidas/skills`). The repository must be **public**.
### What You Get
| Feature | Claude Code | Codex | Gemini CLI | Cursor | Windsurf | Cline | Copilot |
|---------|:-----------:|:-----:|:----------:|:------:|:--------:|:-----:|:-------:|
| 28 skills (`skills/**`) | Y | Y | Y | Y | Y | Y | Y |
| Tier-1 rules auto-loaded every session | Y | Y¹ | Y | Y² | Y² | Y² | Y² |
| `/gkm-help`, `/gkm-review`, `/gkm-commit` slash commands | Y | — | Y | — | — | — | — |
| Statusline badge `[GKM: branch@stage]` | Y | — | — | — | — | — | — |
¹ Codex auto-starts via `.codex/hooks.json` only when run inside this repo's clone.
² Cursor/Windsurf/Cline/Copilot: rule files ship in the repo and ARE copied into the target project via `npx skills add`.
<details>
<summary><strong>Claude Code — full details</strong></summary>
The plugin install gives you all 28 skills + SessionStart hook + statusline.
```bash
claude plugin marketplace add geekmidas/skills
claude plugin install geekmidas-toolbox@skills
```
**Standalone hooks (without plugin system):**
```bash
# macOS / Linux / WSL
bash <(curl -s https://raw.githubusercontent.com/geekmidas/skills/main/hooks/install.sh)
# Windows (PowerShell)
irm https://raw.githubusercontent.com/geekmidas/skills/main/hooks/install.ps1 | iex
```
Uninstall: `claude plugin uninstall geekmidas-toolbox` or `bash hooks/uninstall.sh`
</details>
---
## Packages
The skills cover all packages in [@geekmidas/toolbox](https://github.com/geekmidas/toolbox):
**Framework:** `@geekmidas/constructs` · `@geekmidas/client` · `@geekmidas/cli`
**Data:** `@geekmidas/db` · `@geekmidas/cache` · `@geekmidas/storage` · `@geekmidas/events`
**Security:** `@geekmidas/auth` · `@geekmidas/errors` · `@geekmidas/rate-limit` · `@geekmidas/audit`
**Config:** `@geekmidas/envkit` · `@geekmidas/services` · `@geekmidas/schema`
**Tooling:** `@geekmidas/logger` · `@geekmidas/testkit` · `@geekmidas/telescope` · `@geekmidas/studio` · `@geekmidas/cloud`
**UI:** `@geekmidas/emailkit` · `@geekmidas/ui`
Documentation: [geekmidas.github.io/toolbox](https://geekmidas.github.io/toolbox)