[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ARADZEF94QJ4ZZEPMZX583":3,"skill-same:01M7ARADZEF94QJ4ZZEPMZX583":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7ARADZEF94QJ4ZZEPMZX583","chat-matrix-and-element",null,"Use when running or building on Matrix — the federated protocol and its room\u002Fevent model, Olm and Megolm, Matrix 2.0 and where it stands, the ecosystem's organisations and funding, the homeserver operator handbook including the European sovereignty deployments, and the developer surface. Companion to the other private-chat-engine skills.","the-vibey-project\u002Fvibey","the-vibey-project","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F329298758?v=4","01M7AJHGZ9722CTJ4JNQZVRH0Q","the vibey project","01M7AJHGZVMG2K7TGXQ6XFHVG3",5,"MIT","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fprivate-chat-engines\u002Fskills\u002Fchat-matrix-and-element\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: chat-matrix-and-element\ndescription: \"Use when running or building on Matrix — the federated protocol and its room\u002Fevent model, Olm and Megolm, Matrix 2.0 and where it stands, the ecosystem's organisations and funding, the homeserver operator handbook including the European sovereignty deployments, and the developer surface. Companion to the other private-chat-engine skills.\"\n---\n\n# Matrix and Element: The One You Can Actually Operate\n\n> **Part 4 of 6** of the *Private Chat Engines* dossier (plugin\n> `private-chat-engines`), covering §1–§6. Sibling skills:\n> `chat-orientation-threat-models-and-landscape` (§0–§5 — the three architectural families, threat-model taxonomy, the comparison matrix, the timeline, the five forces),\n> `chat-signal` (§1–§6 — the protocol stack, the organisation and its costs, legal posture, operator and developer perspectives, honest weaknesses),\n> `chat-telegram` (§1–§7 — MTProto and the cloud-chat compromise, the Durov prosecution, scale and economics, the bot and Mini-App economy),\n> `chat-the-wider-field` (§1–§13 — MLS and Wire, WhatsApp, iMessage PQ3, Threema, Olvid, SimpleX, Session, Nostr, XMPP, Briar, Delta Chat, the dead ones, the policy annex),\n> `chat-builder-and-operator-playbooks` (§1–§12 — protocol shape, the crypto checklists, the metadata budget, abuse under E2EE, the unglamorous 80%, ops checklists, incident playbooks).\n> Section numbers are **per skill**, not shared across the set: each file is a self-contained\n> dossier entry. A reference written as §N → `skill` points at that skill's own §N.\n>\n> **Currency:** state of research 16 September 2026. §1's protocol is **stable fundamentals**. §2 (Matrix 2.0 status), §3 (organisations, money and maintenance) and parts of §4 are **dated specifics** — the funding and maintenance picture in particular changes year to year.\n\n> **⚠️ The only entry here that is an open federated protocol with a real self-hosting story at national scale — and that single fact explains everything else about it.**\n>\n> **⚠️ GOTCHA** boxes mark where the common mental model is wrong in ways that get people hurt\n> or products mis-designed.\n>\n> **The three ideas that organize this document:**\n> 1. **⚠️ FEDERATION MOVES THE COST AND THE METADATA, IT DOES NOT REMOVE THEM**\n>    **Running the server is the product, but it also means every homeserver is its own legal and moderation jurisdiction, and federation exposes more metadata to more parties than a single-operator design does.**\n> 2. **⚠️ THE OPERATOR HANDBOOK IS THE PERSPECTIVE NOBODY ELSE CAN OFFER**\n>    **§4 exists because Signal and Telegram have no equivalent. If you need to be responsible for the infrastructure, this is where the field's only real answer lives.**\n> 3. **⚠️ WHO MAINTAINS WHAT IS A LOAD-BEARING QUESTION**\n>    **§3 traces the organisations and the money because an open protocol's viability is a funding question as much as a technical one — and adopting it is a bet on that.**\n\n---\n\nMatrix is the only entry in this dossier that is *an open federated protocol with a real\nself-hosting story at national scale*. That single fact explains everything else about it: its\npolitics (European sovereignty wave), its funding struggles (everyone's favourite public good\nthat nobody wants to fund), and its complexity (federation is genuinely hard).\n\n---\n\n## 1. The protocol (fundamentals — stable)\n\n### 1.1 The data model: rooms as replicated event DAGs\nA Matrix \"room\" is not a file on a server; it is a **partially-replicated directed acyclic graph\nof signed JSON events** shared by every homeserver with a participating user. Message events,\nmembership changes, power levels, redactions — all events in the DAG. Each server keeps the full\nhistory for the rooms it's in and resolves forks with **state resolution** (versioned algorithms;\n\"state res v2\" is the modern one. Room **version 12** — being marched toward default as of mid\n2026 — even redefines `room_id` as a hash of the create event, killing server-name dependence for\nroom identity).\n\n### 1.2 Federation\nServers speak the **Server-Server API** over mutually-authenticated HTTPS with **signing keys**;\ndiscovery via `.well-known` and SRV. Any server can join any joinable room (subject to room ACLs).\nFederation is also the privacy caveat: *every participating server stores every (encrypted) event,\nroom state, and metadata for its users' rooms forever unless retention is configured* — see §4.6.\n\n### 1.3 E2EE: Olm & MegOlm on vodozemac\n- **Olm** (double-ratchet 1:1 sessions, X3DH-style one-time keys published to the server) and\n  **MegOlm** (an *outbound-only* ratchet for group messages: one symmetric session per sender per\n  room, shared to devices via Olm). The reference implementation is now **vodozemac** (Rust,\n  formally audited, built with Cryspen) replacing the old C++ libolm in maintained clients.\n- **Post-compromise security caveat**: because MegOlm sessions are outbound-only, they don't\n  self-heal the way pairwise ratchets do; rotation settings and device-change sharing rules are\n  the mitigation. This is a known, documented trade (cheap fan-out vs. weaker PCS).\n- **History on join is a policy decision, not a protocol guarantee**: a joining device receives the\n  current outbound session, so unless the room key has rotated it can decrypt messages already sent\n  in that session. Set `m.room.history_visibility` and the rotation parameters\n  (`rotation_period_ms` \u002F `rotation_period_msgs` in `m.room.encryption`) deliberately rather than\n  inheriting defaults — and state the answer in the room's description, because members will assume\n  the opposite of whatever you chose.\n- **Cross-signing & verification**: users hold master\u002Fself-signing\u002Fuser-signing keys (secured by\n  the \"secure secret storage\"\u002F(4S) backup on the homeserver, protected by a recovery key);\n  verification by QR\u002Femoji between devices; the Matrix 2.0-era direction is **invisible\n  encryption** — excluding unverified devices and moving toward trust-on-first-use — and the\n  **Matrix 3.0 candidate is MLS** (per the [Matrix 2.0 announcement](https:\u002F\u002Fwww.matrix.org\u002Fblog\u002F2024\u002F10\u002F29\u002Fmatrix-2.0-is-here\u002F)).\n\n### 1.4 The spec process\nMSC (Matrix Spec Change) → Spec Core Team review → spec releases (v1.14 era → **v1.19 expected\nimminently**, mid-2026). Amusingly political live question as of 2026: **MSC4504 proposes a\nsingle global \"v2\" version number** for the whole spec.\n\n---\n\n## 2. Matrix 2.0 (verified) — and where it stands in Sept 2026\n\nAnnounced\u002Fshipped as an *API contract* in October 2024\n([Matrix.org](https:\u002F\u002Fwww.matrix.org\u002Fblog\u002F2024\u002F10\u002F29\u002Fmatrix-2.0-is-here\u002F)), four pillars:\n\n1. **Simplified Sliding Sync (MSC4186)** — instant login\u002Flaunch\u002Fsync; implemented natively in\n   Synapse ≥1.114, deprecating the old sync *proxy*. **Accepted by the Spec Core Team in mid-2026**\n   ([TWIM 3 Jul 2026](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F07\u002F03\u002Fthis-week-in-matrix-2026-07-03\u002F)).\n2. **Native OIDC auth (MSC3861)** via the **Matrix Authentication Service (MAS)** — QR-code login,\n   external IdPs, modern sessions. (Synapse dropped the experimental MSC3861 phase in favour of\n   stable MAS integration in v1.157 cycle, [TWIM 17 Jul 2026](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F07\u002F17\u002Fthis-week-in-matrix-2026-07-17\u002F)).\n3. **MatrixRTC (MSC4143)** — native E2EE group voice\u002Fvideo; built on **Element Call + LiveKit SFU**;\n   2026 additions: \"slots\" (real-time primitives for calls, games, virtual worlds), sticky events,\n   a JS MatrixRTC SDK — demos include multiplayer Godot games running over federation\n   ([Element blog, FOSDEM 2026](https:\u002F\u002Felement.io\u002Fblog\u002Fexploring-matrixrtc-real-time-communication-in-rooms\u002F)).\n4. **Invisible Encryption** — eliminating the infamous \"Unable to Decrypt\" errors.\n\nAs of September 2026 the Spec Core Team was \"aiming to cut\" the formal 2.0 release\n([TWIM 14 Aug 2026](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F08\u002F14\u002Fthis-week-in-matrix-2026-08-14\u002F));\nElement X clients were shipping 2.0 features incrementally (QR login, user status, live location).\n\n**Federation stats (July 2026)**: ~19,512 known federating servers, **78.8% of them running\nSynapse** — the federation's diversity problem in one number.\n\n---\n\n## 3. The ecosystem: organisations, money, and who's maintaining what (verified)\n\n### 3.1 The corporate split\n- **Matrix.org Foundation** owns the protocol, spec, and matrix.org homeserver; charity, funded by\n  memberships + donations + events + (new in late 2025) **premium accounts on matrix.org**.\n- **Element** (formerly New Vector) is the startup founded by Matrix's creators; employs most of\n  the core engineering: Synapse, MAS, the Rust\u002FJS SDKs, Element clients, and the matrix.org\n  infrastructure itself.\n- Per the Foundation's **first public annual report (published March 2026,\n  [blog](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F03\u002Fannual-report\u002F) ·\n  [PDF](https:\u002F\u002Fwww.matrix.org\u002Ffoundation\u002Freports\u002F2025%20Public%20Annual%20Report.pdf))**:\n  FY2025 revenue +38%, deficit cut from £910,821 to £310,596; **Automattic's Gold membership alone\n  = 50% of revenue**; the report calls the dependence on Element's in-kind donations\n  \"unsustainable\". Earlier milestones: the Feb 2025 [\"crossroads\" post](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2025\u002F02\u002Fcrossroads\u002F)\n  ($610K shortfall; public Slack\u002FXMPP\u002FIRC bridges shut), June 2025\n  [matrix.org freemium](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2025\u002F06\u002Ffunding-homeserver-premium\u002F).\n\n### 3.2 Homeserver implementations\n- **Synapse** (Python, increasingly Rust components — client-event serialisation and DB access\n  were ported by mid-2026; v1.159-era release candidates marched toward room **v12 as default**):\n  the production reference server. Worker-sharded, Postgres-backed, the hardest and most rewarding\n  to run at scale.\n- **Continuwuity** ([site](https:\u002F\u002Fcontinuwuity.org\u002Fintroduction) ·\n  [GitHub mirror](https:\u002F\u002Fgithub.com\u002Fcontinuwuity\u002Fcontinuwuity)): community Rust homeserver,\n  forked from the archived **conduwuit**, with weekly-ish releases; easy on modest hardware.\n  Fork drama worth knowing: conduwuit's archived README disputes continuwuity's \"official\n  successor\" claim and endorses **Tuwunel** instead — as an operator, evaluate both; migrations\n  are conduwuit→continuwuity only (no Synapse\u002FDendrite path).\n- **Dendrite** (Go, second-generation reference) has been in a semi-dormant state since Element\n  moved it to the Foundation; do not plan new deployments on it without checking current status.\n- Others: Conduit (original Rust project, moribund), Grapevine (stalled).\n\n### 3.3 Clients and bridges\n- **Element X** (iOS\u002FAndroid on matrix-rust-sdk — the strategic client), Element Web\u002FDesktop\n  (classic, on matrix-js-sdk), plus the long tail (FluffyChat, Fractal, Cinny, Nheko…).\n- Bridges live on the **Application Service API**: the **mautrix** family (Telegram, WhatsApp,\n  Signal, Messenger, Slack, Discord…) — Beeper open-sourced its bridge stack; Beeper and Texts\n  are now Automattic's (2023–24 acquisitions) — plus hookshot (GitHub\u002Ffeeds) and matrix-admin\n  tooling. Note the Foundation killed the *public* Slack\u002FXMPP\u002FIRC bridges in its 2025 cost cuts;\n  self-hosted bridges are unaffected.\n\n### 3.4 The sovereignty wave (verified; the most important customer story in private chat)\n- **Germany**: BwMessenger for the Bundeswehr (since Nov 2020, 100k+ active users, BSI-certified\n  for VS-NfD) and **BundesMessenger** for the wider public sector (~250,000 users across\n  municipalities, agencies, fire services; private federation, BSI-hardened, audited)\n  ([Element case study](https:\u002F\u002Felement.io\u002Fen\u002Fcase-studies\u002Fbundeswehr) ·\n  [Matrix Conf slides Oct 2025](https:\u002F\u002F2025.matrix.org\u002Fslides\u002Fslides_9HKYHA.pdf)). Plus\n  TI-Messenger for healthcare and openDesk at ZenDiS.\n- **France**: Tchap (300k+ public-sector users) and La Suite Numérique, built on Matrix; Olvid\n  separately holds the cabinet-level mandate (→ `chat-the-wider-field`).\n- **NATO**: NI2CE Messenger (NATO-branded Element fork) via NATO ACT experimentation; **UNICC**\n  selected Element (2024); live deployments also credited to US DoD (since 2020), UK MoD, Polish\n  and Ukrainian armed forces ([Element's Digital Sovereignty Summit post, Nov 2025](https:\u002F\u002Felement.io\u002Fblog\u002Felement-at-the-summit-on-european-digital-sovereignty\u002F) ·\n  [Computer Weekly, Oct 2025](https:\u002F\u002Fwww.computerweekly.com\u002Fnews\u002F366633894\u002FEuropean-governments-opt-for-open-source-alternatives-to-Big-Tech-encrypted-communications)).\n- Catalysts: US sanctions on the ICC, the March 2025 \"Signalgate\" scandal, and a broad European\n  digital-sovereignty push (Merz and Macron keynoted the Berlin summit Element attended).\n  France and Germany are even discussing interoperating their national messengers.\n- Element's commercial arm is **Element Server Suite (ESS)** — a Kubernetes distribution of the\n  stack (Synapse+workers, MAS, Element Web\u002FX, LiveKit, bridges, admin console) with a paid Secure\n  tier; Sweden's Försäkringskassan, NATO ACT, UNICC and the EC are credited with\n  subscription-based procurement commitments.\n\n---\n\n## 4. Operator handbook: running a homeserver (the perspective nobody else can offer)\n\n### 4.1 Sizing honestly\n- Personal\u002Ffriends server (\u003C50 users): a $6 VPS runs Continuwuity or even Synapse comfortably.\n  Synapse RAM pressure comes from *joining big federated rooms*, not your user count — federation\n  state, not messages, is the resource hog.\n- Community (1–5k users): Synapse on 4–8 vCPU\u002F16–32 GB with Postgres on SSD, media on object\n  storage\u002FCF cache; split out `media_repo` and `federation_sender` workers early.\n- Institutional: ESS on Kubernetes, or Synapse with full worker separation (sync, client reader,\n  federation reader\u002Fsender, event persisters, media, background, pusher, appservice) behind a\n  smart reverse proxy; Postgres HA; TURN (coturn) + LiveKit for calls.\n\n### 4.2 The ops chores that actually burn people\n1. **Postgres tuning & state compression** — `state_groups_state` grows without bound; run the\n   rust-synapse-compress-state tool routinely; mind autovacuum.\n2. **Media discipline** — set retention (`media_retention: local_media_lifetime`,\n   remote_media_lifetime) or watch disk forever; consider matrix-media-repo for dedup\u002FCDN.\n3. **Key custody** — your server signing keys *are* your identity in federation. Lose them and\n   you rejoin every room. Back them up; rotate carefully (old keys must be kept published for\n   history validation).\n4. **`server_name` vs server** — use delegation (`.well-known`) so user IDs live on the apex\n   domain (alice@example.org) while Synapse runs at matrix.example.org. You cannot cleanly change\n   server_name later. This is the #1 forever-decision.\n5. **Backups that restore** — Postgres dumps + media store + MAS DB + signing keys + TURN creds;\n   *test* restores. E2EE rooms are client-side anyway (4S recovery keys per user — train users on\n   recovery keys or accept UTD \"can't decrypt\" tickets).\n6. **Federation hygiene** — room ACLs against abusive servers, `m.room.server_acl` events, and\n   subscribing to community policy lists.\n\n### 4.3 Moderation under (mostly) E2EE\nOn Matrix, E2EE means moderators can't read encrypted content they're not sent — but moderation\nis *infrastructure + policy*, not content scanning:\n- policy-list subscriptions (**Draupnir** is the successor to Mjolnir — moderation bot watching\n  shared ban lists), server ACLs, joins-by-knocking\u002Finvite, power levels, slow mode, redactions,\n  report forwarding to server admins, and deactivation flows. Public unencrypted rooms are fully\n  visible to their homes' admins; homeserver operators bear legal duties for what they host —\n  EU-facing communities have DSA obligations worth a compliance read.\n- Trust & Safety is real labour: the Foundation's report counts moderation at ~30% on top of the\n  matrix.org homeserver's infra cost (~20% of total spend) — one reason Premium exists.\n\n### 4.4 Legal exposure checklist (operator)\nyou become a CDN *and* a postmaster: retention law in your jurisdiction, lawful-request process\n(write one before you need it), CSAM hash-matching duties for public unencrypted content,\ncopyright complaints, sanctions screening for hosted communities, and GDPR data maps (encrypted\nevents still carry metadata and IPs in logs — rotate those logs).\n\n### 4.5 Cheat: don't self-host\nElement's hosted offerings \u002F ESS Community, etke.cc, un-hooked \"matrix for hire\" providers —\nfine for communities that want sovereignty-lite without the on-call.\n\n### 4.6 The honest privacy critique\nFederation sprays *metadata* widely: every server in a room learns membership, timing and the\nsocial graph of everyone in it; E2EE protects content only. Retention defaults are\n\"keep forever\". For dissident-grade threat models, Matrix federation metadata is a real exposure —\nSimpleX\u002FSession\u002FBriar exist for a reason (→ `chat-the-wider-field`).\n\n---\n\n## 5. Developer perspective\n\n- **APIs that make it programmable**: the **Client-Server API** (sync, send, E2EE, push),\n  the **Application Service API** (bridges\u002Fbots with puppeted users), **Widgets**, and the\n  server-admin APIs. Spec is open; MSCs are public — you can *propose protocol changes yourself*\n  (that's a real differentiator vs. Signal\u002FWhatsApp).\n- **SDKs**: `matrix-rust-sdk` (drives Element X; UniFFI bindings into Swift\u002FKotlin, JS via WASM),\n  `matrix-js-sdk` (web-classic), community libs (matrix-nio Python, mautrix-go for bridge-grade\n  bots, Trixnity Kotlin…).\n- **Build-a-bot in an afternoon**: mautrix-go's appservice framework or matrix-nio + asyncio is\n  the fastest route; for business bots, hookshot patterns give you webhooks→rooms.\n- **E2EE in your own client**: vodozemac via rust-sdk crypto crate — cross-signing, key backup,\n  and verification UX are the hard 80%, all solved for you if you stay on the SDK.\n- **Custom real-time**: MatrixRTC SDK \"slots\" turn rooms into live shared state for games\u002Fapps —\n  watch this space through 2026–27.\n- **Governance literacy**: read the current room version, MSC status and SCT notes before\n  building on anything experimental (sliding sync extensions, MSC4505 push for knock\u002Flive\n  location, etc.). The\n  [This Week in Matrix](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F08\u002F14\u002Fthis-week-in-matrix-2026-08-14\u002F)\n  newsletter is the ecosystem's heartbeat.\n\n---\n\n## 6. Verdict\n\nMatrix in 2026 is what email's federation wanted to grow up to be: messy, expensive, politically\nessential. If your brief is \"we control our infrastructure and our legal jurisdiction,\" it is —\nstill, uniquely — the only serious answer among messengers. The costs land on operators and the\nFoundation (see the annual report); the benefits land on Europe's governments and everyone who\nrejects single-company trust.\n\n---\n\n## Sources (this file)\n\n- Matrix 2.0: [official announcement (29 Oct 2024)](https:\u002F\u002Fwww.matrix.org\u002Fblog\u002F2024\u002F10\u002F29\u002Fmatrix-2.0-is-here\u002F)\n- This Week in Matrix: [3 Jul 2026 (MSC4186 accepted; 19,512 servers; Synapse 78.8%)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F07\u002F03\u002Fthis-week-in-matrix-2026-07-03\u002F) ·\n  [17 Jul 2026 (Synapse rustification, MSC4504)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F07\u002F17\u002Fthis-week-in-matrix-2026-07-17\u002F) ·\n  [14 Aug 2026 (room v12 march, Element X v26.08, SCT release intent)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F08\u002F14\u002Fthis-week-in-matrix-2026-08-14\u002F)\n- MatrixRTC: [Element blog, FOSDEM 2026 talk (19 Feb 2026)](https:\u002F\u002Felement.io\u002Fblog\u002Fexploring-matrixrtc-real-time-communication-in-rooms\u002F)\n- Foundation finances: [Annual report blog (Mar 2026)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F03\u002Fannual-report\u002F) ·\n  [FY2025 Public Annual Report (PDF)](https:\u002F\u002Fwww.matrix.org\u002Ffoundation\u002Freports\u002F2025%20Public%20Annual%20Report.pdf) ·\n  [\"We're at a crossroads\" (Feb 2025)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2025\u002F02\u002Fcrossroads\u002F) ·\n  [Premium accounts (Jun 2025)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2025\u002F06\u002Ffunding-homeserver-premium\u002F)\n- Deployments: [Element Bundeswehr case study](https:\u002F\u002Felement.io\u002Fen\u002Fcase-studies\u002Fbundeswehr) ·\n  [BundesMessenger Matrix Conf slides (Oct 2025)](https:\u002F\u002F2025.matrix.org\u002Fslides\u002Fslides_9HKYHA.pdf) ·\n  [Computer Weekly (31 Oct 2025)](https:\u002F\u002Fwww.computerweekly.com\u002Fnews\u002F366633894\u002FEuropean-governments-opt-for-open-source-alternatives-to-Big-Tech-encrypted-communications) ·\n  [Element Digital Sovereignty Summit post (18 Nov 2025)](https:\u002F\u002Felement.io\u002Fblog\u002Felement-at-the-summit-on-european-digital-sovereignty\u002F) ·\n  [Element government positioning post (25 Mar 2025)](https:\u002F\u002Felement.io\u002Fblog\u002Fadvancing-secure-convenient-government-communications-the-case-for-element\u002F)\n- Homeservers: [Continuwuity](https:\u002F\u002Fcontinuwuity.org\u002Fintroduction) ·\n  [continuwuity GitHub mirror](https:\u002F\u002Fgithub.com\u002Fcontinuwuity\u002Fcontinuwuity) ·\n  [archived conduwuit repo (successor dispute)](https:\u002F\u002Fgithub.com\u002Fgirlbossceo\u002Fconduwuit\u002F)\n- vodozemac, matrix-* sdks, mautrix: stable fundamentals from public repos (Element\u002Fmatrix-org and\n  mautrix GitHub orgs); no dated claims relied upon here.\n","# Matrix and Element: The One You Can Actually Operate\n\n> **Part 4 of 6** of the *Private Chat Engines* dossier (plugin\n> `private-chat-engines`), covering §1–§6. Sibling skills:\n> `chat-orientation-threat-models-and-landscape` (§0–§5 — the three architectural families, threat-model taxonomy, the comparison matrix, the timeline, the five forces),\n> `chat-signal` (§1–§6 — the protocol stack, the organisation and its costs, legal posture, operator and developer perspectives, honest weaknesses),\n> `chat-telegram` (§1–§7 — MTProto and the cloud-chat compromise, the Durov prosecution, scale and economics, the bot and Mini-App economy),\n> `chat-the-wider-field` (§1–§13 — MLS and Wire, WhatsApp, iMessage PQ3, Threema, Olvid, SimpleX, Session, Nostr, XMPP, Briar, Delta Chat, the dead ones, the policy annex),\n> `chat-builder-and-operator-playbooks` (§1–§12 — protocol shape, the crypto checklists, the metadata budget, abuse under E2EE, the unglamorous 80%, ops checklists, incident playbooks).\n> Section numbers are **per skill**, not shared across the set: each file is a self-contained\n> dossier entry. A reference written as §N → `skill` points at that skill's own §N.\n>\n> **Currency:** state of research 16 September 2026. §1's protocol is **stable fundamentals**. §2 (Matrix 2.0 status), §3 (organisations, money and maintenance) and parts of §4 are **dated specifics** — the funding and maintenance picture in particular changes year to year.\n\n> **⚠️ The only entry here that is an open federated protocol with a real self-hosting story at national scale — and that single fact explains everything else about it.**\n>\n> **⚠️ GOTCHA** boxes mark where the common mental model is wrong in ways that get people hurt\n> or products mis-designed.\n>\n> **The three ideas that organize this document:**\n> 1. **⚠️ FEDERATION MOVES THE COST AND THE METADATA, IT DOES NOT REMOVE THEM**\n>    **Running the server is the product, but it also means every homeserver is its own legal and moderation jurisdiction, and federation exposes more metadata to more parties than a single-operator design does.**\n> 2. **⚠️ THE OPERATOR HANDBOOK IS THE PERSPECTIVE NOBODY ELSE CAN OFFER**\n>    **§4 exists because Signal and Telegram have no equivalent. If you need to be responsible for the infrastructure, this is where the field's only real answer lives.**\n> 3. **⚠️ WHO MAINTAINS WHAT IS A LOAD-BEARING QUESTION**\n>    **§3 traces the organisations and the money because an open protocol's viability is a funding question as much as a technical one — and adopting it is a bet on that.**\n\n---\n\nMatrix is the only entry in this dossier that is *an open federated protocol with a real\nself-hosting story at national scale*. That single fact explains everything else about it: its\npolitics (European sovereignty wave), its funding struggles (everyone's favourite public good\nthat nobody wants to fund), and its complexity (federation is genuinely hard).\n\n---\n\n## 1. The protocol (fundamentals — stable)\n\n### 1.1 The data model: rooms as replicated event DAGs\nA Matrix \"room\" is not a file on a server; it is a **partially-replicated directed acyclic graph\nof signed JSON events** shared by every homeserver with a participating user. Message events,\nmembership changes, power levels, redactions — all events in the DAG. Each server keeps the full\nhistory for the rooms it's in and resolves forks with **state resolution** (versioned algorithms;\n\"state res v2\" is the modern one. Room **version 12** — being marched toward default as of mid\n2026 — even redefines `room_id` as a hash of the create event, killing server-name dependence for\nroom identity).\n\n### 1.2 Federation\nServers speak the **Server-Server API** over mutually-authenticated HTTPS with **signing keys**;\ndiscovery via `.well-known` and SRV. Any server can join any joinable room (subject to room ACLs).\nFederation is also the privacy caveat: *every participating server stores every (encrypted) event,\nroom state, and metadata for its users' rooms forever unless retention is configured* — see §4.6.\n\n### 1.3 E2EE: Olm & MegOlm on vodozemac\n- **Olm** (double-ratchet 1:1 sessions, X3DH-style one-time keys published to the server) and\n  **MegOlm** (an *outbound-only* ratchet for group messages: one symmetric session per sender per\n  room, shared to devices via Olm). The reference implementation is now **vodozemac** (Rust,\n  formally audited, built with Cryspen) replacing the old C++ libolm in maintained clients.\n- **Post-compromise security caveat**: because MegOlm sessions are outbound-only, they don't\n  self-heal the way pairwise ratchets do; rotation settings and device-change sharing rules are\n  the mitigation. This is a known, documented trade (cheap fan-out vs. weaker PCS).\n- **History on join is a policy decision, not a protocol guarantee**: a joining device receives the\n  current outbound session, so unless the room key has rotated it can decrypt messages already sent\n  in that session. Set `m.room.history_visibility` and the rotation parameters\n  (`rotation_period_ms` \u002F `rotation_period_msgs` in `m.room.encryption`) deliberately rather than\n  inheriting defaults — and state the answer in the room's description, because members will assume\n  the opposite of whatever you chose.\n- **Cross-signing & verification**: users hold master\u002Fself-signing\u002Fuser-signing keys (secured by\n  the \"secure secret storage\"\u002F(4S) backup on the homeserver, protected by a recovery key);\n  verification by QR\u002Femoji between devices; the Matrix 2.0-era direction is **invisible\n  encryption** — excluding unverified devices and moving toward trust-on-first-use — and the\n  **Matrix 3.0 candidate is MLS** (per the [Matrix 2.0 announcement](https:\u002F\u002Fwww.matrix.org\u002Fblog\u002F2024\u002F10\u002F29\u002Fmatrix-2.0-is-here\u002F)).\n\n### 1.4 The spec process\nMSC (Matrix Spec Change) → Spec Core Team review → spec releases (v1.14 era → **v1.19 expected\nimminently**, mid-2026). Amusingly political live question as of 2026: **MSC4504 proposes a\nsingle global \"v2\" version number** for the whole spec.\n\n---\n\n## 2. Matrix 2.0 (verified) — and where it stands in Sept 2026\n\nAnnounced\u002Fshipped as an *API contract* in October 2024\n([Matrix.org](https:\u002F\u002Fwww.matrix.org\u002Fblog\u002F2024\u002F10\u002F29\u002Fmatrix-2.0-is-here\u002F)), four pillars:\n\n1. **Simplified Sliding Sync (MSC4186)** — instant login\u002Flaunch\u002Fsync; implemented natively in\n   Synapse ≥1.114, deprecating the old sync *proxy*. **Accepted by the Spec Core Team in mid-2026**\n   ([TWIM 3 Jul 2026](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F07\u002F03\u002Fthis-week-in-matrix-2026-07-03\u002F)).\n2. **Native OIDC auth (MSC3861)** via the **Matrix Authentication Service (MAS)** — QR-code login,\n   external IdPs, modern sessions. (Synapse dropped the experimental MSC3861 phase in favour of\n   stable MAS integration in v1.157 cycle, [TWIM 17 Jul 2026](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F07\u002F17\u002Fthis-week-in-matrix-2026-07-17\u002F)).\n3. **MatrixRTC (MSC4143)** — native E2EE group voice\u002Fvideo; built on **Element Call + LiveKit SFU**;\n   2026 additions: \"slots\" (real-time primitives for calls, games, virtual worlds), sticky events,\n   a JS MatrixRTC SDK — demos include multiplayer Godot games running over federation\n   ([Element blog, FOSDEM 2026](https:\u002F\u002Felement.io\u002Fblog\u002Fexploring-matrixrtc-real-time-communication-in-rooms\u002F)).\n4. **Invisible Encryption** — eliminating the infamous \"Unable to Decrypt\" errors.\n\nAs of September 2026 the Spec Core Team was \"aiming to cut\" the formal 2.0 release\n([TWIM 14 Aug 2026](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F08\u002F14\u002Fthis-week-in-matrix-2026-08-14\u002F));\nElement X clients were shipping 2.0 features incrementally (QR login, user status, live location).\n\n**Federation stats (July 2026)**: ~19,512 known federating servers, **78.8% of them running\nSynapse** — the federation's diversity problem in one number.\n\n---\n\n## 3. The ecosystem: organisations, money, and who's maintaining what (verified)\n\n### 3.1 The corporate split\n- **Matrix.org Foundation** owns the protocol, spec, and matrix.org homeserver; charity, funded by\n  memberships + donations + events + (new in late 2025) **premium accounts on matrix.org**.\n- **Element** (formerly New Vector) is the startup founded by Matrix's creators; employs most of\n  the core engineering: Synapse, MAS, the Rust\u002FJS SDKs, Element clients, and the matrix.org\n  infrastructure itself.\n- Per the Foundation's **first public annual report (published March 2026,\n  [blog](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F03\u002Fannual-report\u002F) ·\n  [PDF](https:\u002F\u002Fwww.matrix.org\u002Ffoundation\u002Freports\u002F2025%20Public%20Annual%20Report.pdf))**:\n  FY2025 revenue +38%, deficit cut from £910,821 to £310,596; **Automattic's Gold membership alone\n  = 50% of revenue**; the report calls the dependence on Element's in-kind donations\n  \"unsustainable\". Earlier milestones: the Feb 2025 [\"crossroads\" post](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2025\u002F02\u002Fcrossroads\u002F)\n  ($610K shortfall; public Slack\u002FXMPP\u002FIRC bridges shut), June 2025\n  [matrix.org freemium](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2025\u002F06\u002Ffunding-homeserver-premium\u002F).\n\n### 3.2 Homeserver implementations\n- **Synapse** (Python, increasingly Rust components — client-event serialisation and DB access\n  were ported by mid-2026; v1.159-era release candidates marched toward room **v12 as default**):\n  the production reference server. Worker-sharded, Postgres-backed, the hardest and most rewarding\n  to run at scale.\n- **Continuwuity** ([site](https:\u002F\u002Fcontinuwuity.org\u002Fintroduction) ·\n  [GitHub mirror](https:\u002F\u002Fgithub.com\u002Fcontinuwuity\u002Fcontinuwuity)): community Rust homeserver,\n  forked from the archived **conduwuit**, with weekly-ish releases; easy on modest hardware.\n  Fork drama worth knowing: conduwuit's archived README disputes continuwuity's \"official\n  successor\" claim and endorses **Tuwunel** instead — as an operator, evaluate both; migrations\n  are conduwuit→continuwuity only (no Synapse\u002FDendrite path).\n- **Dendrite** (Go, second-generation reference) has been in a semi-dormant state since Element\n  moved it to the Foundation; do not plan new deployments on it without checking current status.\n- Others: Conduit (original Rust project, moribund), Grapevine (stalled).\n\n### 3.3 Clients and bridges\n- **Element X** (iOS\u002FAndroid on matrix-rust-sdk — the strategic client), Element Web\u002FDesktop\n  (classic, on matrix-js-sdk), plus the long tail (FluffyChat, Fractal, Cinny, Nheko…).\n- Bridges live on the **Application Service API**: the **mautrix** family (Telegram, WhatsApp,\n  Signal, Messenger, Slack, Discord…) — Beeper open-sourced its bridge stack; Beeper and Texts\n  are now Automattic's (2023–24 acquisitions) — plus hookshot (GitHub\u002Ffeeds) and matrix-admin\n  tooling. Note the Foundation killed the *public* Slack\u002FXMPP\u002FIRC bridges in its 2025 cost cuts;\n  self-hosted bridges are unaffected.\n\n### 3.4 The sovereignty wave (verified; the most important customer story in private chat)\n- **Germany**: BwMessenger for the Bundeswehr (since Nov 2020, 100k+ active users, BSI-certified\n  for VS-NfD) and **BundesMessenger** for the wider public sector (~250,000 users across\n  municipalities, agencies, fire services; private federation, BSI-hardened, audited)\n  ([Element case study](https:\u002F\u002Felement.io\u002Fen\u002Fcase-studies\u002Fbundeswehr) ·\n  [Matrix Conf slides Oct 2025](https:\u002F\u002F2025.matrix.org\u002Fslides\u002Fslides_9HKYHA.pdf)). Plus\n  TI-Messenger for healthcare and openDesk at ZenDiS.\n- **France**: Tchap (300k+ public-sector users) and La Suite Numérique, built on Matrix; Olvid\n  separately holds the cabinet-level mandate (→ `chat-the-wider-field`).\n- **NATO**: NI2CE Messenger (NATO-branded Element fork) via NATO ACT experimentation; **UNICC**\n  selected Element (2024); live deployments also credited to US DoD (since 2020), UK MoD, Polish\n  and Ukrainian armed forces ([Element's Digital Sovereignty Summit post, Nov 2025](https:\u002F\u002Felement.io\u002Fblog\u002Felement-at-the-summit-on-european-digital-sovereignty\u002F) ·\n  [Computer Weekly, Oct 2025](https:\u002F\u002Fwww.computerweekly.com\u002Fnews\u002F366633894\u002FEuropean-governments-opt-for-open-source-alternatives-to-Big-Tech-encrypted-communications)).\n- Catalysts: US sanctions on the ICC, the March 2025 \"Signalgate\" scandal, and a broad European\n  digital-sovereignty push (Merz and Macron keynoted the Berlin summit Element attended).\n  France and Germany are even discussing interoperating their national messengers.\n- Element's commercial arm is **Element Server Suite (ESS)** — a Kubernetes distribution of the\n  stack (Synapse+workers, MAS, Element Web\u002FX, LiveKit, bridges, admin console) with a paid Secure\n  tier; Sweden's Försäkringskassan, NATO ACT, UNICC and the EC are credited with\n  subscription-based procurement commitments.\n\n---\n\n## 4. Operator handbook: running a homeserver (the perspective nobody else can offer)\n\n### 4.1 Sizing honestly\n- Personal\u002Ffriends server (\u003C50 users): a $6 VPS runs Continuwuity or even Synapse comfortably.\n  Synapse RAM pressure comes from *joining big federated rooms*, not your user count — federation\n  state, not messages, is the resource hog.\n- Community (1–5k users): Synapse on 4–8 vCPU\u002F16–32 GB with Postgres on SSD, media on object\n  storage\u002FCF cache; split out `media_repo` and `federation_sender` workers early.\n- Institutional: ESS on Kubernetes, or Synapse with full worker separation (sync, client reader,\n  federation reader\u002Fsender, event persisters, media, background, pusher, appservice) behind a\n  smart reverse proxy; Postgres HA; TURN (coturn) + LiveKit for calls.\n\n### 4.2 The ops chores that actually burn people\n1. **Postgres tuning & state compression** — `state_groups_state` grows without bound; run the\n   rust-synapse-compress-state tool routinely; mind autovacuum.\n2. **Media discipline** — set retention (`media_retention: local_media_lifetime`,\n   remote_media_lifetime) or watch disk forever; consider matrix-media-repo for dedup\u002FCDN.\n3. **Key custody** — your server signing keys *are* your identity in federation. Lose them and\n   you rejoin every room. Back them up; rotate carefully (old keys must be kept published for\n   history validation).\n4. **`server_name` vs server** — use delegation (`.well-known`) so user IDs live on the apex\n   domain (alice@example.org) while Synapse runs at matrix.example.org. You cannot cleanly change\n   server_name later. This is the #1 forever-decision.\n5. **Backups that restore** — Postgres dumps + media store + MAS DB + signing keys + TURN creds;\n   *test* restores. E2EE rooms are client-side anyway (4S recovery keys per user — train users on\n   recovery keys or accept UTD \"can't decrypt\" tickets).\n6. **Federation hygiene** — room ACLs against abusive servers, `m.room.server_acl` events, and\n   subscribing to community policy lists.\n\n### 4.3 Moderation under (mostly) E2EE\nOn Matrix, E2EE means moderators can't read encrypted content they're not sent — but moderation\nis *infrastructure + policy*, not content scanning:\n- policy-list subscriptions (**Draupnir** is the successor to Mjolnir — moderation bot watching\n  shared ban lists), server ACLs, joins-by-knocking\u002Finvite, power levels, slow mode, redactions,\n  report forwarding to server admins, and deactivation flows. Public unencrypted rooms are fully\n  visible to their homes' admins; homeserver operators bear legal duties for what they host —\n  EU-facing communities have DSA obligations worth a compliance read.\n- Trust & Safety is real labour: the Foundation's report counts moderation at ~30% on top of the\n  matrix.org homeserver's infra cost (~20% of total spend) — one reason Premium exists.\n\n### 4.4 Legal exposure checklist (operator)\nyou become a CDN *and* a postmaster: retention law in your jurisdiction, lawful-request process\n(write one before you need it), CSAM hash-matching duties for public unencrypted content,\ncopyright complaints, sanctions screening for hosted communities, and GDPR data maps (encrypted\nevents still carry metadata and IPs in logs — rotate those logs).\n\n### 4.5 Cheat: don't self-host\nElement's hosted offerings \u002F ESS Community, etke.cc, un-hooked \"matrix for hire\" providers —\nfine for communities that want sovereignty-lite without the on-call.\n\n### 4.6 The honest privacy critique\nFederation sprays *metadata* widely: every server in a room learns membership, timing and the\nsocial graph of everyone in it; E2EE protects content only. Retention defaults are\n\"keep forever\". For dissident-grade threat models, Matrix federation metadata is a real exposure —\nSimpleX\u002FSession\u002FBriar exist for a reason (→ `chat-the-wider-field`).\n\n---\n\n## 5. Developer perspective\n\n- **APIs that make it programmable**: the **Client-Server API** (sync, send, E2EE, push),\n  the **Application Service API** (bridges\u002Fbots with puppeted users), **Widgets**, and the\n  server-admin APIs. Spec is open; MSCs are public — you can *propose protocol changes yourself*\n  (that's a real differentiator vs. Signal\u002FWhatsApp).\n- **SDKs**: `matrix-rust-sdk` (drives Element X; UniFFI bindings into Swift\u002FKotlin, JS via WASM),\n  `matrix-js-sdk` (web-classic), community libs (matrix-nio Python, mautrix-go for bridge-grade\n  bots, Trixnity Kotlin…).\n- **Build-a-bot in an afternoon**: mautrix-go's appservice framework or matrix-nio + asyncio is\n  the fastest route; for business bots, hookshot patterns give you webhooks→rooms.\n- **E2EE in your own client**: vodozemac via rust-sdk crypto crate — cross-signing, key backup,\n  and verification UX are the hard 80%, all solved for you if you stay on the SDK.\n- **Custom real-time**: MatrixRTC SDK \"slots\" turn rooms into live shared state for games\u002Fapps —\n  watch this space through 2026–27.\n- **Governance literacy**: read the current room version, MSC status and SCT notes before\n  building on anything experimental (sliding sync extensions, MSC4505 push for knock\u002Flive\n  location, etc.). The\n  [This Week in Matrix](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F08\u002F14\u002Fthis-week-in-matrix-2026-08-14\u002F)\n  newsletter is the ecosystem's heartbeat.\n\n---\n\n## 6. Verdict\n\nMatrix in 2026 is what email's federation wanted to grow up to be: messy, expensive, politically\nessential. If your brief is \"we control our infrastructure and our legal jurisdiction,\" it is —\nstill, uniquely — the only serious answer among messengers. The costs land on operators and the\nFoundation (see the annual report); the benefits land on Europe's governments and everyone who\nrejects single-company trust.\n\n---\n\n## Sources (this file)\n\n- Matrix 2.0: [official announcement (29 Oct 2024)](https:\u002F\u002Fwww.matrix.org\u002Fblog\u002F2024\u002F10\u002F29\u002Fmatrix-2.0-is-here\u002F)\n- This Week in Matrix: [3 Jul 2026 (MSC4186 accepted; 19,512 servers; Synapse 78.8%)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F07\u002F03\u002Fthis-week-in-matrix-2026-07-03\u002F) ·\n  [17 Jul 2026 (Synapse rustification, MSC4504)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F07\u002F17\u002Fthis-week-in-matrix-2026-07-17\u002F) ·\n  [14 Aug 2026 (room v12 march, Element X v26.08, SCT release intent)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F08\u002F14\u002Fthis-week-in-matrix-2026-08-14\u002F)\n- MatrixRTC: [Element blog, FOSDEM 2026 talk (19 Feb 2026)](https:\u002F\u002Felement.io\u002Fblog\u002Fexploring-matrixrtc-real-time-communication-in-rooms\u002F)\n- Foundation finances: [Annual report blog (Mar 2026)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2026\u002F03\u002Fannual-report\u002F) ·\n  [FY2025 Public Annual Report (PDF)](https:\u002F\u002Fwww.matrix.org\u002Ffoundation\u002Freports\u002F2025%20Public%20Annual%20Report.pdf) ·\n  [\"We're at a crossroads\" (Feb 2025)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2025\u002F02\u002Fcrossroads\u002F) ·\n  [Premium accounts (Jun 2025)](https:\u002F\u002Fmatrix.org\u002Fblog\u002F2025\u002F06\u002Ffunding-homeserver-premium\u002F)\n- Deployments: [Element Bundeswehr case study](https:\u002F\u002Felement.io\u002Fen\u002Fcase-studies\u002Fbundeswehr) ·\n  [BundesMessenger Matrix Conf slides (Oct 2025)](https:\u002F\u002F2025.matrix.org\u002Fslides\u002Fslides_9HKYHA.pdf) ·\n  [Computer Weekly (31 Oct 2025)](https:\u002F\u002Fwww.computerweekly.com\u002Fnews\u002F366633894\u002FEuropean-governments-opt-for-open-source-alternatives-to-Big-Tech-encrypted-communications) ·\n  [Element Digital Sovereignty Summit post (18 Nov 2025)](https:\u002F\u002Felement.io\u002Fblog\u002Felement-at-the-summit-on-european-digital-sovereignty\u002F) ·\n  [Element government positioning post (25 Mar 2025)](https:\u002F\u002Felement.io\u002Fblog\u002Fadvancing-secure-convenient-government-communications-the-case-for-element\u002F)\n- Homeservers: [Continuwuity](https:\u002F\u002Fcontinuwuity.org\u002Fintroduction) ·\n  [continuwuity GitHub mirror](https:\u002F\u002Fgithub.com\u002Fcontinuwuity\u002Fcontinuwuity) ·\n  [archived conduwuit repo (successor dispute)](https:\u002F\u002Fgithub.com\u002Fgirlbossceo\u002Fconduwuit\u002F)\n- vodozemac, matrix-* sdks, mautrix: stable fundamentals from public repos (Element\u002Fmatrix-org and\n  mautrix GitHub orgs); no dated claims relied upon here.\n",{"name":5,"description":7},"develop","ae32736a1aabddabca5d2c96d665aa0ebc7d8700","src\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fprivate-chat-engines\u002Fskills\u002Fchat-matrix-and-element",3,"https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey","https:\u002F\u002Fthe-vibey-project.github.io\u002Fvibey\u002F","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project","https:\u002F\u002Fvibewithadam.matthewsteinberger.com","freedom for software engineers","2026-11-15 05:47:42",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add the-vibey-project\u002Fvibey --skill chat-matrix-and-element",{"tool":40,"command":41},"bunx","bunx skills add the-vibey-project\u002Fvibey --skill chat-matrix-and-element",{"tool":43,"command":44},"pnpm","pnpm dlx skills add the-vibey-project\u002Fvibey --skill chat-matrix-and-element","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fprivate-chat-engines\u002Fskills\u002Fchat-matrix-and-element\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7AT1FQJAE1FQYAMDTF490Y4","white-paper-writing","Use when writing white papers, technical reports, policy documents, thought leadership pieces, or any long-form authoritative document. Triggers on requests to write, structure, outline, or review white papers, technical reports, position papers, policy briefs, or evidence-driven arguments. Also use for B2B content marketing strategy, technical documentation requiring authority, academic-style reports, or any document that must educate while persuading. Use when someone asks \"how should I structure this\" for a long-form document.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fwhite-paper-writing\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7AT16BJRJJKK2MASXRZS76G","prose-technical-mechanics","Use when editing or writing prose at a technical\u002Fmechanical level: choosing between Anglo-Saxon and Latinate diction, placing information in topic vs stress positions, writing periodic vs cumulative sentences, handling sentence rhythm, punctuation as logic, transitions, paragraph structure, or phonesthetics. Use when someone wants to understand WHY prose works or doesn't, not just surface-level style advice. Triggers on word choice, sentence structure, emphasis, rhythm, diction, or any deep writing mechanics question.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fprose-technical-mechanics\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7AT0W9HT0ZZ9Y287NW99MR3","prose-mechanics","Use when writing, editing, or analyzing prose style; when trying to avoid generic AI-sounding writing; when applying specific prose styles such as journalistic, academic, narrative, KJV biblical, Hemingway plain, Latinate\u002FJamesian, Orwellian, Augustan, Victorian, Early Modern (Bacon, Browne, Milton), or free indirect discourse; or when coaching someone on writing voice and mechanics. Triggers on any request to improve, analyze, or write in a specific prose style, to fix \"AI-sounding\" writing, to make prose more vivid or concrete, to vary sentence rhythm, or to understand how a particular writer achieves their effects.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fprose-mechanics\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7AT0KR635JX66X2X6F3E2CP","narrative-structure","Use when structuring stories, pitches, presentations, white papers, or any persuasive narrative; analyzing the hero's journey in fiction or non-fiction; applying StoryBrand for business communication; designing narrative arcs for thought leadership; or understanding Vogler, Snyder, Propp, or Campbell frameworks. Triggers on any narrative structure, storytelling, pitch structure, StoryBrand, hero's journey, three-act structure, Freytag, Save the Cat, narrative arc, or \"how should I structure this story\u002Fpitch\u002Fpresentation\" request.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fnarrative-structure\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7AT0AKGW09NKKZDYBT8VRDE","legal-brief-writing","Use when writing legal briefs, motions, or any court filing; when analyzing judicial cognition and persuasion; when applying elite brief-writing techniques from Roberts, Clement, Kagan, Garner; or when structuring legal arguments for maximum persuasion. Also use for autistic\u002Fneurodivergent advocates who need to understand how their natural communication style maps to elite legal advocacy. Triggers on any legal writing, brief drafting, motion preparation, or legal argument structuring request.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Flegal-brief-writing\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7AT00VWPS4Q8B5VEMXX9NQT","journal-publishability-criteria","Use whenever a research paper, article or preprint is being written, revised, reviewed or published, and specifically before every publication of docs\u002Fpaper.md. Covers what legitimate journals actually gate on, in order of gating — the editor's desk screen (scope, novelty, package problems), what reviewers judge (methodological soundness, claims the evidence can carry, statistical and qualitative reporting), EQUATOR reporting guidelines, the ICMJE authorship criteria, COPE's view of text recycling, the near-universal generative-AI policy (no AI author, disclosure, author responsibility), TOP 2025 transparency standards, how to verify a journal is legitimate, submitting without an institution, and a pre-submission checklist. Triggers on requests to evaluate, review, prepare or submit a paper, to judge publishability, to write a declarations or data-availability section, to disclose AI use, or to check a journal.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fjournal-publishability-criteria\u002FSKILL.md",[],[]]