user-model-builder

name	user-model-builder
description	Build complete userModels for people Claudicle collaborates with. Creates core persona files, social dossiers with voice analysis, content archives, and INDEX registration. Use when asked to create a user model, build a persona, or document someone's voice and identity.
argument-hint	["person-name"]

User Model Builder

Build a complete userModel for $ARGUMENTS following the 7-phase workflow below. Each phase must complete before moving to the next. The output is a folder at ~/.claude/userModels/{name}/ containing a core persona, platform-specific dossiers, a content archive, and INDEX registration.

Phase 1: Discovery

Gather available information about the subject before creating any files.

Determine:

• Relationship to the user (collaborator, partner, observed figure)
• Publishing platforms (Substack, Twitter, blog, LinkedIn)
• Scrapeable content availability — dead domains require Wayback Machine CDX API
• Basic identity: full name, email (~ if unknown), phone (~ if unknown), location, primary roles

Ask clarifying questions if the relationship or scope is ambiguous. Proceed autonomously once direction is clear.

Phase 2: Folder & Core Persona

Create the userModel directory and core persona file.

1. Create ~/.claude/userModels/{name}/
2. Write {name}Model.md following references/persona-model-template.md
3. Frontmatter per references/frontmatter-schema.md — type: user-model, category: persona
4. Required sections: Persona, Education (if known), Career Timeline, Worldview, Writing Voice (brief), Personal, Online Presence
5. Adapt to subject — omit sections that don't apply, add domain-specific sections as needed

Phase 3: Content Scraping & Archive

Scrape all discoverable published content into archive/.

Per platform:

Platform	Tool	Archive path
Substack	Firecrawl	archive/substack/YYYY-MM-DD-slug.md
Twitter	Jina (Firecrawl blocks Twitter)	archive/tweets/
Dead domains	Wayback CDX API → Firecrawl	archive/{platform}/
LinkedIn	GDPR export via linkedin-export skill	archive/linkedin/

Wayback discovery:

https://web.archive.org/cdx/search/cdx?url=DOMAIN&output=json&fl=timestamp,original&collapse=urlkey

Each archived file gets frontmatter:

---
title: "Post Title"
date: YYYY-MM-DD
source_url: "https://..."
archived_from: "{platform}"
archive_date: YYYY-MM-DD
---

Naming convention: YYYY-MM-DD-slug.md (kebab-case slug from title).

Write archive/INDEX.md — table of all files with dates, titles, approximate word counts.

Phase 4: Voice Analysis & Dossiers

Read the entire archived corpus before beginning analysis. Analyze each platform's content for voice, worldview, and biographical signals.

For each platform, create a social dossier following references/social-dossier-template.md.

Frontmatter: type: social-dossier, category: {platform}-analysis, include corpus field.

Required dossier sections:

• Source — URLs, scraping method, verification date
• Platform Profile — Handle, legal entity, tagline, cadence, engagement metrics
• Post/Content Index — Table: date, title, type, themes
• Voice Analysis — Registers, tonal range, sentence mechanics, characteristic phrases. Follow references/voice-analysis-guide.md
• Worldview Markers — Minimum 5 recurring themes with evidence
• Biographical Signals — Per-post table of facts revealed. Separate distinct events.
• Calibration Quotes — 10-15 verbatim quotes. Copy directly from archive files. Verify character-by-character: opening words, punctuation, emphasis, quote mark style. Never paraphrase.

Include a Voice Evolution section when the corpus spans 3+ years or crosses a major life transition.

Name dossiers descriptively: {platform}-{publication-name}.md.

Phase 5: Cross-References & Registration

Wire everything together.

1. Add a "Supplementary Dossiers" section to {name}Model.md listing all dossiers and archive
2. Update ~/.claude/userModels/INDEX.md:
   • Add/update the subject's section with a Files table
   • Add Data Collections subsection for archive directories
   • Add Related links (Substack, LinkedIn, etc.)

Phase 6: Review

Launch a code-reviewer subagent to audit all files against references/review-checklist.md.

Priority checks:

1. Calibration quotes are verbatim (opening words, punctuation, quote style)
2. Author bios are verbatim (not paraphrased)
3. Biographical facts match source (names, dates, locations — distinct events not merged)
4. Frontmatter schema compliance
5. INDEX.md consistency with files on disk
6. Cross-references resolve to real files

Fix all critical and moderate findings before declaring complete.

Automated validation:

uv run ~/.claude/skills/user-model-builder/scripts/validate_usermodel.py ~/.claude/userModels/{name}/

Phase 7: Summary

Report what was built:

• Files created (with paths)
• Corpus stats (post count, word count, date range)
• Key findings (voice registers, worldview themes, biographical discoveries)
• Suggested next steps (RLAMA collection, voice model for composition, etc.)

Reference Files

File	Purpose
references/persona-model-template.md	Core persona section skeleton
references/social-dossier-template.md	Social dossier section skeleton
references/frontmatter-schema.md	YAML frontmatter spec for all file types
references/voice-analysis-guide.md	Open Souls voice analysis methodology
references/review-checklist.md	Post-build verification checklist
scripts/validate_usermodel.py	Structural + quote accuracy validation