Install the skill
Install the verified public skill through skills.sh. It lands inside your agent's skill directory — nothing phones home, and no account is needed to use it.
bunx skills add hraness/soulscrape#v0.6.0 --skill soulscrapeReview the skill before installing if you like; it is a Markdown file with instructions plus a few dependency-free TypeScript utilities. Start a new agent session afterward so the skill loads.
Ask for the model
Name the person, the sources you are authorized to use, and the intended use. The skill writes a question packet before it reads anything — subject, audience, evidence available, evidence missing, and what you must authorize.
Use $soulscrape to build a dated, evidence-calibrated, partial and revisable working model of <person> from <authorized sources>. State the intended use, audience, source cutoff, and any proxy authorization explicitly.Start with a corpus small enough to inspect: a public figure's essays, a talk transcript, an interview. Your agent reads the evidence, asks once if something material is missing, then writes the working document.
Read the dossier
The result is a compact Markdown dossier with four parts: an executive model, a practical operating manual, the tensions and revision hooks, and a what-not-to-infer section. It ends by stating exactly what the evidence did not cover.
- Facts, stated beliefs, patterns, and speculation are kept distinct — check the claim kind before quoting.
- Contradictions are preserved rather than resolved; a model that erases them is a bug, not a feature.
- Confidence describes support within the evidence examined, not certainty about the person.
Iterate and decide what happens to it
Ask for corrections, add evidence when it supplies a missing period, a new context, or a real contradiction. The dossier stays dated and revisable; it never pretends to be finished.
Keep it private, share the file, or publish it as a public index — that is a separate decision with a free account and a device login.