mirror of https://github.com/JuliusBrussee/skills.git synced 2026-09-19 01:11:52 +08:00

Files

T

Claude 3dee1f1add Add last-20-percent skill for finishing the experiential layer agents skip

New skill that counters the structural failure where agents decompose the
noun of a request (wiki -> ingestion, search, LLM) and the experience of
using the thing never appears in the decomposition, so it never becomes a
task. The skill decomposes the scene instead: a concrete magic moment,
walked step by step, with the residue specced at plumbing fidelity.

- skills/last-20-percent/SKILL.md: five-phase workflow (magic moment,
  scene-vs-noun decomposition, plumbing-fidelity specs with golden
  artifacts, front-loading, the walk) plus plan and audit modes
- references/last-20-catalog.md: eight recurring categories of skipped
  work with probe questions and cross-domain examples
- README.md, CLAUDE.md: register the eighth skill

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019MYgZjVEB9jkRWL6eL1Uq5

2026-07-08 08:01:53 +00:00

1.5 KiB

Raw Blame History

Repository Instructions

Purpose

This repo publishes eight Julius Brussee agent skills for now: caveman, interface-kit, grill-me, loop-factory, junior-to-senior, fuck-slop, context-canary, and last-20-percent. Treat it as an installable skill collection, not a product website.

Editing Rules

Keep skill files in skills/<skill-name>/SKILL.md.
Every skill needs YAML frontmatter with name and description.
Keep descriptions action-oriented. They should say when the skill triggers and what workflow it provides.
Use progressive disclosure. Put long references in references/ and link them from SKILL.md.
Do not add generated build artifacts.
Do not vendor third-party plugin caches.

Voice

Repo copy may be concise, but skill bodies should stay clear enough for agents to follow. Caveman branding belongs in Caveman skills and public-facing README sections, not every skill.

Quality Bar

Before committing:

node scripts/verify-skills.mjs
node scripts/list-skills.mjs

For interface-kit changes, preserve priorities:

accessibility
performance
typography
layout and spatial design
color semantics
motion and interaction
polish

Agent Skills

Issue Tracker

Issues live in GitHub Issues for JuliusBrussee/skills once repo is published.

Triage Labels

Default labels: needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix.

Domain Docs

Single-context repo. Use CONTEXT.md and docs/adr/.

1.5 KiB Raw Blame History