soulscrape
install the skill
Theme
Appearance

How-to guide

prepare a source packet.

Turn a bounded export — like an X archive — into a validated ensoul source packet the skill can read offline.

What a source packet is

A source packet is a bounded JSON export with structure, attribution fields, stated bounds, references, and an integrity digest. The validator proves those properties — it does not prove the contents are true.

Message Like Me and Peopleblade export bounded packets for messages and contacts. The ensoul.x-authored-posts-source.v1 source id covers a person's own authored posts from an official archive.

Validate before reading

bun skills/soulscrape/scripts/validate-source-packet.ts \
  /absolute/private/path/subject.ensoul-source.json

Validation is offline. A valid packet means the structure, attribution, bounds, references, and digest check out — the skill then reads it as evidence under your stated use.

Hand it to your agent

Keep the packet on your disk and name it in the ask. Private material stays in your agent environment under its data practices; it never moves to Hraness unless you choose to publish a public index built from public evidence.

Use $soulscrape to build a working model of <person> from /absolute/path/subject.ensoul-source.json, for <intended use>.