By max4c
General building skills for Claude Code — grill-me, write-prd, tdd, and more. Project-agnostic skills for turning ideas into verified code. Inspired by Matt Pocock's skills and the Ouroboros specification-first workflow.
Auto-grill a plan, spec, or ticket by running Claude and Codex as interrogator/answerer pairs instead of interviewing the user. Two modes — relay (iterative back-and-forth between Claude and Codex) and parallel (two swapped streams merged into one spec). Produces a pre-chewed artifact where the user only reviews the result, not sits through the interview. Use this skill whenever the user says "cookoff", "pre-grill this", "have codex grill it", "dual grill", "grill this without me", "run grill-me with codex", "cross-examine this plan", or wants the ambiguity-resolution work done autonomously before they review. Also use when the user has a plan/spec/PRD that would normally go through max:grill-me but explicitly wants to skip being interviewed themselves. Supports `--to-tickets` to emit the grilled spec as Dahso Agent Tickets ready for `/go`, and `--to-tickets --go` to chain straight to `dahso:go` without a review pause.
Explore multiple radically different interface designs for a feature in parallel before committing to one. Uses parallel sub-agents to generate distinct approaches so you can compare tradeoffs rather than anchoring on the first idea. For UI/UX interface work specifically — not API interface design. Use when the user says "design-interface", "let's explore some designs for X", "what are the options for this screen", or before building any non-trivial UI.
Interview the user relentlessly about a plan, spec, or ticket until every branch of the decision tree is resolved. Produces a per-dimension ambiguity report (Goals / Acceptance / Boundaries / Alternatives / Assumptions) and an aggregate gate. Use this skill whenever the user is drafting a spec, proposing a design, debating an approach, or describing work to hand off — even if they don't say "grill me". Explicit triggers include "grill me", "stress-test this", "am I missing anything", "what are the risks", or any time a non-trivial plan is being finalized. Also invoked as a subroutine by max:write-prd Phase 5, max:tech-spec Phase 6, max:improve-codebase Phase 5, bugbook:flow Phase 2d, bugbook:prep Phase 3, and bugbook:ticket Phase 2d.
A grilling session that stress-tests a plan against the project's documented domain model — sharpens fuzzy terminology, challenges it against the existing glossary, cross-references it with the code, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallize. The domain-aware variant of grill-me — use this instead when the repo has (or should have) a CONTEXT.md glossary or docs/adr/ decision records. Triggers include "grill with docs", "stress-test this against our domain model", "does this match our language", "check this against our glossary", "grill this and update the docs", or any time a non-trivial plan needs to be reconciled with the project's documented decisions.
Compact the current conversation into a handoff document so a fresh agent can pick up the work without re-deriving context. Writes a self-contained brief to the OS temp directory — what's been done, what's left, key decisions, gotchas, and which skills to invoke next. Use when the user says "handoff", "write a handoff", "hand this off", "compact this for a new session", "summarize this for another agent", "I'm running low on context", or is about to start a fresh session on the same work. Takes an optional argument describing what the next session will focus on.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
General building skills for Claude Code — project-agnostic skills for turning ideas into verified code.
Inspired by Matt Pocock's skills, the Ouroboros specification-first workflow, and the Superpowers plugin.
| Skill | What it does |
|---|---|
grill-me | Interview the user relentlessly about a plan, spec, or ticket. Produces a per-dimension ambiguity report and gate. |
grill-with-docs | Domain-aware grilling — stress-tests a plan against the project's CONTEXT.md glossary and ADRs, sharpens terminology, cross-references the code, and updates those docs inline as decisions land. |
cookoff | Auto-grill a plan, spec, or ticket by running Claude and Codex as interrogator/answerer pairs — relay (iterative) or parallel (two swapped streams merged). User reviews the pre-chewed result instead of sitting through the interview. Requires the openai-codex plugin. |
write-prd | Turn a vague idea into a grounded PRD. Codebase exploration, Socratic interview, grill gate before exit. |
tdd | Test-driven development with red-green-refactor discipline and vertical-slice tracer bullets. Includes "when NOT to TDD" for UI code. |
tech-spec | Turn a PRD into a technical implementation spec. Module decomposition with deep-module emphasis, tracer-bullet sequencing, grill gate. |
verify-before-done | Three-level evidence rubric (Mechanical / Behavioral / Consensus) for proving work is done before claiming it is. Red flag dictionary for false success claims. |
improve-codebase | Architectural review that produces proposals, not commits. Deep-module detection + four-persona pass (Contrarian / Simplifier / Architect / Hacker). |
design-interface | Parallel exploration of UI/UX designs along explicit dimension axes. Spawns multiple distinct design corners to avoid anchoring. |
handoff | Compact the current conversation into a self-contained handoff document in the OS temp dir, so a fresh agent can resume the work — state, decisions, gotchas, next steps, and suggested skills. |
release-plugin | Ship a Claude Code plugin update — detect plugin, bump version, update CHANGELOG, stage surgically, commit, push, merge to default branch via worktree. Encodes the version-bump discipline that makes /plugin update actually land. |
/plugin marketplace add max4c/skills
/plugin install max@max4c-skills
/plugin marketplace add max4c/bugbook
/plugin install bugbook@max4c-bugbook
/plugin install max@max4c-bugbook
The max4c/bugbook marketplace bundles both plugins. Installing max alongside bugbook unlocks active spec grilling and ambiguity scoring inside Bugbook's /flow, /prep, and /ticket workflows.
The install commands use
plugin@marketplace-nameformat. The marketplace names (max4c-skillsandmax4c-bugbook) come from thenamefield in each repo's.claude-plugin/marketplace.jsonorplugin.json.
These skills compose with each other and with caller plugins:
caller → write-prd → grill-me → ambiguity report → return PRD
↓
(grill-me is reusable as a subroutine)
Callers (including bugbook:flow) pre-load context into the conversation, invoke max:write-prd, and post-process the output for persistence. write-prd never reaches into external systems directly — it produces markdown; the caller decides where it goes.
This is a personal skill library. Issues and PRs welcome, but the bar for accepting changes is "does this match how I work" rather than "is this a general improvement". If you want a different style, fork it.
MIT. See LICENSE.
npx claudepluginhub max4c/skills --plugin maxHelder's personal SDLC toolbelt for AI coding agents — from PRD to ship. Bundles the tracer-bullet workflow alongside TDD, code review, audits, and shipping skills.
Provider-agnostic skills for autonomous product development: spec, task, implement, test, review, and summarize changes.
No description provided.
Focused agentic engineering workflow: design-doc, spec, plan, implement, tdd, refactor, review, address-pr-feedback, browser-verify, explain-visually, compress, branch, and commit.
Spec-driven development pipeline for Claude Code: interview-to-spec, spec-approach, tdd, verify, diagnose, and a feature orchestrator.
Verification-first engineering toolkit for Claude Code. 15 skills across a 5-phase spine (Investigate → Design → Implement → Verify → Ship), 8 specialist agents, an interactive setup wizard. Every skill has rationalizations + evidence requirements. Built for senior ICs and tech leads.