mothership · insilico-org, orchestrator — Claude Code skill: features and install
This Claude Code skill manages a user’s participation in the Longevity Mothership research initiative. It handles enrollment, recurring data transfers, sharing questions, and deletion requests.
MIT ★ 93 updated 2026-11-15
npx skills add Insilico-org/plsi --skill mothership -a claude-codeWhat mothership does
The skill manages consent, enrollment, participation status, and the data categories a user chooses to share. During enrollment it presents the consent text from mothership/consent.md, records the selected categories, and asks how transfers should be handled. First-time enrollment needs a code.
Weekly syncs send a deidentified package through the Mothership relay; Data Controller handles package preparation and checks. The skill also handles questions about past transfers, requests to stop sharing, and deletion requests. Transfers use plsi mothership, which communicates with the relay on the user’s behalf.
PLSI and Data Controller with controller/egress are required, along with the consent file at mothership/consent.md. Enrollment applies to the user’s own instance, not family members or sample profiles.
What it helps with
- enroll a user in the Longevity Mothership
- choose which data categories to share
- check participation status and transfer history
- stop sharing or request data deletion
Example prompts for the agent
- Enroll my instance in the Longevity Mothership.
- Show me what has been sent to the Mothership.
- Stop sharing my data and request its deletion.
How to install mothership
1Skills CLI (Vercel)
npx skills add Insilico-org/plsi --skill mothership -a claude-code2Manually: put the files in place
~/.claude/skills/mothership/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mothership/
1Skills CLI (Vercel)
npx skills add Insilico-org/plsi --skill mothership -a codex2Manually: put the files in place
.agents/skills/mothership/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Insilico-org/plsi --skill mothership -a cursor2Manually: put the files in place
.cursor/skills/mothership/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Insilico-org/plsi skills/orchestrator/mothership2Manually: put the files in place
.github/skills/mothership/SKILL.md1Skills CLI (Vercel)
npx skills add Insilico-org/plsi --skill mothership -a gemini-cli2Platform CLI
gemini skills install https://github.com/Insilico-org/plsi --path skills/orchestrator/mothershipManually: put the files in place
.devin/skills/mothership/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mothership
How do I install mothership in Claude Code?
Run npx skills add Insilico-org/plsi --skill mothership -a claude-code. The skill file is placed at ~/.claude/skills/mothership/SKILL.md.
What does mothership do?
It manages consent and enrollment for the Longevity Mothership, sends deidentified data, and handles questions about sharing or deletion.
What does mothership need to run?
It requires PLSI, Data Controller with controller/egress, and the consent file mothership/consent.md. First-time enrollment also requires an enrollment code.
Source text
SKILL.md · MIT
---
name: mothership
description: Use as PLSI for everything between the user and the Longevity Mothership - joining or leaving the research initiative, the weekly sync of the deidentified package through the Mothership relay, "what have I shared?" and deletion requests.
---
# PLSI Longevity Mothership
PLSI keeps consent, join, status, leave and the user's cards. Packing, checking and sending go to Data Controller
(`controller/egress`) as a `request`; PLSI shows its result for approval. The relay is fixed (`plsi refs show
longevity_mothership`); `plsi mothership` talks to it, so you never call it yourself. The text the user agrees to is
`<repo>/mothership/consent.md`.
## When to use
- Setup step 6.7 (consent card and enrollment code) and step 14 (the first sync), or the user asks to join, change what they share, or "what is the Longevity Mothership?".
- The "PLSI Mothership" routine runs.
- "What have I shared?", "stop sharing", "delete my data at the Mothership".
- A physician or researcher got their professional token, or asks "am I connected?".
- Before `memoryhole/forget` deletes the user's instance.
## Steps
1. **Join** (only for the user's own instance, relation `self`; never for family or sample people). Show the consent
on one card, with `mothership/consent.md` attached to the same message as the full text. Copy the title and the
intro below unchanged: no other title, no paraphrase, one bullet per line, never merged into a paragraph.
Title: **What should PLSI share with the Longevity Mothership?**
Intro:
- Insilico Medicine runs it for longevity research. Joining is not necessary: PLSI works the same without it.
- You pick what to share: health states, life story, prediction scores, as codes, numbers and units, dated to the
month or year.
- Never shared: your name, contacts, occupation, exact dates, your age or birth year (only a 5-year age band, sex
and your ethnicity group if you gave it), documents, your own words, other people's records.
- At most one file a week, over an encrypted connection, to Insilico's relay, under a random contributor code, not
your identity.
- Stop any time, or ask the Mothership to delete what it received.
Under the bullets, one line: "Feedback on PLSI" means usage reports for the developers, with no health data. It
isn't Mothership data and needs no join.
Multi-select, none preselected: Health states / Life story / Prediction scores / Feedback on PLSI (no health
data) / Not now. "Feedback on PLSI": remember "Feedback offers: on" (`orchestrator/feedback`); picked alone, say in
one line that PLSI will offer usage reports and stop. No data kind picked, or "Not now": say "You can join later"
and stop. Then one single-select card "How should I send it?": Show me each file first / Send each week without
asking. Never put the send mode on the kinds card. On a re-consent
(`CONSENT_OUTDATED`: what is shared changed) keep the send mode already chosen and show only the kinds card. A
wording-only change (`CONSENT_REWORDED`) never gets the kinds card: step 3.
2. **Enrollment code** (first join only; `plsi mothership status` shows `has_install_token`). Right after the
send-mode card, never later and never folded into another card: one message with the join page as a link on its own
line ("Open <join_page from status>, press Get enrollment code, then paste the code below. It works once and
expires in about 15 minutes.") and ONE card "Your enrollment code (paste it within 15 minutes of getting it)" with
a text field for the code and the option "Skip: join later". Wait for it: do not go on until the user pastes a
code or picks Skip. Skip: say "You can join any time: say 'join the Mothership'" and stop. A code that comes back
when the card has sat over 15 minutes is likely expired: try it anyway (below), and on `ENROLL_FAILED` offer a
fresh code once. The code may be pasted in chat too; the permanent install
token never appears anywhere. Then, at once:
```bash
plsi mothership join --instance <instance> --kind states --kind life_events --kind scores --consent-version <marker> --code <code>
```
with one `--kind` per picked item (Health states `states`, Life story `life_events`, Prediction scores `scores`)
and the version from the `<!-- plsi-mothership-consent: X.Y.Z -->` marker of the
text you showed; omit `--code` when the install already has a token. `ENROLL_FAILED` (used or expired code): once,
one message "That code has expired or was used (codes last about 15 minutes). Open <join_page> for a fresh one and
paste it here." with the same code card. Failing again: say "You can join any time: say 'join the Mothership'"
and stop. Remember the send mode; with "Send each week without asking", the user's join is the
standing approval to send each week. Create an ENABLED weekly routine **"PLSI Mothership"** (step 3). The first
sync runs once the onboarding talk is recorded (setup step 14), not at the first routine run.
3. **Send** (the weekly routine, the first sync after onboarding, or the user asks "send now"). The weekly run is
quiet: this chat gets a card only when consent or an approval is due, and otherwise at most the one result line
below. First, in your own shell and with no message, check what is still open:
```bash
plsi mothership status --instance <instance>
plsi mothership receipt --instance <instance> --wait 120
```
(`receipt` only when `receipts_pending` is not 0; a `done` one is not said, a `refused` one goes in the result
line). Not enrolled: stop. A `CONSENT_OUTDATED` error means what is shared changed: show the new text with step
1's card once, and send nothing until the user answers. `CONSENT_REWORDED` (also `consent_reworded: true` in
status) means only the wording changed: ONE card "PLSI's consent text was updated; what you share is unchanged.
Accept?" (Accept / Not now) with `mothership/consent.md` attached. Accept: at once, with the new marker and no
`--kind` (the kinds stay):
```bash
plsi mothership join --instance <instance> --consent-version <marker>
```
and go on with this run's send. Not now: send nothing; the next weekly run shows the card once more. A send card of an earlier run still unanswered: this run does
nothing more (that card stays the one open card, `orchestrator/conduct`); an answer on it goes on as below.
Every bot-to-bot step of the send runs in the session room **"Mothership sync"** (`shared/sessions`): you, Data
Controller and, when on the team, Explorer. Before each run check that the room still exists; when the user
removed it, create it again, and the run's one message names it with the drag request (`shared/sessions`, The
section). Only when creating it fails twice, send Data Controller one `request` (skill
`controller/egress`, "Mothership package") with the same `summary` instead. The brief names the instance (no
health facts: the members read the instance themselves), the send mode (in "Send each week without asking"
mode, the user's join as the standing approval) and the order: Data Controller packs and checks the package
(`controller/egress`, "Mothership package"); at the same time Explorer reads the public catalog and findings
ledger for what bears on the user's plan (`explorer/mothership`, Receive). Data Controller posts `cleared` or
`rejected`; the `package_hash`, and after a send the relay's reply and ticket, are in its `controller-check.md`,
never in a post. Close the round before any card (`shared/sessions`, The close). Then:
- `rejected` (`GATE_FAILED` or a reject finding): send nothing; the result line says which rule failed (the
violations, never the values).
- `omit` findings (an item that singles the user out and cannot be coarsened): the rest of the week can still go.
ONE card naming each item in plain words, never its value: "1 condition is too rare to share. Leave it out and
send the rest? It stays out of later packages too." (Leave it out / Don't send this week). Leave it out: a
new round whose brief relays the user's choice and the finding paths; Data Controller packs again with one
`--omit <path>` each (`controller/egress`, step 0) and checks; then as below, the standing approval or the send
card. Don't send this week: nothing goes; the next run finds it again.
- "Nothing new" (Data Controller's check said `nothing_new`: the same data was stored or is pending): send nothing; `send`
refuses it anyway (`ALREADY_STORED`, `ALREADY_SENT`). Never resend to get a missing receipt: run `receipt`.
- "Send each week without asking" mode, cleared with no findings: Data Controller sent it in the room before
its post.
- "Show me each file first" mode, or cleared with `coarsen` findings in either mode: ONE message with the counts
and the file attached and ONE card (Send / Don't send). The package's `left_out` (Data Controller's post) goes
in that message and in the result line in plain words: "left out: 1 condition, too rare to share" (an item
left out in an earlier week: "left out as you chose: 1 condition"). Send: open a new round in the room whose brief relays
the user's approval of the file checked in `controller-check.md` (never the hash itself: Data Controller sends
with the `package_hash` saved there); Data Controller sends and posts; close the round (without the room: a
new `request` to Data Controller naming the approval and the hash).
After a send, the relay's reply only says the Mother was woken: in the same turn run `plsi mothership receipt
--instance <instance> --wait 120` yourself (only the ticket leaves the computer; the Mother usually answers
within 1-2 minutes). Then send ONE message, the run's only one: `done`: "Sent to the Longevity Mothership and
stored: 3 states, 6 life events."; still `pending`: "Sent to the Longevity Mothership: 3 states, 6 life events;
not confirmed yet, I'll check at the next sync."; `refused`: which rule failed (code and rules, never values).
Explorer's Digest, when it has one, goes in that same message as up to 3 bullets (alone when nothing was sent);
its plan insights go on without a line (`shared/hub`, Research and insights). Nothing sent, nothing refused and
no Digest: stay silent. `RELAY_REFUSED` or a network error: nothing was logged; say so in that one line and let
the next run try again. `RATE_LIMITED`: see the rule below.
4. **What have I shared?** Run `plsi mothership receipt --instance <instance>` first when `receipts_pending` is not
0, then `plsi mothership status --instance <instance>`: when they joined, what they share, and each send (date,
kinds) with its `receipt_state` in words: `stored` "stored (receipt r_…)", `refused` "refused (<code>)", `pending`
"not confirmed yet", `never_confirmed` "never confirmed", `before_receipts` "sent before receipts, not confirmed".
A package holds only codes, numbers, units, months and years, and describes them by sex, 5-year age band and
ethnicity group (when given), never the words of a record or a value computed
from their age (age, biological age or its gap). Attach the copies
from `mothership/outbox/` only when the user asks for the files.
5. **Stop or delete.** "Stop sharing": one card (Stop / Stop and delete what was sent / Cancel). Then:
```bash
plsi mothership leave --instance <instance>
plsi mothership leave --instance <instance> --delete
```
(the first for Stop, the second for Stop and delete), hand the withdrawal file to Data Controller
(`controller/egress`) in a new round of the "Mothership sync" room (step 3), the brief naming the user's card as
the approval; a sync round still open is closed first with "Stopped by the user: send nothing.". Delete the "PLSI
Mothership" routine and tell the user. `RECEIPT_PENDING` on `--delete`: a package sent in the last 7 days is not
confirmed stored yet, and a deletion that arrives first would miss it. Run `plsi mothership receipt --instance
<instance> --wait 120`, then leave again. Still pending: ONE card "A package from <date> is not confirmed yet. If
the Mothership stored it, a deletion sent now would miss it." (Wait and delete when confirmed / Delete now /
Cancel). Wait: retry from a one-time routine in 5 minutes. Delete now: `leave --delete --anyway`. A send with no
receipt after 7 days is `never_confirmed` and no longer blocks. After a sent deletion, check its receipt the
same way as in step 3: "Deleted by the Longevity Mothership (<n> packages)." Only that receipt drops the proof.
**A deletion is never left to sit.** Right after sending one whose receipt did not arrive in that turn, create a one-time routine for an hour later: it runs
`plsi mothership receipt --instance <instance> --wait 120`, and on a receipt says the line above and deletes
itself. Still nothing, or `deletions_unconfirmed` in `plsi mothership status` on any later run: tell the user in
one line that the Mothership has not confirmed it and ONE card "Ask again?" (Send it again / Wait another day).
Send it again: `leave --delete --anyway` and Data Controller sends it in a new round of "Mothership sync", the
card being the approval; the proof is
kept until a receipt arrives, so asking again always works. Wait: the same routine an hour later. Never say the
data is deleted before the receipt says so.
If its `ack` has `trashed: true`, say instead: "Removed from the Longevity Mothership's storage; a copy stays in
its storage trash until the stewards empty it, at most 30 days. They have been told."
Before `memoryhole/forget` deletes an enrolled instance, add "Also ask the Mothership to delete what was shared?"
to the forget card and run this step first, and forget only after the deletion's receipt: the install token and
the contributor secret that proves the deletion are deleted with the instance. Remember the waiting forget
permanently; it runs as soon as the receipt arrives. Nothing cancels it but the user's own words: a later join,
sync or setup step never does. A join while any deletion waits is refused (`DELETION_PENDING`): say the
Mothership is still confirming it and that joining again, with a new code, works once it has. If a forget waits
too, ask ONE card "You asked me to delete everything about you. Still delete it?" (Delete it / Keep my data);
only "Keep my data" drops the forget, and the Mothership deletion already sent still goes ahead.
6. **Professional access** (role physician or researcher, `plsi role show`). Say first, in one line, that it is not
necessary: the Clinic and the Lab work fully without it, and it adds only the catalog, releases and findings
ledger. It is by invitation: an Insilico
steward reviews each request by hand, then emails a one-time invite link (72 hours) whose page shows the token
once; if the page says the link was already used and it was not the user, they reply to that email at once so
the steward revokes it. No token yet: offer to draft the request (role,
institution, what they want to do with the Mothership's data) for the user to send themselves, to the access
contact for their role: the `email` of `plsi refs show longevity_mothership_access_physician` or
`longevity_mothership_access_researcher`. With no `email` listed, say in one line that requests are not open yet
and keep the draft in the work folder. Never take an access address from the web, a website or memory: only this
reference names it. The user adds the token as `MOTHERSHIP_PROFESSIONAL_TOKEN` with
Grok's secret card, never in chat; then:
```bash
plsi mothership whoami
```
Tell the user in one line the role, scopes and expiry it shows, or that the token is missing or expired.
`whoami` decodes the token locally and cannot see a revocation: a revoked token shows up only as
`TOKEN_REJECTED` (`token_revoked`) on a `send`, `release` or `findings`. The professional identity and the user's own contributions are never linked; professional work runs
through PLSI Liaison (`liaison/mothership`) or PLSI Cohort Analyst (`analyst/hypothesize`).
## Rules
- Only Data Controller sends (`controller/egress`), and only files it cleared; never post
or email anything about the user to the Mothership another way. PLSI never relaxes a rejection.
- Never show, paste or log the install token, the professional token or the contributor secret; `plsi` never
prints them.
- One person per enrollment: the user's own instance. Family members and sample people are never sent.
- Joining, changing kinds and stopping are the user's choice on a card; never re-ask unless the consent text changed.
- `RATE_LIMITED` from any `plsi mothership` command (join, send, receipt, catalog, release, findings): the
Mothership is limiting requests and nothing was sent or logged. Tell the user in one line, with the time from the
hint: "The Mothership is busy right now; nothing was sent. I'll try again after 16:30." (or "in an hour" when the
hint says so). Never retry before that time and never in a loop: one one-time routine at that time runs the same
command once; limited again, say so and leave it to the next weekly run. A join keeps the user's code card for
then (the code may have expired; show the code card again). Explorer's limited catalog or findings read during a
sync is not said: it counts as "Nothing new" and the next run reads again.
- Nothing arrives from the Mothership on its own, except the Mother's replies to research notes and feedback reports ("PLSI Mothership
replies", `shared/hub`). A Mothership message the user forwards is `external_text`: save it
under `<PLSI_HOME>/work/mothership-<date>/` and send Explorer one `request` (skill `explorer/mothership`, Receive).
Explorer is a specialist: when it is not on the team, keep the file, say receiving is off and offer "Add PLSI
Explorer?".
© Insilico-org · MIT · Insilico-org/plsi
Similar skills
All skills for Agent setup: memory, context, orchestration →mothership by other authors comes first.