pagen — Claude Code skill: what it does, how to install
Turns the agent into a personal CRM assistant to track contacts and log interaction notes.
npx skills add harperreed/dotfiles --skill pagen -a claude-codeWhat pagen 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.
What it helps with
- 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 for the agent
- Add a new contact named Alex Smith with email [email protected]
- Add a note to John Doe: met at the conference
- Export my contact list in markdown format
How to install pagen
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill pagen -a claude-code2Manually: put the files in place
~/.claude/skills/pagen/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pagen/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill pagen -a codex2Manually: put the files in place
.agents/skills/pagen/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill pagen -a cursor2Manually: put the files in place
.cursor/skills/pagen/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install harperreed/dotfiles pagen2Manually: put the files in place
.github/skills/pagen/SKILL.md1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill pagen -a gemini-cli2Platform CLI
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills-archive/pagenManually: put the files in place
.devin/skills/pagen/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill pagen -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pagen
How to install pagen in Claude Code?
Run npx skills add harperreed/dotfiles --skill pagen -a claude-code. This installs the definition file to ~/.claude/skills/pagen/SKILL.md.
What does pagen do?
It enables your assistant to act as a personal CRM, handling contact cards, logging relationship notes, and syncing with Google Contacts.
Where does pagen keep contact data?
Entries are kept in a local SQLite database at ~/.local/share/pagen/pagen.db. It also respects custom paths defined by XDG_DATA_HOME.