@ranimontagna/agent-toolkit 0.1.18 → 0.1.20

package/README.md

@@ -210,6 +210,10 @@ skills/
         debugging.md
         testing.md
     design/
+      revenue-centric-design/
+        SKILL.md
+        assets/
+        references/
       ui-ux-pro-max/
         SKILL.md
         data/
@@ -356,6 +360,7 @@ Follow these steps...
 | `devops` | `docker-patterns` | Adapted from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/.kiro/skills/docker-patterns) and [`sickn33/antigravity-awesome-skills`](https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/docker-expert), both under the MIT license |
 | `frontend` | `accessibility` | Copied from Affaan Mustafa's [`ECC`](https://github.com/affaan-m/ECC/tree/main/skills/accessibility) under the MIT license |
 | `frontend` | `astro-developer` | Copied from the official [`withastro/astro`](https://github.com/withastro/astro/tree/main/.agents/skills/astro-developer) repository under the MIT license |
+| `frontend` | `revenue-centric-design` | Copied from Helio Costa's [`revenue-centric-design`](https://github.com/heliocosta-dev/revenue-centric-design) under source-available custom terms requiring attribution and excluding gambling/betting/casino use |
 | `frontend` | `ui-ux-pro-max` | Copied from Next Level Builder's [`ui-ux-pro-max-skill`](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/tree/main/.claude/skills/ui-ux-pro-max) under the MIT license |
 | `frontend` | `gsap-core` | Copied from GreenSock's [`gsap-skills`](https://github.com/greensock/gsap-skills/tree/main/skills/gsap-core) under the MIT license |
 | `frontend` | `gsap-frameworks` | Copied from GreenSock's [`gsap-skills`](https://github.com/greensock/gsap-skills/tree/main/skills/gsap-frameworks) under the MIT license |
@@ -482,15 +487,15 @@ Defaults come from `tools.lock.json`:
 
 ```text
 CAVEMAN_PACKAGE=github:JuliusBrussee/caveman#25d22f864ad68cc447a4cb93aefde918aa4aec9f
-GRAPHIFY_PACKAGE=graphifyy==0.8.41
+GRAPHIFY_PACKAGE=graphifyy==0.8.51
 GRAPHIFY_INSTALLER=uv
 GSD_PACKAGE=get-shit-done-cc@1.42.3
-SKILLS_CLI_PACKAGE=skills@1.5.11
+SKILLS_CLI_PACKAGE=skills@1.5.13
 ANTIGRAVITY_INSTALL_SCRIPT=https://antigravity.google/cli/install.sh
-CLAUDE_CLI_PACKAGE=@anthropic-ai/claude-code@2.1.181
-CODEX_CLI_PACKAGE=@openai/codex@0.141.0
-OPENCODE_CLI_PACKAGE=opencode-ai@1.17.8
-GEMINI_CLI_PACKAGE=@google/gemini-cli@0.47.0
+CLAUDE_CLI_PACKAGE=@anthropic-ai/claude-code@2.1.195
+CODEX_CLI_PACKAGE=@openai/codex@0.142.3
+OPENCODE_CLI_PACKAGE=opencode-ai@1.17.11
+GEMINI_CLI_PACKAGE=@google/gemini-cli@0.49.0
 ```
 
 Mutable overrides like `@latest`, unpinned npm packages or GitHub package
@@ -516,31 +521,31 @@ Current external sources:
 
 | Tool | Locked source | Runtime verification |
 |---|---|---|
-| RTK | GitHub release `rtk-ai/rtk@v0.42.4` | Verifies the selected asset SHA-256 before extraction |
+| RTK | GitHub release `rtk-ai/rtk@v0.43.0` | Verifies the selected asset SHA-256 before extraction |
 | Caveman | `JuliusBrussee/caveman` at commit `25d22f864ad68cc447a4cb93aefde918aa4aec9f` | Immutable GitHub npm spec |
-| Graphify | `graphifyy==0.8.41` | Blocks unpinned package overrides |
+| Graphify | `graphifyy==0.8.51` | Blocks unpinned package overrides |
 | GSD | `get-shit-done-cc@1.42.3` | Blocks `@latest` unless explicitly allowed |
 | Improve | `shadcn/improve` at commit `03369ee6d7cafbfcecc4346539b05b3dc0a603bb` | Clones the pinned ref before Agent Skills CLI install |
-| Frontend Skills | `skills@1.5.11`, `pbakaus/impeccable` and `Leonxlnx/taste-skill` at pinned commits | Clones pinned refs before install |
+| Frontend Skills | `skills@1.5.13`, `pbakaus/impeccable` and `Leonxlnx/taste-skill` at pinned commits | Clones pinned refs before install |
 | Runtime CLIs | Exact npm versions for Claude, Codex, OpenCode and Gemini | Installed or updated only when `--install-missing-clis` is enabled; Antigravity uses the official `agy` installer instead of npm |
 
 Bundled third-party skills preserve upstream attribution and license files:
 
 | Skill | Source commit | License |
 |---|---|---|
-| `api-design` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
+| `api-design` | `affaan-m/ECC@2bc924faf2f8e893bfe0af86b1931283693c30ae` | MIT |
 | `fastify-best-practices` | `mcollina/skills@5b2a81354b6d10325da0db9decc9ce5ecc714138` | MIT |
-| `astro-developer` | `withastro/astro@c90ce9751c7862a7280e752549ef74298669693d` | MIT |
+| `astro-developer` | `withastro/astro@e37dfe2a7623acd364d7e3556ecc9b31e3e45520` | MIT |
 | `gsap-*` | `greensock/gsap-skills@aed9cfd3277740755f6bfc1155c7aa645403b760` | MIT |
 | `react-native-expert` | `Jeffallan/claude-skills@e8be415bc94d8d6ebddc2fb50e5d03c6e27d4319` | MIT |
 | `react-native-unistyles-v3` | `jpudysz/react-native-unistyles@8b5e9fd281a81bdfd87d4fe9e6a0b042c84c5c83` | MIT |
-| `react-patterns` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
-| `react-performance` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
-| `react-testing` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
+| `react-patterns` | `affaan-m/ECC@2bc924faf2f8e893bfe0af86b1931283693c30ae` | MIT |
+| `react-performance` | `affaan-m/ECC@2bc924faf2f8e893bfe0af86b1931283693c30ae` | MIT |
+| `react-testing` | `affaan-m/ECC@2bc924faf2f8e893bfe0af86b1931283693c30ae` | MIT |
 | `python-patterns` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
 | `python-testing` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
-| `kotlin-patterns` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
-| `kotlin-testing` | `affaan-m/ECC@0f84c0e2796703fbda87d577b2636351418c7442` | MIT |
+| `kotlin-patterns` | `affaan-m/ECC@2bc924faf2f8e893bfe0af86b1931283693c30ae` | MIT |
+| `kotlin-testing` | `affaan-m/ECC@2bc924faf2f8e893bfe0af86b1931283693c30ae` | MIT |
 
 Releases use npm trusted publishing through GitHub Actions OIDC. The npm
 package is published without a long-lived npm token, and npm automatically
@@ -661,8 +666,8 @@ Release a new npm version by updating `package.json`, pushing the change to
 `main`, then pushing a matching tag:
 
 ```bash
-git tag v0.1.18
-git push origin v0.1.18
+git tag v0.1.20
+git push origin v0.1.20
 ```
 
 For normal releases, prefer the scripted flow. It bumps `package.json`, updates

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ranimontagna/agent-toolkit",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "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",
@@ -49,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/revenue-centric-design/LICENSE

@@ -0,0 +1,30 @@
+Revenue-Centric Design Skill — License & Usage Terms
+Copyright (c) 2026 the curators of this repository.
+
+The underlying ideas, frameworks, examples, and the coined term "Revenue-Centric
+Design" are the intellectual property of Richard (@richardrx on X) and are used
+here WITH PERMISSION. This repository is a distilled, translated index of his
+public posts, shared for educational and reference use.
+
+You are granted permission to use, copy, and share this material, subject to ALL
+of the following conditions:
+
+1. ATTRIBUTION. You must retain clear attribution to Richard (@richardrx) and a
+   link to the source. Do not misrepresent the origin of these ideas.
+
+2. NO GAMBLING / BETTING / CASINO USE. You may NOT use this material — in whole
+   or in part — to design, build, optimize, market, or grow betting, casino,
+   gambling, or other real-money games-of-chance products or projects (including
+   loot-box and real-money-gaming mechanics). This restriction was set by the
+   original author as an explicit condition of reuse and MUST be preserved in any
+   copy or derivative.
+
+3. PRESERVE THESE TERMS. Any copy or derivative work must include this license in
+   full, including the restrictions above.
+
+4. NO WARRANTY. This material is provided "AS IS", without warranty of any kind,
+   express or implied. The curators and the original author are not liable for any
+   claim, damages, or other liability arising from its use.
+
+Note: Because of the field-of-use restriction in clause 2, this is a
+SOURCE-AVAILABLE license, not an OSI-approved open-source license.

package/skills/frontend/design/revenue-centric-design/NOTICE.md

@@ -0,0 +1,12 @@
+# Third-party notice
+
+This skill was copied from Helio Costa's Revenue-Centric Design repository.
+
+- Source: https://github.com/heliocosta-dev/revenue-centric-design
+- Source commit: 6fa20cb4f91fa97bce9197be3f78b168784eb772
+- License: Source-available custom terms; attribution required, no gambling/betting/casino use
+- Copyright: Copyright (c) 2026 the curators of the source repository
+
+The upstream `updater/` maintenance tooling was intentionally not vendored.
+The runtime skill files, references, and referenced assets are included. The
+upstream license is included in `LICENSE`.

package/skills/frontend/design/revenue-centric-design/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: revenue-centric-design
+description: "Playbook for SaaS and startup product design that improves conversion, activation, retention, pricing, positioning, GTM, monetization, and AI-era differentiation. Use for product UX, landing pages, onboarding, trials, churn, pricing, growth, or positioning. Not for gambling, betting, or casino products."
+---
+
+# Revenue-Centric Design
+
+A distilled playbook of **101 principles** from **Richard ([@richardrx](https://x.com/richardrx), "Design for startups")** —
+a product designer specializing in conversion-rate optimization, churn reduction, and applied
+behavioral science (ex-Volkswagen, PayPal, IBM). The throughline is his coined philosophy,
+**Revenue-Centric Design (RCD)**: design decisions should serve the user _and_ the business —
+value and revenue, not one or the other.
+
+Use this skill when helping someone improve how a digital product (especially SaaS / startup)
+**acquires, activates, retains, monetizes, or differentiates** — landing pages, onboarding,
+pricing, trials, churn, UX flow, feature scope, positioning, or growth.
+
+## Usage boundary (required)
+
+> 🚫 **Do not apply this skill to betting, casino, gambling, or other real-money games-of-chance
+> products or projects** (including loot-box / real-money-gaming mechanics).
+
+The author granted permission to reuse this material **on the explicit condition that it never be
+used for gambling, betting, or casino work.** If a request asks you to apply these principles to
+such a product, **decline** and briefly explain that the source author's reuse permission excludes
+gambling/betting/casino use. This is a hard constraint set by the author, not a stylistic choice.
+
+## How to use it
+
+1. Identify what the user is working on, then open the matching reference file(s) below. Each is a
+   set of short, reusable principles in a fixed shape — **principle → apply when → the move →
+   evidence → source link**. Load only what's relevant (progressive disclosure).
+2. Ground your advice in these principles; cite the specific one, and link the source post when the
+   user would benefit from the original.
+3. Lead with the **named mechanism** (e.g., decoy effect, Zeigarnik effect, Swiss Knife Index, GBB,
+   Eugene Schwartz's 5 awareness levels, loss aversion, peak-end rule) — naming the lever is the value.
+4. Stay evidence-led: many principles carry a study, stat, or case. Keep the citation attached
+   rather than hand-waving.
+
+## The spine: Revenue-Centric Design in 9 principles
+
+1. **Neutrality is omission** — an interface that doesn't direct hurts conversion.
+2. **Who talks to everyone convinces no one** — no ICP → generic value → worse retention.
+3. **Value first, ask later** — proof must arrive before the user questions their choice.
+4. **Your promise is the size of your proof** — the market believes what you demonstrate, not what you claim.
+5. **Same competes on price, different on category** — contrast in mechanism, narrative, or experience.
+6. **Default is the decision you made for the user** — the initial state defines mass behavior.
+7. **Retention is built, not requested** — perceived loss retains more than promised benefit.
+8. **Expansion is born of usage** — upgrade at the moment of the limit, never by interruption.
+9. **Price is a filter** — pricing defines who enters, who stays, and who expands.
+
+## Reference library
+
+| When the question is about…                                                   | Open                                                                         |
+| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| Landing pages, hero/copy, CTAs, social proof, awareness levels, CRO           | [conversion-and-landing-pages](references/conversion-and-landing-pages.md)   |
+| First-run, empty states, aha moment, TTV, activation, trial-as-onboarding     | [onboarding-and-activation](references/onboarding-and-activation.md)         |
+| Cancellation, retention, expectation debt, NRR, jobs-to-be-done, support load | [churn-and-retention](references/churn-and-retention.md)                     |
+| Pricing tables, decoy/anchoring, GBB, trial-with-card, upgrade paths          | [pricing-and-monetization](references/pricing-and-monetization.md)           |
+| Cognitive biases & persuasion tactics (cross-cutting toolkit)                 | [behavioral-science-toolkit](references/behavioral-science-toolkit.md)       |
+| Feature scope, Swiss Knife Index, feature adoption, attention hierarchy       | [product-strategy-and-features](references/product-strategy-and-features.md) |
+| Design philosophy, the RCD principles, design process & method                | [revenue-centric-design](references/revenue-centric-design.md)               |
+| ICP, niche, founder-fit, distribution, PLG, Bullseye, first customers         | [positioning-icp-and-gtm](references/positioning-icp-and-gtm.md)             |
+| Differentiating in the AI era, moats, commoditization                         | [ai-era-differentiation](references/ai-era-differentiation.md)               |
+| A/B testing rigor, vanity metrics, churn→LTV math, signal quality             | [metrics-and-experimentation](references/metrics-and-experimentation.md)     |
+
+Informational diagrams and screenshots referenced by the principles live in `assets/`.
+
+## Provenance
+
+101 curated posts by [@richardrx](https://x.com/richardrx), extracted with a valid X API key and
+distilled **with the author's permission**, translated from Portuguese to English. Every principle
+links back to its source post. Reuse is subject to the gambling/betting/casino exclusion above.