usrkey1 · Make the folder
$ mkdir -p ~/.usrkey && cd ~/.usrkey
Or start from the CC0 template — same six files with prompts in the comments.
2 · Write the pages that are true
Every page is optional. Each starts with # pagename and holds what you'd tell a sharp new coworker on day one:
# ~/.usrkey/identity.md — who you are
# identity
## One paragraph
Frank — runs a woodworking business in Ohio. Wants tools to write
in plain, direct language.
stack.md — how you like to work: tools, formats, "short answers first." now.md — what's true this week; the page you'll edit most. history.md — durable decisions worth keeping; rare. boundaries.md — how to treat you; only shared when you explicitly grant it. agents.md — the grants ledger; if you use tools that write it, don't edit it by hand.
What to leave out: passwords, IDs, card numbers, anything you'd regret pasting into a chat. This is context, not a vault — the principles page explains why that line matters.
3 · Check your work
Paste any page into the validator — it runs in your browser only and flags format slips, secrets, and injection-looking text. Clean pass gets you the badge.
4 · Let it be read
Tools that speak MCP: the connector guide. Everything else: your pages are plain text — paste them into any custom-instructions box, or point a 20-line reader at the folder.