soulscrape
install the skill
Theme
Appearance

Tutorial

build your first working model.

Install the soulscrape skill, point your agent at authorized evidence, review the dossier it writes, and iterate.

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 soulscrape

Review 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.

Read SKILL.md · Release 0.6.0 notes and verified assets

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.

Publish a person index · What people use dossiers for