dckc
237b470be8
A capability wiring diagram as a self-contained HTML/SVG page plus a headless-Chromium PNG. Every arrow has to point to something in the code, and a Mallory holding what's likeliest to leak shows what that doesn't reach. template.html has the drawing helpers, adapted from capsite's cookie-rotation-wiring. README: a TODO to consider adapting agoric-sdk's sequence-diagram-actor-sim as its companion. Generated-by: Claude Opus 5.5
80 lines
3.6 KiB
Markdown
80 lines
3.6 KiB
Markdown
# mad skills
|
|
|
|
How I like code written, reviewed, and committed — written down so the
|
|
bots I pair with can pick it up without me repeating myself.
|
|
|
|
These are [Agent Skills](https://agentskills.io/specification). Each
|
|
`description` front-loads the words that should trigger it — the things
|
|
I actually say, like "retcon", "watch me", or "citation needed".
|
|
|
|
I keep this repo checked out at `.agents/skills/` in a workspace and
|
|
symlink `.claude/skills` and `.opencode/skills` to it, so [Claude
|
|
Code](https://code.claude.com/docs/en/skills) and
|
|
[opencode](https://opencode.ai/docs/skills/) see the same set.
|
|
|
|
## writing code
|
|
|
|
- [no-ambient-authority](no-ambient-authority/SKILL.md) — clocks,
|
|
RNGs, `fetch`, and the filesystem come in as parameters.
|
|
- [io-between-turns](io-between-turns/SKILL.md) — sync I/O is a pointy
|
|
instrument.
|
|
- [silent-failures-are-evil](silent-failures-are-evil/SKILL.md) — every
|
|
failure path leaves a trace in the logs.
|
|
- [lazy-tdd](lazy-tdd/SKILL.md) — works the first time? fine. Goofed?
|
|
You owe a test.
|
|
- [docs-files-api](docs-files-api/SKILL.md) — README sells and gets
|
|
you to TADA; CONTRIBUTING has the rest; AGENTS.md links to it.
|
|
Exported API docs over file docs. Avoid chit-chat.
|
|
|
|
## commits and PRs
|
|
|
|
- [disclose-gen-ai](disclose-gen-ai/SKILL.md) — `Generated-by:`
|
|
trailers, per the ASF generative tooling guidance.
|
|
- [retcon](retcon/SKILL.md) — regroup a PR's net diff into clean
|
|
per-package commits; the merge result doesn't change.
|
|
- [yarn-lock-separate-commit](yarn-lock-separate-commit/SKILL.md) —
|
|
`yarn.lock` changes ship alone.
|
|
|
|
## writing prose
|
|
|
|
- [grice-maxims](grice-maxims/SKILL.md) — say what's needed and no
|
|
more, only what you can back up, in an order easy to follow.
|
|
- [hypertext-links](hypertext-links/SKILL.md) — link text says where
|
|
the link goes; no bare URLs, no "click here".
|
|
- [citation-needed](citation-needed/SKILL.md) — back a challenged claim
|
|
with live links, quoted and dated.
|
|
- [hackmd-deck](hackmd-deck/SKILL.md) — a light talk as a flashback:
|
|
TADA, then how, then the challenges, tagged for an emoji retro.
|
|
- [ibis-design](ibis-design/SKILL.md) — search a design space:
|
|
issues, positions, and arguments.
|
|
- [wiring-diagram](wiring-diagram/SKILL.md) — who holds what, drawn
|
|
like MarkM's ERTP slides: every arrow cites the code, and Mallory
|
|
shows what a leak doesn't reach.
|
|
TODO: consider copying or adapting its companion for message order,
|
|
sequence-diagram-actor-sim (agoric-sdk `.agents/skills/` on branch
|
|
`connolly/ago-1299-agentic-planning-tdd`).
|
|
- [obsidian-markdown](obsidian-markdown/SKILL.md) — the workspace is
|
|
an Obsidian vault: one line per paragraph, relative links, no file
|
|
symlinks you expect Obsidian to show.
|
|
|
|
## at the terminal
|
|
|
|
- [discord-agent-workspace](discord-agent-workspace/SKILL.md) — set
|
|
someone up like this: Claude Code in a workspace folder, messaged
|
|
from Discord.
|
|
- [watchme](watchme/SKILL.md) — I record the session with `script -f`;
|
|
read the typescript instead of asking me what happened.
|
|
- [run-confined](run-confined/SKILL.md) — run an untrusted installer in
|
|
a throwaway systemd user unit that can't see `~/.ssh` and friends.
|
|
- [what-was-i-doing](what-was-i-doing/SKILL.md) — where did this file
|
|
come from? Correlate mtimes with git history across every repo.
|
|
- [notify-me](notify-me/SKILL.md) — desktop notification at the end
|
|
of a long turn, sticky if I'm stepping away; not every reply.
|
|
|
|
## adding one
|
|
|
|
Name the directory for the trigger, not the topic. Write the
|
|
`description` for the matcher: what I'd say, what I'd be doing, and
|
|
what it's *not* for. Cite the source; quote the key line; explain the
|
|
rest.
|