madvil2/devkit

A knowledge base for Claude Code: agents, global rules, skills and a frontend rulebook, kept in one repository so they can be shared and improved. One command from a clone sets up Claude Code with all of it, or take only the files you need.
## What is inside
| Path | What it is |
| agents/ | Six agents: opus-context, opus-planner, opus-implementer, opus-checker, opus-critic, fable. Model, effort and the removed tools (edit tools for the read-only roles, Agent for the roles that must not launch subagents) live in each file's frontmatter. |
| global/CLAUDE.md | The global CLAUDE.md: rules for every session, covering roles, chains by task size, Fable triggers, review loops, skill use, hygiene. |
| frontend/ | The frontend rulebook: Next.js or Vite + React 19, CSS Modules with tiered tokens, TanStack, zustand, zod, Base UI. Every rule has a stable ID and a bracket naming the tool that enforces it. |
| skills/new-project/ | Scaffolds a frontend project from the rulebook: interview, freshness check, official CLI, templates, rendered AGENTS.md, verification. |
| skills/ | Matt Pocock's skills, vendored unchanged from mattpocock/skills, and Jakub Krehel's make-interfaces-feel-better from jakubkrehel/make-interfaces-feel-better. The lists and the upstream commits live in vendor.json. |
| hooks/ | A PreToolUse hook that runs the project's Biome check before git push and denies the push when it fails. install.mjs links the script and adds the settings hook. |
| scripts/install.mjs | The installer: links agents, scripts, the hook and skills into ~/.claude, imports global/CLAUDE.md, merges the settings template and installs the plugins. See Install. |
| install/ | The installer's data: settings.json (the settings template), bypass-permissions.json (added only with --bypass-permissions) and plugins.json (marketplaces, core and optional plugins). |
| scripts/statusline.sh | A two-line status line: folder, git branch, model and effort, then context and rate-limit bars and the session's diff size. Needs jq and git. |
| scripts/bounded.mjs | A time limit for waited commands where timeout and gtimeout are missing (stock macOS): it runs the command in its own process group, stops the whole group on timeout and exits 124. The flow rules call it as ~/.claude/scripts/bounded.mjs. |
| plugins/ | Three third-party Claude Code plugins, vendored unchanged from Millon15/cc-millz: security-audit, toolsmith, codex-delegation. Listed in the devkit marketplace; install the ones you want. |
## Install
Needs Node 20 or later, macOS or Linux, and jq (the status line and the Biome hook use it). From a clone:
bash
git clone https://github.com/madvil2/devkit.git
cd devkit
node scripts/install.mjs --dry-run
node scripts/install.mjs
Keep the clone where it is: everything is linked from it, so git pull updates every session. Run the installer again after a pull that adds agents or skills; a run with nothing to do changes nothing.
Flags:
--dry-run prints what would happen, prefixed would, and writes nothing.
--replace moves anything in the way into a backup and links the devkit file in its place. Without it, such files are reported as conflicts and left alone.