Skip to content

adamoelz/gemkeeper / editions/skill-only/skills/gems

Keeps a tiny, always-current ledger of the mission-critical facts of a coding session (goal, hard rules, decisions and why, dead ends, current state, next step) in .gemkeeper/ledger.md so the session can be cleared or compacted at any time without losing what matters. Use proactively whenever the user states a rule, a preference, a decision with its reason, a failed approach or a gotcha ("never", "always", "don't", "because", "tried", "didn't work", "flaky", "heads-up"); whenever you discover a non-obvious fact or an approach fails; at the start of work in a project that has .gemkeeper/ledger.md; and when the user says "gems", "save gems", "sweep", "handoff", "save progress", "resume", "continue", "context is getting long", or is about to /clear or /compact.

FileKindSize
SKILL.mdskill md8.1 KB
references/ledger-template.mdmarkdown1.1 KB

references/ledger-template.md

View on GitHub
# Ledger: <short mission name>
<!-- gemkeeper ledger. Written for the next session. Keep it under ~120 lines. Edit in place. -->
Updated: <YYYY-MM-DD HH:MM>

## Mission
- <What we are building or fixing, in the user's terms. One or two bullets.>
- Done when: <concrete acceptance criteria>

## Rules
<!-- Hard constraints and preferences. (user) = stated explicitly by the user. -->
- (user) <e.g. Don't change the public API of src/api/client.ts>

## Decisions
<!-- <decision> — because <reason> -->
- <e.g. Use SQLite, not Postgres — because the app must run offline on a single machine>

## Dead ends
<!-- <tried> → <why it failed>. Don't retry these without new information. -->
- <e.g. Upgrading vitest to 3.x → breaks the msw mocks (TypeError: fetch is not a function)>

## Facts
<!-- Non-obvious things a fresh session would trip over. -->
- <e.g. Tests need `pnpm test -- --pool=forks`, threads mode hangs on CI>

## Open questions
- <Things that still need a decision from the user>

## Now
<!-- Rewritten on every sweep, never accumulated. -->
- Done: <...>
- In progress: <file paths + what's half-done>
- Next step: <one concrete action>
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall