Claude MarketplacesSubmit
juliusbrussee avatar

Spec

juliusbrussee/cavekit

Lives at the root of your repo as SPEC.md and becomes the single source of truth for what you're building. It writes specs in a terse "caveman" format (defined in FORMAT.md) with sections for goals, constraints, interfaces, invariants, tasks, and bugs. The interesting bit is backprop: when you hit a bug, it traces the cause, adds a row to the bug table, and proposes a new invariant to catch it next time. Also distills specs from existing code if you inherit a project with no documentation. It's opinionated about monotonic numbering and pipe table layouts, which either saves you from bikeshedding or feels rigid depending on your taste. No auto-build, you invoke that yourself.

skills.sh installs
2.7K
GitHub stars
1.2K
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add juliusbrussee/cavekit --skill spec --agent claude-code

Installs into .claude/skills of the current project.

Files

spec — spec mutator

Read FORMAT.md at repo root if not already loaded. Caveman skill applies to all writes here.

DISPATCH

Inspect user request and project state:

  1. No SPEC.md at repo root AND args describe idea → NEW
  2. No SPEC.md AND from-code in args → DISTILL
  3. SPEC.md exists AND args start bug: → BACKPROP
  4. SPEC.md exists AND args start amend → AMEND
  5. SPEC.md exists, no args → ask user which mode

INPUTS — spec is the sole mutator

The other verbs produce material; spec writes it. Ingest their handoff blocks into the right section, show a diff, write on OK:

  • grill → sharpened §G + §C
  • research → §R rows (add the §R section if absent)
  • review → drafted §V lines + the risk verdict
  • deepen → §I/§V/§T amendments

⊥ rewrite a section the handoff did not name. Sectioned ownership (see FORMAT.md).

NEW — idea → spec

Input: user idea. If it arrived fuzzy, prefer running grill first.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/juliusbrussee/cavekit
Categories
Code Review & Quality, Debugging
First seen
May 16, 2026

More from juliusbrussee/cavekit

All 5

Recommended

More Code Review & Quality
1agricidaniel avatarblog-auditagricidaniel/claude-blogFull-site blog health assessment scanning all blog files for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness. Runs2.7Kskills.sh installs
2agricidaniel avatarblog-briefagricidaniel/claude-blogGenerate detailed content briefs for blog posts with target keywords, content outlines, competitive analysis, recommended statistics, image and chart suggestion2.7Kskills.sh installs
3nexu-io avatarsocial-spotify-cardnexu-io/open-designSpotify Now Playing-style card with album art, progress bar, and playback controls, suited to video overlays or personal homepages.2.7Kskills.sh installs
4minimax-ai avatarvision-analysisminimax-ai/skillsAnalyze, describe, and extract information from images using the MiniMax vision MCP tool. Use when: user shares an image file path or URL (any message containin2.7Kskills.sh installs
5juxt avatartendjuxt/alliumTend the Allium garden. Use when the user wants to write, edit, update, add to, improve, clarify, refine, restructure, fix or migrate Allium specs. Covers addin2.7Kskills.sh installs
6auth0 avatarauth0-quickstartauth0/agent-skillsUse when adding Auth0 authentication to any app and unsure which SDK or skill to use. Detects the project's framework and routes to the right setup workflow — u2.7Kskills.sh installs