[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ASFAP609TE4ZMGEYA9PJAX":3,"skill-same:01M7ASFAP609TE4ZMGEYA9PJAX":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},"01M7ASFAP609TE4ZMGEYA9PJAX","tor-building-on-tor-software-patterns",null,"Use when writing code that talks to Tor — SOCKS with socks5h and stream isolation, the control port, ephemeral onion services via ADD_ONION or stem, long-lived onion services in torrc, client authorization v3, Onion-Location and Alt-Svc headers, torsocks and its limits, embedding Arti, testing against a private chutney network, and building your own private or custom onion-routing network. Covers §13.1–§13.4, §13.6 and handbook §1. Companion to the other Tor and onion-network 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\u002Ftor-and-onion-networks\u002Fskills\u002Ftor-building-on-tor-software-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: tor-building-on-tor-software-patterns\ndescription: \"Use when writing code that talks to Tor — SOCKS with socks5h and stream isolation, the control port, ephemeral onion services via ADD_ONION or stem, long-lived onion services in torrc, client authorization v3, Onion-Location and Alt-Svc headers, torsocks and its limits, embedding Arti, testing against a private chutney network, and building your own private or custom onion-routing network. Covers §13.1–§13.4, §13.6 and handbook §1. Companion to the other Tor and onion-network skills.\"\n---\n\n# Building on Tor: Software Patterns\n\n> **Part 7 of 8** of the *Tor and Onion Networks* reference (plugin `tor-and-onion-networks`),\n> covering §13.1–§13.4, §13.6 and handbook §1. Sibling skills:\n> `tor-protocol-circuits-and-cell-cryptography` (§1–§5),\n> `tor-network-consensus-guards-and-paths` (§6–§7),\n> `tor-onion-services-and-hardening` (§8–§9),\n> `tor-censorship-circumvention-and-bridges` (§10),\n> `tor-attack-literature-and-threat-model` (§11),\n> `tor-ecosystem-alternatives-and-governance` (§12, §14–§16),\n> `tor-running-relays-bridges-and-hardware` (§13.5 and handbook §2–§6).\n> Section numbers are shared across the set; a reference written as §N → `skill` points into\n> that sibling skill.\n>\n> **Currency:** compiled 16 September 2026. Config options checked against C tor **0.4.9.x**\n> (stable since Feb 2026) and Arti **2.6.x** (Sept 2026). When in doubt: `man tor`,\n> \u003Chttps:\u002F\u002Fcommunity.torproject.org\u002F>, \u003Chttps:\u002F\u002Fonionservices.torproject.org\u002F>.\n\n> **⚠️ Five patterns cover essentially all software built on Tor. Pick the one that matches\n> your assurance requirement, not the one that is least work.**\n>\n> **⚠️ GOTCHA** boxes mark where the obvious approach silently leaks.\n>\n> **The three ideas that organize this document:**\n> 1. **⚠️ `socks5h`, NOT `socks5`** (§13.1). **The `h` makes the *exit* resolve the hostname.\n>    Without it you do a local DNS lookup for the destination you are trying to hide — the\n>    single most common Tor-integration leak, and it fails silently.**\n> 2. **⚠️ STREAM ISOLATION IS A PRODUCT DECISION, NOT A TUNING KNOB** (§13.1). **SOCKS\n>    username\u002Fpassword pairs become isolation tokens, so distinct credentials get distinct\n>    circuits. That is how you stop two tenants, or two identities, sharing an exit.**\n> 3. **⚠️ EPHEMERAL SERVICES BEAT FILESYSTEM KEYS FOR MOST APPS** (§13.2). **`ADD_ONION\n>    NEW:ED25519-V3 Flags=DiscardPK` keeps the key in memory only and dies with the process.\n>    OnionShare, Ricochet Refresh and Briar all work this way — no key management, no torrc\n>    edits, nothing on disk to seize.**\n\n---\n\n## §13. The five patterns\n\nConceptually, building on Tor falls into five patterns:\n\n1. **SOCKS-integrated apps** — the minimal, safest pattern: point your app at tor's SocksPort\n   (127.0.0.1:9050; 9150 for Tor Browser) using `socks5h` so DNS resolves *at the exit*. Add\n   stream-isolation credentials per tenant\u002Fconnection class.\n2. **Ephemeral onion services** — your app speaks `ADD_ONION NEW:ED25519-V3` to the control\n   port, publishes a one-shot service, and tears it down on exit.\n3. **Long-lived onion services** — torrc `HiddenServiceDir`\u002F`HiddenServicePort`, optionally\n   client auth, offline master keys, PoW, Onionbalance backends, and Onion-Location\u002FAlt-Svc on\n   the clearnet twin.\n4. **Embedding Tor** — ship tor\u002FArti as a library (arti-client crate, Tor.framework,\n   IPtProxy\u002Ftor-android, onionmasq for VPN-style capture) inside your product.\n5. **Network-layer building** — relays, bridges, exits, transparent-proxy gateways, two-box\n   isolation. See §13.5 → `tor-running-relays-bridges-and-hardware`.\n\nBuilding your *own* network — rather than building on Tor — is a different decision tree with\nits own three options: §13.6.\n\n---\n\n## §13.1 The SOCKS interface (the boring, correct way)\n\n- C tor default: `127.0.0.1:9050`. Tor Browser: `9150`.\n- **Always use `socks5h` \u002F `--socks5-hostname`** so name resolution happens *at the exit* —\n  otherwise you resolve DNS locally and leak the destination.\n\n```bash\n# Verify egress + get your exit IP (official oracle):\ncurl --socks5-hostname 127.0.0.1:9050 https:\u002F\u002Fcheck.torproject.org\u002Fapi\u002Fip\n# → {\"IsTor\":true,\"IP\":\"\u003Cexit-address>\"}\n\n# Per-connection stream isolation: SOCKS username\u002Fpassword become isolation tokens\n# (IsolateSOCKSAuth is default). Two different credentials → two different circuits.\ncurl --socks5 127.0.0.1:9050 --proxy-user tenant-a:pw https:\u002F\u002Fexample.org\ncurl --socks5 127.0.0.1:9050 --proxy-user tenant-b:pw https:\u002F\u002Fexample.org\n```\n\n```python\n# Python; needs requests[socks]\nimport requests\ns = requests.Session()\ns.proxies = {\"http\": \"socks5h:\u002F\u002F127.0.0.1:9050\", \"https\": \"socks5h:\u002F\u002F127.0.0.1:9050\"}\nprint(s.get(\"https:\u002F\u002Fcheck.torproject.org\u002Fapi\u002Fip\").json())\n```\n\nStream isolation flags you should know (apply per `SocksPort` line):\n\n```\nSocksPort 9050 IsolateDestAddr IsolateDestPort   # one circuit per destination host+port\nSocksPort 9062                                    # dedicated port for one app = hard isolation\n```\n\n### Per-site circuits in your own tooling\n\nTor Browser isolates streams per first-party domain. Replicate the idea in services: distinct\nSOCKS credentials per logical tenant, or `NEWNYM`-driven circuit freshening via the control\nport for long batch jobs.\n\n> **⚠️ GOTCHA:** `SIGNAL NEWNYM` is rate-limited to roughly once per 10 seconds, and **it does\n> not reset your guards** (by design — see §7.1 → `tor-network-consensus-guards-and-paths`).\n> Use isolation credentials when you can; NEWNYM is the blunt instrument.\n\n---\n\n## §13.2 The control port and ephemeral onion services\n\nEnable the controller (Debian\u002FUbuntu pattern):\n\n```\nControlPort 9051\nCookieAuthentication 1\nCookieAuthFileGroupReadable 1     # then: sudo usermod -aG debian-tor youruser\n```\n\n**Ephemeral onion service** — no torrc edits, keys live only in memory (this is the\nOnionShare \u002F Ricochet Refresh pattern). With **stem** (`pip install stem`; unmaintained since\n~2020 but still the canonical library — see §12.3 →\n`tor-ecosystem-alternatives-and-governance`):\n\n```python\nfrom stem.control import Controller\n\nwith Controller.from_port(port=9051) as ctl:\n    ctl.authenticate()  # reads the cookie automatically\n    svc = ctl.create_ephemeral_hidden_service(\n        {80: (\"127.0.0.1\", 8000)},   # onion :80 -> local 8000\n        await_publication=True,\n    )\n    print(f\"http:\u002F\u002F{svc.service_id}.onion\")\n    # keep the controller connection open; the service dies when it closes\n    input(\"Serving. Press enter to tear down.\\n\")\n```\n\nRaw protocol equivalent (useful when porting to other languages — spec: `control-spec.txt`):\n\n```\nAUTHENTICATE \u003Ccookie-hex>\nADD_ONION NEW:ED25519-V3 Flags=DiscardPK Port=80,127.0.0.1:8000\n```\n\n`Flags=DiscardPK` tells tor *not* to return the private key (service unrecoverable by design).\nAsync alternatives: **txtorcon** (Twisted, most battle-tested for services), **aiostem**\n(asyncio).\n\n---\n\n## §13.3 Long-lived onion services (torrc)\n\n```\nHiddenServiceDir \u002Fvar\u002Flib\u002Ftor\u002Fmysvc\u002F\nHiddenServiceNumIntroductionPoints 3\nHiddenServicePort 80 127.0.0.1:8080        # onion :80 -> local web app\n#HiddenServicePort 443 unix:\u002Frun\u002Fmysvc.sock # unix sockets supported\n```\n\n- Address and keys appear under `HiddenServiceDir` (`hostname` file holds the 56-char\n  address). Permissions must be `0700`, owned by the tor user.\n- **Offline master keys**: generate the `hs_ed25519_secret_key` on an offline machine\n  (`tor --keygen` in a scratch datadir), archive the encrypted master, and deploy only the\n  signing material — a box compromise then doesn't compromise the address permanently.\n- **DoS hardening** (PoW, requires tor built with `--enable-gpl` for Equi-X\u002FHashX):\n\n```\nHiddenServicePoWDefensesEnabled 1\nHiddenServicePoWQueueRate 250\nHiddenServicePoWQueueBurst 2500\nMetricsPort 127.0.0.1:9035\nMetricsPortPolicy accept 127.0.0.1    # scrape tor_hs_pow_* with Prometheus\n```\n\n- **Client authorization v3** (private services): the server keeps an `authorized_clients\u002F`\n  directory inside `HiddenServiceDir`, one `\u003Cname>.auth` file per client containing\n  `descriptor:x25519:\u003Cbase32-pubkey-no-padding>`; each client adds a `\u003C56chars>.auth_private`\n  file (`\u003Caddr>.onion:descriptor:x25519:\u003Cbase32-priv>`) to its `ClientOnionAuthDir`. Generate\n  x25519 pairs with any standard crypto library and base32-encode the raw 32-byte keys per\n  `rend-spec-v3`.\n- **Load balancing**: run `HiddenServiceOnionbalanceInstance 1` on each backend pointing at\n  the Onionbalance master.\n\n> **⚠️ GOTCHA (as of 2026): PoW and Onionbalance don't mix.** Choose per threat model — DoS\n> resistance on a single instance, or horizontal scale across backends. See §9.2–§9.3 →\n> `tor-onion-services-and-hardening`.\n\n---\n\n## §13.4 Advertising the onion from your clearnet site\n\n```nginx\n# nginx — Tor users get the \".onion available\" pill (Tor Browser ≥ 9.5)\nadd_header Onion-Location http:\u002F\u002F\u003Cyour56>.onion$request_uri;\n\n# transparent variant: Tor-capable clients switch to onion silently\nadd_header Alt-Svc 'h2=\"\u003Cyour56>.onion:443\"; ma=86400';\n```\n\nServe these over HTTPS from the clearnet origin only (**never** from the onion itself).\n\n---\n\n## §13.4a Non-SOCKS apps: torsocks and its honest limits\n\n```\ntorsocks curl https:\u002F\u002Fcheck.torproject.org\u002Fapi\u002Fip\n```\n\ntorsocks is `LD_PRELOAD` shimming: TCP only, breaks on apps using raw syscalls, no UDP, and it\n*silently* does nothing for apps that bypass libc (statically linked Go\u002FRust binaries).\n\n> **⚠️ GOTCHA — this is the dangerous one.** A statically linked binary under `torsocks`\n> connects **directly**, with no error and no warning. Rule of thumb: **torsocks for\n> convenience, never for high-stakes assurance.** For assurance, use app-native SOCKS or a\n> fail-closed network sandbox (§13.5 → `tor-running-relays-bridges-and-hardware`, §4.3–4.4).\n> `proxychains` shares the architecture *and* the caveats, with worse defaults.\n\n---\n\n## §13.4b Arti as a library and daemon\n\nArti (Rust) is the future embedding path: no fork of an external process, memory safety, and —\nsince 1.8.0 (Dec 2025) — production-grade onion services with native vanguards.\n\n```toml\n# ~\u002F.config\u002Farti\u002Farti.toml  (minimal client)\n[proxy]\nsocks_listen = \"127.0.0.1:9150\"\ndns_listen = \"127.0.0.1:15354\"\n```\n\n```rust\n\u002F\u002F embedding: arti-client = \"0...\" (API churned through 2.x — pin + read changelog)\nuse arti_client::{TorClient, TorClientConfig};\n\nlet tor = TorClient::create_bootstrapped(TorClientConfig::default()).await?;\nlet stream = tor.connect((\"check.torproject.org\", 443)).await?;\n```\n\nC-tor → Arti service migration: `arti hsc ctor-migrate` (2.x) ports hidden-service keys. Watch\nthe `arti hss` tooling and Arti RPC — both are the fast-moving surface in 2026. **onionmasq**\n(from the Tor VPN project) gives you a userspace TUN interface over Arti: route whole\napplications without them knowing.\n\n---\n\n## §13.4c Developing against a test network: chutney\n\n**Never integration-test against the production network.** Chutney runs a private mini-Tor on\nlocalhost:\n\n```bash\ngit clone https:\u002F\u002Fgitlab.torproject.org\u002Ftpo\u002Fcore\u002Fchutney.git\ncd chutney\n.\u002Fchutney configure networks\u002Fbasic\n.\u002Fchutney start    networks\u002Fbasic\n.\u002Fchutney verify   networks\u002Fbasic\n.\u002Fchutney status   networks\u002Fbasic   # shows per-node SOCKS\u002FControl ports to point tests at\n```\n\n---\n\n## §13.6 Building your own private network\n\n\"I want a private network\" almost always resolves to one of three architectures, separated by\ntwo orders of magnitude of effort. Pick before you build.\n\n| Option | What it is | When it is right |\n|---|---|---|\n| **A — public Tor + v3 onion services with client authorization** | Your services are onion services on the public network; only holders of a client key can see them | Almost every real case: organizational privacy, private infrastructure, SecureDrop- and OnionShare-style deployments |\n| **B — your own Tor network** | Your own directory authorities, relays and clients, isolated from public Tor | Testing, research, or a closed organizational network that must not touch public Tor at all |\n| **C — a custom onion routing network** | Tor-like software of your own, with different trade-offs | Research, or a genuinely different threat model (§13.6.3) |\n\n### §13.6.1 Option A — use the public Tor network (the right answer for most cases)\n\nRun a tor client on your server, configure a `HiddenServiceDir` with client authorization\n(§13.3), distribute `.auth_private` files to your authorized users, and let them connect via\nTor Browser or a Tor-integrated application. The service is invisible to anyone without a\nclient key. You get location-anonymous hosting, encryption by construction, authentication of\n*both* directions, and the whole public relay set — without operating any of it. Add PoW for\nDoS resistance and vanguards for guard-discovery resistance (§9 →\n`tor-onion-services-and-hardening`). This is what SecureDrop and OnionShare do.\n\n> **⚠️ GOTCHA:** running your own network *reduces* your anonymity set. On public Tor your\n> traffic hides among several million daily users; on a twenty-relay private network,\n> \"someone used the network\" is a much smaller set, and its operator knows who the\n> participants are. Isolation from public Tor is an availability and control property, not an\n> anonymity upgrade — choose B or C because you need control, never because you want more\n> anonymity than A gives you.\n\n### §13.6.2 Option B — run your own Tor network (chutney, and past it)\n\nChutney is not only a test harness (§13.4c). `networks\u002Fbasic` is a complete miniature Tor —\n**3 directory authorities plus relays and clients** — and a custom network definition is how\nyou grow one:\n\n```bash\n.\u002Fchutney configure networks\u002Fbasic   # 3 authorities + relays + clients\n# For a larger private network, write a custom network definition with your own\n# authorities, relays and exits. Each node gets its own torrc and data directory.\n```\n\nFor a *production* private network you need: **at least 3 directory authorities**, run on\ndifferent infrastructure in different locations; a sufficient number of relays for bandwidth\nand redundancy; your own consensus process (your authorities vote hourly exactly as public\nTor's nine do — §6.2 → `tor-network-consensus-guards-and-paths`); and client software\nconfigured to use *your* authorities instead of the public ones. It is a substantial\nundertaking, and what it buys is complete control over who participates. Operator mechanics\nand the verification checklist: handbook §2 and §5 →\n`tor-running-relays-bridges-and-hardware`.\n\n### §13.6.3 Option C — build a custom onion routing network\n\nIf you want something Tor-like with different trade-offs — different circuit lengths, guard\nstrategies, crypto — four core components have to exist; onion services are optional:\n\n1. **Relay software.** Authenticates to neighbours (ed25519 identities), accepts\n   circuit-building commands, performs onion encryption\u002Fdecryption on relay cells (§3 →\n   `tor-protocol-circuits-and-cell-cryptography`).\n2. **Directory system.** Some mechanism for clients to discover relays — Tor's nine\n   hourly-voting authorities, a single trusted directory server, a threshold-signature scheme,\n   a DHT, a blockchain. The two properties that matter whatever you pick: **clients must get a\n   consistent view of the relay set**, and **an attacker must not be able to inject relays\n   cheaply**.\n3. **Path selection.** Three relays subject to constraints (no shared operator, no shared\n   subnet, exit policy permits the destination), guards pinned for months (§7 →\n   `tor-network-consensus-guards-and-paths`). The algorithm *is* the anonymity property.\n4. **Client software.** Telescoping circuit construction, guard state, a SOCKS interface,\n   stream isolation (§13.1).\n5. **Onion services (optional).** Introduction points, descriptor publication to HSDirs,\n   rendezvous points, client authorization, and a key-derived self-authenticating address\n   (§8 → `tor-onion-services-and-hardening`).\n\n> **⚠️ KEY DESIGN PARAMETERS.** Circuit length (3 is standard; more hops raise latency and\n> the attacker's cost together). Guard rotation period (months is standard; shorter raises\n> exposure probability). Directory trust model (authorities vs. DHT vs. blockchain). Crypto\n> primitives (ntor for the handshake; CGO or an AEAD for cells). Whether to support onion\n> services. Whether to support pluggable transports. Whether the network is **open** (anyone\n> joins) or **closed** (known participants only). These seven choices determine what your\n> network is; everything else is implementation.\n\nImplementation checklist:\n\n- **Use vetted cryptographic libraries** (libsodium, libsecp256k1) — never implement\n  primitives yourself.\n- **ntor or X25519 for the handshake** (§4.1 → `tor-protocol-circuits-and-cell-cryptography`).\n- **An AEAD for cell crypto** (ChaCha20-Poly1305 or AES-GCM). **Do not use CTR mode without\n  authentication** — malleability is exactly what enables tagging attacks (§4.2 →\n  `tor-protocol-circuits-and-cell-cryptography`). Note that Tor's own CGO is *not* a stock\n  AEAD: it needs a rugged PRP because relays must transform cells through a deliberately\n  malleable decrypt path. Reach for CGO only if you have that same constraint; otherwise a\n  standard AEAD per hop is the safer build.\n- **Guard pinning from day one** and **path restrictions (family, subnet) from day one** —\n  both are far harder to retrofit than to build in.\n- **Test against chutney-style adversarial scenarios** (§13.4c).\n- **Have a plan for relay discovery and Sybil resistance** before you have relays.\n- **Consider using Arti as a foundation rather than starting from zero** (§12.1 →\n  `tor-ecosystem-alternatives-and-governance`).\n\n---\n\n## Where to go next\n\n- Relays, bridges, exits, transparent proxies, hardware builds, verification and abuse\n  handling: §13.5 → `tor-running-relays-bridges-and-hardware`.\n- What a v3 onion service is actually doing underneath this configuration: §8 →\n  `tor-onion-services-and-hardening`.\n- Why `socks5h` matters — where the anonymity boundary actually sits: §3.3 →\n  `tor-protocol-circuits-and-cell-cryptography`.\n- Library and implementation choices: §12 → `tor-ecosystem-alternatives-and-governance`.\n","# Building on Tor: Software Patterns\n\n> **Part 7 of 8** of the *Tor and Onion Networks* reference (plugin `tor-and-onion-networks`),\n> covering §13.1–§13.4, §13.6 and handbook §1. Sibling skills:\n> `tor-protocol-circuits-and-cell-cryptography` (§1–§5),\n> `tor-network-consensus-guards-and-paths` (§6–§7),\n> `tor-onion-services-and-hardening` (§8–§9),\n> `tor-censorship-circumvention-and-bridges` (§10),\n> `tor-attack-literature-and-threat-model` (§11),\n> `tor-ecosystem-alternatives-and-governance` (§12, §14–§16),\n> `tor-running-relays-bridges-and-hardware` (§13.5 and handbook §2–§6).\n> Section numbers are shared across the set; a reference written as §N → `skill` points into\n> that sibling skill.\n>\n> **Currency:** compiled 16 September 2026. Config options checked against C tor **0.4.9.x**\n> (stable since Feb 2026) and Arti **2.6.x** (Sept 2026). When in doubt: `man tor`,\n> \u003Chttps:\u002F\u002Fcommunity.torproject.org\u002F>, \u003Chttps:\u002F\u002Fonionservices.torproject.org\u002F>.\n\n> **⚠️ Five patterns cover essentially all software built on Tor. Pick the one that matches\n> your assurance requirement, not the one that is least work.**\n>\n> **⚠️ GOTCHA** boxes mark where the obvious approach silently leaks.\n>\n> **The three ideas that organize this document:**\n> 1. **⚠️ `socks5h`, NOT `socks5`** (§13.1). **The `h` makes the *exit* resolve the hostname.\n>    Without it you do a local DNS lookup for the destination you are trying to hide — the\n>    single most common Tor-integration leak, and it fails silently.**\n> 2. **⚠️ STREAM ISOLATION IS A PRODUCT DECISION, NOT A TUNING KNOB** (§13.1). **SOCKS\n>    username\u002Fpassword pairs become isolation tokens, so distinct credentials get distinct\n>    circuits. That is how you stop two tenants, or two identities, sharing an exit.**\n> 3. **⚠️ EPHEMERAL SERVICES BEAT FILESYSTEM KEYS FOR MOST APPS** (§13.2). **`ADD_ONION\n>    NEW:ED25519-V3 Flags=DiscardPK` keeps the key in memory only and dies with the process.\n>    OnionShare, Ricochet Refresh and Briar all work this way — no key management, no torrc\n>    edits, nothing on disk to seize.**\n\n---\n\n## §13. The five patterns\n\nConceptually, building on Tor falls into five patterns:\n\n1. **SOCKS-integrated apps** — the minimal, safest pattern: point your app at tor's SocksPort\n   (127.0.0.1:9050; 9150 for Tor Browser) using `socks5h` so DNS resolves *at the exit*. Add\n   stream-isolation credentials per tenant\u002Fconnection class.\n2. **Ephemeral onion services** — your app speaks `ADD_ONION NEW:ED25519-V3` to the control\n   port, publishes a one-shot service, and tears it down on exit.\n3. **Long-lived onion services** — torrc `HiddenServiceDir`\u002F`HiddenServicePort`, optionally\n   client auth, offline master keys, PoW, Onionbalance backends, and Onion-Location\u002FAlt-Svc on\n   the clearnet twin.\n4. **Embedding Tor** — ship tor\u002FArti as a library (arti-client crate, Tor.framework,\n   IPtProxy\u002Ftor-android, onionmasq for VPN-style capture) inside your product.\n5. **Network-layer building** — relays, bridges, exits, transparent-proxy gateways, two-box\n   isolation. See §13.5 → `tor-running-relays-bridges-and-hardware`.\n\nBuilding your *own* network — rather than building on Tor — is a different decision tree with\nits own three options: §13.6.\n\n---\n\n## §13.1 The SOCKS interface (the boring, correct way)\n\n- C tor default: `127.0.0.1:9050`. Tor Browser: `9150`.\n- **Always use `socks5h` \u002F `--socks5-hostname`** so name resolution happens *at the exit* —\n  otherwise you resolve DNS locally and leak the destination.\n\n```bash\n# Verify egress + get your exit IP (official oracle):\ncurl --socks5-hostname 127.0.0.1:9050 https:\u002F\u002Fcheck.torproject.org\u002Fapi\u002Fip\n# → {\"IsTor\":true,\"IP\":\"\u003Cexit-address>\"}\n\n# Per-connection stream isolation: SOCKS username\u002Fpassword become isolation tokens\n# (IsolateSOCKSAuth is default). Two different credentials → two different circuits.\ncurl --socks5 127.0.0.1:9050 --proxy-user tenant-a:pw https:\u002F\u002Fexample.org\ncurl --socks5 127.0.0.1:9050 --proxy-user tenant-b:pw https:\u002F\u002Fexample.org\n```\n\n```python\n# Python; needs requests[socks]\nimport requests\ns = requests.Session()\ns.proxies = {\"http\": \"socks5h:\u002F\u002F127.0.0.1:9050\", \"https\": \"socks5h:\u002F\u002F127.0.0.1:9050\"}\nprint(s.get(\"https:\u002F\u002Fcheck.torproject.org\u002Fapi\u002Fip\").json())\n```\n\nStream isolation flags you should know (apply per `SocksPort` line):\n\n```\nSocksPort 9050 IsolateDestAddr IsolateDestPort   # one circuit per destination host+port\nSocksPort 9062                                    # dedicated port for one app = hard isolation\n```\n\n### Per-site circuits in your own tooling\n\nTor Browser isolates streams per first-party domain. Replicate the idea in services: distinct\nSOCKS credentials per logical tenant, or `NEWNYM`-driven circuit freshening via the control\nport for long batch jobs.\n\n> **⚠️ GOTCHA:** `SIGNAL NEWNYM` is rate-limited to roughly once per 10 seconds, and **it does\n> not reset your guards** (by design — see §7.1 → `tor-network-consensus-guards-and-paths`).\n> Use isolation credentials when you can; NEWNYM is the blunt instrument.\n\n---\n\n## §13.2 The control port and ephemeral onion services\n\nEnable the controller (Debian\u002FUbuntu pattern):\n\n```\nControlPort 9051\nCookieAuthentication 1\nCookieAuthFileGroupReadable 1     # then: sudo usermod -aG debian-tor youruser\n```\n\n**Ephemeral onion service** — no torrc edits, keys live only in memory (this is the\nOnionShare \u002F Ricochet Refresh pattern). With **stem** (`pip install stem`; unmaintained since\n~2020 but still the canonical library — see §12.3 →\n`tor-ecosystem-alternatives-and-governance`):\n\n```python\nfrom stem.control import Controller\n\nwith Controller.from_port(port=9051) as ctl:\n    ctl.authenticate()  # reads the cookie automatically\n    svc = ctl.create_ephemeral_hidden_service(\n        {80: (\"127.0.0.1\", 8000)},   # onion :80 -> local 8000\n        await_publication=True,\n    )\n    print(f\"http:\u002F\u002F{svc.service_id}.onion\")\n    # keep the controller connection open; the service dies when it closes\n    input(\"Serving. Press enter to tear down.\\n\")\n```\n\nRaw protocol equivalent (useful when porting to other languages — spec: `control-spec.txt`):\n\n```\nAUTHENTICATE \u003Ccookie-hex>\nADD_ONION NEW:ED25519-V3 Flags=DiscardPK Port=80,127.0.0.1:8000\n```\n\n`Flags=DiscardPK` tells tor *not* to return the private key (service unrecoverable by design).\nAsync alternatives: **txtorcon** (Twisted, most battle-tested for services), **aiostem**\n(asyncio).\n\n---\n\n## §13.3 Long-lived onion services (torrc)\n\n```\nHiddenServiceDir \u002Fvar\u002Flib\u002Ftor\u002Fmysvc\u002F\nHiddenServiceNumIntroductionPoints 3\nHiddenServicePort 80 127.0.0.1:8080        # onion :80 -> local web app\n#HiddenServicePort 443 unix:\u002Frun\u002Fmysvc.sock # unix sockets supported\n```\n\n- Address and keys appear under `HiddenServiceDir` (`hostname` file holds the 56-char\n  address). Permissions must be `0700`, owned by the tor user.\n- **Offline master keys**: generate the `hs_ed25519_secret_key` on an offline machine\n  (`tor --keygen` in a scratch datadir), archive the encrypted master, and deploy only the\n  signing material — a box compromise then doesn't compromise the address permanently.\n- **DoS hardening** (PoW, requires tor built with `--enable-gpl` for Equi-X\u002FHashX):\n\n```\nHiddenServicePoWDefensesEnabled 1\nHiddenServicePoWQueueRate 250\nHiddenServicePoWQueueBurst 2500\nMetricsPort 127.0.0.1:9035\nMetricsPortPolicy accept 127.0.0.1    # scrape tor_hs_pow_* with Prometheus\n```\n\n- **Client authorization v3** (private services): the server keeps an `authorized_clients\u002F`\n  directory inside `HiddenServiceDir`, one `\u003Cname>.auth` file per client containing\n  `descriptor:x25519:\u003Cbase32-pubkey-no-padding>`; each client adds a `\u003C56chars>.auth_private`\n  file (`\u003Caddr>.onion:descriptor:x25519:\u003Cbase32-priv>`) to its `ClientOnionAuthDir`. Generate\n  x25519 pairs with any standard crypto library and base32-encode the raw 32-byte keys per\n  `rend-spec-v3`.\n- **Load balancing**: run `HiddenServiceOnionbalanceInstance 1` on each backend pointing at\n  the Onionbalance master.\n\n> **⚠️ GOTCHA (as of 2026): PoW and Onionbalance don't mix.** Choose per threat model — DoS\n> resistance on a single instance, or horizontal scale across backends. See §9.2–§9.3 →\n> `tor-onion-services-and-hardening`.\n\n---\n\n## §13.4 Advertising the onion from your clearnet site\n\n```nginx\n# nginx — Tor users get the \".onion available\" pill (Tor Browser ≥ 9.5)\nadd_header Onion-Location http:\u002F\u002F\u003Cyour56>.onion$request_uri;\n\n# transparent variant: Tor-capable clients switch to onion silently\nadd_header Alt-Svc 'h2=\"\u003Cyour56>.onion:443\"; ma=86400';\n```\n\nServe these over HTTPS from the clearnet origin only (**never** from the onion itself).\n\n---\n\n## §13.4a Non-SOCKS apps: torsocks and its honest limits\n\n```\ntorsocks curl https:\u002F\u002Fcheck.torproject.org\u002Fapi\u002Fip\n```\n\ntorsocks is `LD_PRELOAD` shimming: TCP only, breaks on apps using raw syscalls, no UDP, and it\n*silently* does nothing for apps that bypass libc (statically linked Go\u002FRust binaries).\n\n> **⚠️ GOTCHA — this is the dangerous one.** A statically linked binary under `torsocks`\n> connects **directly**, with no error and no warning. Rule of thumb: **torsocks for\n> convenience, never for high-stakes assurance.** For assurance, use app-native SOCKS or a\n> fail-closed network sandbox (§13.5 → `tor-running-relays-bridges-and-hardware`, §4.3–4.4).\n> `proxychains` shares the architecture *and* the caveats, with worse defaults.\n\n---\n\n## §13.4b Arti as a library and daemon\n\nArti (Rust) is the future embedding path: no fork of an external process, memory safety, and —\nsince 1.8.0 (Dec 2025) — production-grade onion services with native vanguards.\n\n```toml\n# ~\u002F.config\u002Farti\u002Farti.toml  (minimal client)\n[proxy]\nsocks_listen = \"127.0.0.1:9150\"\ndns_listen = \"127.0.0.1:15354\"\n```\n\n```rust\n\u002F\u002F embedding: arti-client = \"0...\" (API churned through 2.x — pin + read changelog)\nuse arti_client::{TorClient, TorClientConfig};\n\nlet tor = TorClient::create_bootstrapped(TorClientConfig::default()).await?;\nlet stream = tor.connect((\"check.torproject.org\", 443)).await?;\n```\n\nC-tor → Arti service migration: `arti hsc ctor-migrate` (2.x) ports hidden-service keys. Watch\nthe `arti hss` tooling and Arti RPC — both are the fast-moving surface in 2026. **onionmasq**\n(from the Tor VPN project) gives you a userspace TUN interface over Arti: route whole\napplications without them knowing.\n\n---\n\n## §13.4c Developing against a test network: chutney\n\n**Never integration-test against the production network.** Chutney runs a private mini-Tor on\nlocalhost:\n\n```bash\ngit clone https:\u002F\u002Fgitlab.torproject.org\u002Ftpo\u002Fcore\u002Fchutney.git\ncd chutney\n.\u002Fchutney configure networks\u002Fbasic\n.\u002Fchutney start    networks\u002Fbasic\n.\u002Fchutney verify   networks\u002Fbasic\n.\u002Fchutney status   networks\u002Fbasic   # shows per-node SOCKS\u002FControl ports to point tests at\n```\n\n---\n\n## §13.6 Building your own private network\n\n\"I want a private network\" almost always resolves to one of three architectures, separated by\ntwo orders of magnitude of effort. Pick before you build.\n\n| Option | What it is | When it is right |\n|---|---|---|\n| **A — public Tor + v3 onion services with client authorization** | Your services are onion services on the public network; only holders of a client key can see them | Almost every real case: organizational privacy, private infrastructure, SecureDrop- and OnionShare-style deployments |\n| **B — your own Tor network** | Your own directory authorities, relays and clients, isolated from public Tor | Testing, research, or a closed organizational network that must not touch public Tor at all |\n| **C — a custom onion routing network** | Tor-like software of your own, with different trade-offs | Research, or a genuinely different threat model (§13.6.3) |\n\n### §13.6.1 Option A — use the public Tor network (the right answer for most cases)\n\nRun a tor client on your server, configure a `HiddenServiceDir` with client authorization\n(§13.3), distribute `.auth_private` files to your authorized users, and let them connect via\nTor Browser or a Tor-integrated application. The service is invisible to anyone without a\nclient key. You get location-anonymous hosting, encryption by construction, authentication of\n*both* directions, and the whole public relay set — without operating any of it. Add PoW for\nDoS resistance and vanguards for guard-discovery resistance (§9 →\n`tor-onion-services-and-hardening`). This is what SecureDrop and OnionShare do.\n\n> **⚠️ GOTCHA:** running your own network *reduces* your anonymity set. On public Tor your\n> traffic hides among several million daily users; on a twenty-relay private network,\n> \"someone used the network\" is a much smaller set, and its operator knows who the\n> participants are. Isolation from public Tor is an availability and control property, not an\n> anonymity upgrade — choose B or C because you need control, never because you want more\n> anonymity than A gives you.\n\n### §13.6.2 Option B — run your own Tor network (chutney, and past it)\n\nChutney is not only a test harness (§13.4c). `networks\u002Fbasic` is a complete miniature Tor —\n**3 directory authorities plus relays and clients** — and a custom network definition is how\nyou grow one:\n\n```bash\n.\u002Fchutney configure networks\u002Fbasic   # 3 authorities + relays + clients\n# For a larger private network, write a custom network definition with your own\n# authorities, relays and exits. Each node gets its own torrc and data directory.\n```\n\nFor a *production* private network you need: **at least 3 directory authorities**, run on\ndifferent infrastructure in different locations; a sufficient number of relays for bandwidth\nand redundancy; your own consensus process (your authorities vote hourly exactly as public\nTor's nine do — §6.2 → `tor-network-consensus-guards-and-paths`); and client software\nconfigured to use *your* authorities instead of the public ones. It is a substantial\nundertaking, and what it buys is complete control over who participates. Operator mechanics\nand the verification checklist: handbook §2 and §5 →\n`tor-running-relays-bridges-and-hardware`.\n\n### §13.6.3 Option C — build a custom onion routing network\n\nIf you want something Tor-like with different trade-offs — different circuit lengths, guard\nstrategies, crypto — four core components have to exist; onion services are optional:\n\n1. **Relay software.** Authenticates to neighbours (ed25519 identities), accepts\n   circuit-building commands, performs onion encryption\u002Fdecryption on relay cells (§3 →\n   `tor-protocol-circuits-and-cell-cryptography`).\n2. **Directory system.** Some mechanism for clients to discover relays — Tor's nine\n   hourly-voting authorities, a single trusted directory server, a threshold-signature scheme,\n   a DHT, a blockchain. The two properties that matter whatever you pick: **clients must get a\n   consistent view of the relay set**, and **an attacker must not be able to inject relays\n   cheaply**.\n3. **Path selection.** Three relays subject to constraints (no shared operator, no shared\n   subnet, exit policy permits the destination), guards pinned for months (§7 →\n   `tor-network-consensus-guards-and-paths`). The algorithm *is* the anonymity property.\n4. **Client software.** Telescoping circuit construction, guard state, a SOCKS interface,\n   stream isolation (§13.1).\n5. **Onion services (optional).** Introduction points, descriptor publication to HSDirs,\n   rendezvous points, client authorization, and a key-derived self-authenticating address\n   (§8 → `tor-onion-services-and-hardening`).\n\n> **⚠️ KEY DESIGN PARAMETERS.** Circuit length (3 is standard; more hops raise latency and\n> the attacker's cost together). Guard rotation period (months is standard; shorter raises\n> exposure probability). Directory trust model (authorities vs. DHT vs. blockchain). Crypto\n> primitives (ntor for the handshake; CGO or an AEAD for cells). Whether to support onion\n> services. Whether to support pluggable transports. Whether the network is **open** (anyone\n> joins) or **closed** (known participants only). These seven choices determine what your\n> network is; everything else is implementation.\n\nImplementation checklist:\n\n- **Use vetted cryptographic libraries** (libsodium, libsecp256k1) — never implement\n  primitives yourself.\n- **ntor or X25519 for the handshake** (§4.1 → `tor-protocol-circuits-and-cell-cryptography`).\n- **An AEAD for cell crypto** (ChaCha20-Poly1305 or AES-GCM). **Do not use CTR mode without\n  authentication** — malleability is exactly what enables tagging attacks (§4.2 →\n  `tor-protocol-circuits-and-cell-cryptography`). Note that Tor's own CGO is *not* a stock\n  AEAD: it needs a rugged PRP because relays must transform cells through a deliberately\n  malleable decrypt path. Reach for CGO only if you have that same constraint; otherwise a\n  standard AEAD per hop is the safer build.\n- **Guard pinning from day one** and **path restrictions (family, subnet) from day one** —\n  both are far harder to retrofit than to build in.\n- **Test against chutney-style adversarial scenarios** (§13.4c).\n- **Have a plan for relay discovery and Sybil resistance** before you have relays.\n- **Consider using Arti as a foundation rather than starting from zero** (§12.1 →\n  `tor-ecosystem-alternatives-and-governance`).\n\n---\n\n## Where to go next\n\n- Relays, bridges, exits, transparent proxies, hardware builds, verification and abuse\n  handling: §13.5 → `tor-running-relays-bridges-and-hardware`.\n- What a v3 onion service is actually doing underneath this configuration: §8 →\n  `tor-onion-services-and-hardening`.\n- Why `socks5h` matters — where the anonymity boundary actually sits: §3.3 →\n  `tor-protocol-circuits-and-cell-cryptography`.\n- Library and implementation choices: §12 → `tor-ecosystem-alternatives-and-governance`.\n",{"name":5,"description":7},"develop","ae32736a1aabddabca5d2c96d665aa0ebc7d8700","src\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Ftor-and-onion-networks\u002Fskills\u002Ftor-building-on-tor-software-patterns",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 tor-building-on-tor-software-patterns",{"tool":40,"command":41},"bunx","bunx skills add the-vibey-project\u002Fvibey --skill tor-building-on-tor-software-patterns",{"tool":43,"command":44},"pnpm","pnpm dlx skills add the-vibey-project\u002Fvibey --skill tor-building-on-tor-software-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Ftor-and-onion-networks\u002Fskills\u002Ftor-building-on-tor-software-patterns\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",[],[]]