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.
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:
- Speak less, say more. Caveman cuts output tokens while preserving exact commands, code, errors, and technical meaning.
- Build interfaces with taste. UI Craft starts from accessibility, performance, typography, spatial rhythm, color roles, and concrete interaction states.
- 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-factoryCLI 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.