{"id":51324720,"url":"https://github.com/webdevtodayjason/dev-kit","last_synced_at":"2026-07-01T17:03:52.065Z","repository":{"id":361686505,"uuid":"1255396591","full_name":"webdevtodayjason/dev-kit","owner":"webdevtodayjason","description":"Portable Claude Code dev workflow — skills, commands, agents, security hooks, and a CLAUDE.md template. One-install onboarding; ships zero credentials.","archived":false,"fork":false,"pushed_at":"2026-05-31T20:40:55.000Z","size":176,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T21:20:41.475Z","etag":null,"topics":["agent-skills","ai-tools","anthropic","claude","claude-code","claude-code-marketplace","claude-code-plugin","claude-plugin","developer-tools","onboarding"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webdevtodayjason.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-31T19:23:30.000Z","updated_at":"2026-05-31T20:40:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/webdevtodayjason/dev-kit","commit_stats":null,"previous_names":["webdevtodayjason/dev-kit"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/webdevtodayjason/dev-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fdev-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fdev-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fdev-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fdev-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webdevtodayjason","download_url":"https://codeload.github.com/webdevtodayjason/dev-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fdev-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35015061,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-tools","anthropic","claude","claude-code","claude-code-marketplace","claude-code-plugin","claude-plugin","developer-tools","onboarding"],"created_at":"2026-07-01T17:03:51.211Z","updated_at":"2026-07-01T17:03:52.053Z","avatar_url":"https://github.com/webdevtodayjason.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dev-kit — a portable Claude Code workflow\n\nA one-install Claude Code marketplace plugin that sets up a complete development\nworkflow: skills, slash commands, sub-agents, output styles, optional security\nhooks, and a fill-in `CLAUDE.md` template.\n\n**Ships zero credentials.** No API keys, no private infrastructure, no machine-specific\npaths. You bring your own MCP keys and choose your own permission posture.\n\n---\n\n## ⚡ Quick setup — paste this to your agent\n\nHand this to your Claude Code session (or any coding / cloud agent) and it will set\neverything up, interviewing you only where it needs your specifics:\n\n```text\nYou're setting up the \"dev-kit\" Claude Code marketplace plugin on my machine.\nWork through these steps in order, asking me only when you genuinely need input:\n\n1. INSTALL: run `/plugin marketplace add webdevtodayjason/dev-kit`, then\n   `/plugin install dev-kit@jason`, then tell me to restart Claude Code so the\n   skills, commands, agents, and the context7 MCP register.\n\n2. PREREQS (report what's missing; don't install anything without asking first):\n   - node / npx  -\u003e needed for the keyless context7 docs MCP\n   - uv          -\u003e needed only for the optional damage-control security hooks\n   - gh CLI (authenticated) -\u003e needed for the review/commit workflows and find-docs\n\n3. CLAUDE.md: copy `plugins/dev-kit/CLAUDE.template.md` to `~/.claude/CLAUDE.md`\n   (or this project's `./CLAUDE.md`). Then interview me briefly to fill every\n   \u003cPLACEHOLDER\u003e (my name, machine/resources, where my secrets live, current\n   projects, my follow-up-list file path). Delete any section whose tooling I\n   have not installed.\n\n4. CONSERVATIVE PERMISSIONS: in `~/.claude/settings.local.json`, add a deny list\n   for catastrophic commands (rm -rf /*, rm -rf ~/*, sudo rm -rf, mkfs,\n   dd ... of=/dev/*) and an ask list (git push --force, git reset --hard).\n   Do NOT enable bypassPermissions, CLAUDE_AUTONOMY, or any skip-prompt flags.\n\n5. MCP CREDENTIALS (mine only — never reuse anyone else's): context7 works\n   keyless out of the box. If I use Linear or ghost.build, walk me through adding\n   them with MY own key / login.\n\n6. OPTIONAL SECURITY HOOKS: if I want the damage-control PreToolUse firewall,\n   confirm uv is installed, then run the damage-control skill's install cookbook.\n\n7. VERIFY: run `/context-audit` and confirm the new skills and commands appear.\n\nNever write secrets into a committed file. Confirm each step's result before\nmoving to the next.\n```\n\n---\n\n## Install (manual)\n\n```text\n/plugin marketplace add webdevtodayjason/dev-kit\n/plugin install dev-kit@jason\n```\n\nThen **restart Claude Code** so skills, commands, agents, output styles, and the\ncontext7 MCP register.\n\n### Prerequisites (install these yourself first)\n\n| Tool | Needed for | Install |\n|---|---|---|\n| **Node / npx** | the keyless `context7` docs MCP | comes with Node.js |\n| **`uv`** | the optional `damage-control` security hooks (Python) | `brew install uv` |\n| **`gh` CLI (authed)** | the review/commit workflows + `find-docs` | `brew install gh \u0026\u0026 gh auth login` |\n| **`tmux`** | only if you later add team/orchestrator panes | `brew install tmux` |\n\nNone are required just to install — the skills and commands work without them; the\ntable notes what each *specific* feature needs.\n\n---\n\n## After install — 3 things to do\n\n### 1. Adopt the CLAUDE.md template\nOpen `plugins/dev-kit/CLAUDE.template.md` (from this repo, or from the installed\nplugin directory under `~/.claude/plugins/`) and copy it to your global or project\nconfig:\n```bash\ncp plugins/dev-kit/CLAUDE.template.md ~/.claude/CLAUDE.md   # or a project ./CLAUDE.md\n```\nThen replace every `\u003cPLACEHOLDER\u003e` (your name, environment, secrets location,\nfollow-up file path, etc.) and **delete any section whose tooling you haven't installed.**\n\n### 2. Choose a permission posture (start conservative)\nThis kit deliberately ships **no `settings.json`**. Set your own — and **do not**\ncopy a \"full bypass\" setup. Recommended starting point in `~/.claude/settings.local.json`:\n```jsonc\n{\n  \"permissions\": {\n    \"deny\": [\n      \"Bash(rm -rf /*)\", \"Bash(rm -rf ~/*)\", \"Bash(sudo rm -rf:*)\",\n      \"Bash(mkfs:*)\", \"Bash(dd if=* of=/dev/*)\"\n    ],\n    \"ask\": [ \"Bash(git push --force:*)\", \"Bash(git reset --hard:*)\" ]\n  }\n}\n```\nLeave `defaultMode` at the prompting default (or at most `acceptEdits`). **Do not** set\n`CLAUDE_AUTONOMY`, `skipDangerousModePermissionPrompt`, or `skipAutoPermissionPrompt`\nuntil you've deliberately decided you want them — they disable safety prompts and\nneuter the deny/ask rules above.\n\n### 3. Bring your own MCP credentials\n- **context7** (docs lookup) — ships **keyless and works out of the box**. Optionally add your own `CONTEXT7_API_KEY` for higher rate limits.\n- **Linear** — add the public server with *your own* key/OAuth (not bundled).\n- **ghost.build** — install the current `ghost` CLI yourself and run `ghost login` for your own account (not bundled).\n- **llm-council skill** — set `OPENAI_API_KEY` / `GEMINI_API_KEY` in your own `.env` (the shipped `.env.template` has only placeholders).\n\n---\n\n## Optional: enable the damage-control security hooks\nThe `damage-control` skill ships with a self-contained PreToolUse firewall (blocks\ndestructive shell commands and writes to credential paths). It's **not auto-wired** so\nit can't break your tool calls on day one. To turn it on, install `uv`, then run the\n`damage-control` skill and follow its install cookbook.\n\n---\n\n## What's included\n\n- **Skills (24):** `tdd`, `diagnose`, `find-docs`, `write-a-skill`, `to-issues`, `to-prd`,\n  `triage`, `code-review`-style review workflows, `grill-me`, `grill-with-docs`,\n  `improve-codebase-architecture`, `context-audit`, `caveman`, `zoom-out`,\n  `setup-matt-pocock-skills`, `damage-control`, `followup-closet`, `obsidian-vault`,\n  `ghost-db`, `llm-council`, `prod-db-surgical`, `spec-driven-dev`, and\n  `node` / `python` / `rust` conventions.\n- **Commands:** `/code-review`, `/ai-slop-cleaner`, `/security-review`, `/commit`, `/geo-optimize`.\n- **Agents:** `bug-analyzer`, `code-reviewer`, `dev-planner`, `story-generator`, `ui-sketcher`.\n- **Output styles:** `coding-vibes`, `structural-thinking`.\n- **MCP:** `context7` (keyless docs lookup).\n- **`CLAUDE.template.md`:** fill-in operating instructions.\n- **Statusline:** `plugins/dev-kit/statusline/statusline.sh` — a clean Claude Code status bar (project · branch · model · context % · tokens).\n- **Terminal preset:** `plugins/dev-kit/terminal/starship.toml` + **`TERMINAL-SETUP.md`** — iTerm2 + Nerd Font + Starship, with an AI handoff prompt.\n\n## What's intentionally NOT included\nAnything machine-specific or private: orchestration tooling, secret managers,\npersonal infrastructure, business-project specifics, and **any credentials**. Bring\nyour own keys and your own conventions where they differ.\n\n---\n\n## Companion guides\n- **[ONBOARDING.md](ONBOARDING.md)** — full macOS new-dev walkthrough (install Claude → paste-to-agent setup of the whole toolchain).\n- **[TERMINAL-SETUP.md](TERMINAL-SETUP.md)** — iTerm2 + Nerd Font + Starship + the Claude statusline, with an AI handoff prompt.\n- **[STACK.md](STACK.md)** — the companion plugins (claude-mem, CodeRabbit, Codex, Ralph Wiggum) + MCPs (Linear, ghost) that complete the workflow, with exact install commands.\n\n---\n\nBuilt by **Jason Brashear** — [jasonbrashear.com](https://jasonbrashear.com) · [Substack](https://jasonbrashear.substack.com) · [GitHub @webdevtodayjason](https://github.com/webdevtodayjason)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fdev-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebdevtodayjason%2Fdev-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fdev-kit/lists"}