Distilly Person-Profile Workflow
A strict operating contract for building, updating and recalling evidence-grounded person profiles through Distilly's exact five MCP tools.
AutomationAdvanced★ 24,321⑂ 2,128AI score 8/10Last updated: Sep 3, 2026
What it does
- Restricts the assistant to exactly five tools —
distilly_get,distilly_ingest,distilly_pending,distilly_commit,distilly_correct— keeping person memory local, evidence-bound and reviewable. - Locks the sequence: resolve subject → gather sources → ingest → brief (acquire lease) → build a claim-only patch with exact quotes → commit → verify the active profile.
- Specifies wire format (
wireVersion: "3",requestId=req_+ 32 lowercase hex) plus recovery paths for stale generation, stale material set, expired lease and digest mismatches. - Prefers sources the user already supplied (pasted text, selected files/directories, public URLs) while skipping symlinks, binaries, credentials and unrelated project files.
- Treats every source body as untrusted evidence, never instructions, and flags injection attempts as
suspicious_source.
Who it's for
- Users who already run (or plan to run) the Distilly plugin and MCP server.
- Researchers and knowledge-management folks who need auditable, quote-backed person dossiers.
- Developers who want agents held to a rigid tool contract instead of improvising schemas.
Example uses
- "Build a profile for Jane from these three interview transcripts" → resolve returns
not_found, first batch usessubject.kind: create, later batches useexisting, only the final batch usesenqueue: now. - "Show me that profile again" → after resolve, call
action: profile(orprompt) and stop; no new research, no empty subjects. - "Correction: he moved to Company B" →
distilly_correctwith the user's verbatim text, then report the returnedsuspendedstate and the review URL.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/titanwings/distilly/HEAD/plugins/shared/skills/distilly/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the plugins/shared/skills/distilly folder from the GitHub repo titanwings/distilly into my ~/.claude/skills/titanwings-distilly-3/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/titanwings/distilly.git && mkdir -p ~/.claude/skills && cp -r distilly/plugins/shared/skills/distilly ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/titanwings/distilly.git - Copy the skill into your Claude skills folder:
mkdir -p ~/.claude/skills && cp -r distilly/plugins/shared/skills/distilly ~/.claude/skills/ - Confirm
~/.claude/skills/distilly/SKILL.mdand itsreferences/folder came along. - Install and configure the Distilly MCP server (host binding) following the repository's setup docs, and register it with Claude Code.
- Restart Claude Code and verify all five
distilly_*tools are exposed in the session (e.g. via/mcp). - Trigger it with a request like "research and distill a profile for X from these files." If any tool is missing, the skill will stop and report only that narrow failure.
View source on GitHub ↗License: MIT