Julius Brussee 0ccc7eec5e Add loop-factory skill and docs
Introduce the new `loop-factory` skill and its documentation. Adds skills/loop-factory/SKILL.md plus reference docs (autonomous.md, commands.md, install.md, spec-authoring.md) describing the spec-driven inbox→active→archive loop, autonomous mode, CLI commands, install steps, and spec authoring guidance. Also updates README.md, CONTEXT.md, and CLAUDE.md to list and summarize the new skill.
2026-06-08 21:54:48 +02:00
2026-06-08 21:06:22 +02:00
2026-06-08 21:06:22 +02:00
2026-06-08 21:54:48 +02:00
2026-06-08 21:06:22 +02:00
2026-06-08 21:06:22 +02:00
2026-06-08 21:54:48 +02:00
2026-06-08 21:54:48 +02:00
2026-06-08 21:06:22 +02:00
2026-06-08 21:06:22 +02:00
2026-06-08 21:54:48 +02:00

Julius Skills

Four personal agent skills for now: Caveman base, UI Craft, Grill Me, and Loop Factory.

This repo is shaped by four things:

  • Caveman - 70k-star token compression without technical loss. Small mouth, big brain.
  • UI craft - accessible, performant interfaces with strong aesthetic direction, not generic AI slop.
  • Grill Me - calibrated pressure before hard critique, so challenge matches user knowledge and comfort.
  • Loop Factory - spec-driven agent loop where tasks move through inbox → active → archive with a real review gate.

Point is control. Agents should be terse when talking, precise when building interfaces, calibrated when challenging plans, and disciplined when running build loops.

Quickstart

Install with skills.sh:

npx skills@latest add JuliusBrussee/skills

Pick the skills you want for Claude Code, Codex, Gemini, Cursor, Windsurf, Cline, Copilot, or any agent supported by the installer.

For the canonical Caveman installer, use:

curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash

Why These Skills Exist

Most agent output fails in three boring ways: too many words, UI that looks like every other generated demo, or critique that starts too hard before understanding user context.

This repo keeps three fixes close:

  1. Speak less, say more. Caveman cuts output tokens while preserving exact commands, code, errors, and technical meaning.
  2. Build interfaces with taste. UI Craft starts from accessibility, performance, typography, spatial rhythm, color roles, and concrete interaction states.
  3. Challenge at the right altitude. Grill Me assesses knowledge and desired pressure first, then asks one question at a time.

Skills

caveman

Ultra-compressed communication mode. Cuts token usage by dropping filler, hedging, pleasantries, and excess grammar while keeping technical accuracy intact.

Use when you want:

  • shorter agent replies
  • less token waste
  • exact code, command, error, and API preservation
  • persistent terse style until user exits with "normal mode"

ui-craft

Implementation guide for high-quality UI. Synthesizes accessibility, performance, typography, layout, color systems, motion, interaction states, and component craft.

Use when building:

  • frontend components
  • landing pages
  • dashboards
  • design systems
  • polished app flows
  • accessibility fixes
  • UI review passes

grill-me

Calibrated interview skill for stress-testing plans, designs, and decisions. It first asks how much the user knows and how hard they want the pressure, then ramps from clarifying questions to failure-mode critique.

Use when you want:

  • plan critique without getting overwhelmed
  • one question at a time
  • recommended answers with each question
  • pressure matched to beginner, working, or expert knowledge
  • softer or harder grilling on command

loop-factory

Spec-driven agent loop. Coding tasks live as markdown specs that move through inbox → active → archive, get implemented by Claude Code or Codex, and must pass a review gate before they count as done. State is just which folder a spec is in. The governing rule: automate implementation and verification, not product decisions.

Use when you want:

  • repeatable, reviewable agent work instead of one-off prompting
  • visible task state (inbox / active / archive) with no dashboard
  • generated implementation, review, and backprop prompts for either agent
  • a hard review gate before anything is marked done
  • to install or scaffold the loop-factory CLI into a project

Pairs with the Loop-Factory repo, which ships the CLI and native Claude/Codex adapters.

UI Craft Standard

If a repo has DESIGN.md, it wins. Otherwise UI work should still have a point of view:

  • Accessibility first: contrast, keyboard navigation, focus states, semantics.
  • Performance before decoration: stable layout, lazy assets, transform-only motion.
  • Typography matters: readable type scale, sane line length, tabular numbers for data.
  • Layout uses stable spatial rules: 4/8px spacing, responsive constraints, no overlap.
  • Components have complete states: hover, focus, active, disabled, loading, empty, error.
  • Avoid generic defaults: no faceless hero, no purple-blue gradient template, no stock-looking polish.

Caveman Ecosystem

This repo sits next to broader Julius agent stack:

Repo What
caveman Output compression for agents.
caveman-code Terminal coding agent built around token efficiency.
cavemem Cross-agent memory.
cavekit Spec-driven build loop.
cavegemma Fine-tuned model experiments for terse agent output.

Skill Reference

Run:

node scripts/list-skills.mjs

Verify frontmatter:

node scripts/verify-skills.mjs

Contributing

Skills should be:

  • Small enough to read quickly.
  • Triggered by clear user intent.
  • Progressive: load only the extra files needed.
  • Specific about workflow and validation.
  • Free of repo-specific assumptions unless the skill says so.

License

MIT.

S
Description
caveman: Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical accuracy. Supports intensity levels: lite,…; grill-me: Calibrated grilling session for stress-testing a plan, design, idea, or decision. First assesses the user's topic knowledge, confidence, and desired pressure…; junior-to-senior: Adversarial senior-engineer review for agent-generated plans, designs, and architectures. Treats the current output as junior work, constructs a…
Readme MIT 142 KiB
Languages
JavaScript 100%