# User Model Builder

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

- **Type:** Skill
- **Install:** `agentstack add skill-tdimino-claude-code-minoan-user-model-builder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tdimino](https://agentstack.voostack.com/s/tdimino)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tdimino](https://github.com/tdimino)
- **Source:** https://github.com/tdimino/claude-code-minoan/tree/main/skills/core-development/user-model-builder
- **Website:** https://www.minoanmystery.org

## Install

```sh
agentstack add skill-tdimino-claude-code-minoan-user-model-builder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:**
```yaml
---
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:**
```bash
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 |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tdimino](https://github.com/tdimino)
- **Source:** [tdimino/claude-code-minoan](https://github.com/tdimino/claude-code-minoan)
- **License:** MIT
- **Homepage:** https://www.minoanmystery.org

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tdimino-claude-code-minoan-user-model-builder
- Seller: https://agentstack.voostack.com/s/tdimino
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.