better-chatbot Conventions — project standards for the better-chatbot AI chat platform

Prerequisites: a local clone of the better-chatbot repository (github.com/cgoinglove/better-chatbot) or an intent to contribute to it — Node.js, PostgreSQL, and the stack's dependencies; familiarity with Next.js App Router and the Vercel AI SDK Install "better-chatbot Conventions — project standards for the better-chatbot AI chat platform" for me. It gives my agent @jackspace's better-chatbot contribution skill (standards by Jeremy Dawes / Jezweb): the project's architecture and directory conventions, API route structure, the three-tier tool system (MCP, Workflow, Default), server action validators with the safe() wrapper, database repository patterns, compound component design, DAG workflow builder internals, and Playwright E2E setup — with templates for adding tools, API routes, and repositories. IMPORTANT: this skill is project-specific — it only applies inside the better-chatbot repository. MIT licensed. Repository: https://github.com/jackspace/claudeskillz/blob/main/skills/better-chatbot/SKILL.md 1. Fetch the SKILL.md file (and any helper files) from the repository path into a temporary folder and summarize what it does in one or two sentences. 2. Safety check: review the SKILL.md and scripts for anything suspicious (unexpected network calls, shell commands, credential harvesting). This repo should contain zero secrets in code. Verify that holds here; STOP on any red flag and tell me. 3. Install it as a skill: copy SKILL.md and its helper files into the agent's skills directory, in a folder named "better-chatbot". 4. Verify with no network calls: frontmatter valid, files in place. 5. Report what was installed, where, and what I still need to do myself (e.g. clone the better-chatbot repo and install its dependencies; confirm the current dependency versions match the skill's 2025-11-04 snapshot). GitHub is optional: if I have a GitHub account or the gh CLI, you may use it; otherwise public access is fine. Never require it unless it's in the prerequisites above. Rules: don't touch anything outside the temp folder and the install target. If anything looks off, stop and ask me.