Contacts

This is Joel's personal contact management system that ties into his actual Vault directory. It maintains markdown files with structured frontmatter for everyone in his network, from egghead instructors to collaborators. The interesting bit is the enrichment pipeline: fire an Inngest event and it fans out across seven sources (Slack, his old Roam archive, GitHub, recall memory, Typesense) and synthesizes a full dossier in about 60 seconds for five cents. VIP contacts get the deep treatment with ongoing monitoring via Google Alerts and social feeds. If you're building your own second brain or CRM and want to see how someone wires up multi-source intelligence gathering with actual cost and latency numbers, the source is worth reading through.

skills.sh installs: 3.3K
GitHub stars: 65
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add joelhooks/joelclaw --skill contacts --agent claude-code

Installs into .claude/skills of the current project.

Files

Contacts

Manage contacts in ~/Vault/Contacts/. Each contact is a markdown file with YAML frontmatter.

Contact File Location

~/Vault/Contacts/<Name>.md

Index file: ~/Vault/Contacts/index.md — wikilink list of all contacts.

Frontmatter Schema

---
name: Full Name
aliases: [nickname, handle]
role: Current Role / Title
organizations: [Org1, Org2]
vip: true  # or false
slack_user_id: U0XXXXXXX
slack_dm_channel: D0XXXXXXX  # null if unknown
website: https://example.com
github: username
twitter: handle
email: user@example.com
tags: [vip, instructor, creator, family, employee]
---

Sections

# Name

## Contact Channels
- Slack, email, social handles, website

## Projects
- Active projects, courses, collaborations

## Key Context
- Relationship notes, working style, history

## Recent Activity
- YYYY-MM-DD | channel | summary

See ~/Vault/Contacts/Matt Pocock.md for a fully enriched example.