# pagen

Turns the agent into a personal CRM assistant to track contacts and log interaction notes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 336
- Author: harperreed
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/harperreed/dotfiles/tree/HEAD/.claude/skills-archive/pagen/SKILL.md
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/skills/pagen

## What it does

This skill guides the agent to handle personal CRM tasks via the `pagen` terminal utility. The agent looks up people, records interaction notes from meetings, and exports entries to Markdown or YAML. It also connects with Google Contacts and calendar data.

Records live in an SQLite database at `~/.local/share/pagen/pagen.db`. The utility relies on the `xdg` library, so it follows custom `XDG_DATA_HOME` paths when set.

No dedicated MCP server exists for this tool yet. The agent triggers CLI commands directly through Bash. Without the `pagen` utility installed locally, these commands will fail.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill pagen -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/pagen/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/pagen/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill pagen -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/pagen/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill pagen -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pagen/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install harperreed/dotfiles pagen
```

2. **Manually: put the files in place**
- File: `.github/skills/pagen/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill pagen -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills-archive/pagen
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pagen/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill pagen -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/harperreed/dotfiles/tree/HEAD/.claude/skills-archive/pagen/SKILL.md

## When to use it
- maintain a personal contact registry without web apps
- log quick notes after calls and conferences
- sync contact entries with Google Contacts
- export relationship history to Markdown or YAML

## Example prompts
- Add a new contact named Alex Smith with email alex@example.com
- Add a note to John Doe: met at the conference
- Export my contact list in markdown format

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

From the same set: [harperreed/dotfiles](https://affpapa.org/en/nevibecode/by/harperreed/dotfiles.md) — 26 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md