diff --git a/CLAUDE.md b/CLAUDE.md
index 0a1a49f..442c7a8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -82,6 +82,18 @@ Key design decisions (all driven by /autoplan review):
 - Staging: none.
 - Rollback: revert the merge commit on `main` (and delete the tag) to roll back.
 
+## Codeberg operations
+
+The remote is Codeberg (Forgejo) — `gh`/`glab` do NOT work here. Use `tea`
+(login name: `codeberg`, user `egbt`) for forge operations when a skill's
+platform detection comes up "unknown":
+
+- PRs: `tea pr create --base main --title ... --description ...` / `tea pr merge <index>`
+- Releases: `tea releases create --tag v<X.Y.Z.W> --title "v<X.Y.Z.W> — <YYYY-MM-DD>" --note ...`
+  (convention: one release per tag, title `v<X.Y.Z.W> — <date>`)
+- Issues/status: `tea issues`, `tea pr list`
+- No CI on this repo: the bats suite run locally is the merge gate.
+
 ## Environment variable
 
 `SECRETS_DIR` overrides the default `~/.secrets` location (useful for testing). Per-project bindings via `.secrets-store` file beat this env var; use `--store <dir>` for one-shot overrides that beat everything.