people-notes
Skill0 starsChanged 2 months agoMITView on GitHub
Track durable per-person notes in the Obsidian vault: conversation history, pending topics to discuss, relationship context, project associations. Use when info is about a person and worth keeping beyond today. NOT for: one-off diary mentions (daily-journal), project decisions (project-tracking), or action items (task-tracking).
In this repository15 other files it gives its agents.
- daily-journalSkill
- goalsSkill
- idea-pipelineSkill
- knowledge-baseSkill
- meeting-notesSkill
- nightly-consolidationSkill
- project-trackingSkill
- resurfacingSkill
- second-brainSkill
- shopping-listSkill
- skill-tuningSkill
- standupSkill
- task-trackingSkill
- vault-recallSkill
- weekly-reviewSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. About 0 are common, 5 are distinctive, and 8 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
8
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 65
When creating a person note:
- Very specific: line 68
If the person already has a note, the call returns created=false and says so — add to the existing note instead of recreating it.
- Distinctive: line 71
When logging a conversation:
- Very specific: line 75
If the conversation belongs to a project, add it to ## Associated Projects and to the projects: property, and route project-specific …
- Very specific: line 76
If the conversation creates action items, route concrete tasks to task-tracking.
- Very specific: line 77
If it was just a daily-life note, optionally route a brief note to daily-journal when the user's wording suggests journaling.
- Very specific: line 81
Use ## Pending Topics for things the user wants to discuss with a person later.
- Very specific: line 83
If a pending topic is tied to a project, include the [[Project Name]] wikilink in the topic text.
- Very specific: line 84
If a topic carries a relative date ("before end of month"), resolve it with obsidian__date_resolve and write the exact date into the topic …
- Very specific: line 104
Do not use people files as the only place for project blockers or task commitments.
- Distinctive: line 108
Treat people notes as sensitive private context.
- Distinctive: line 109
Keep notes factual and useful.
- Distinctive: line 110
Do not expose people-note details in group chats or public channels.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
People Notes
Manage durable person-specific notes in the user's Obsidian second brain. Use second-brain for shared vault conventions, project-tracking for project state, and task-tracking for action items.
Tools
The server derives the path from the person's name, so never construct one. A person note is People/[First Last].md — spaces, not underscores, so [[First Last]] resolves.
| Need | Call |
| Create a person note | obsidian__note_create type="person" name="Jane Doe" |
| Read one | obsidian__vault_read note="Jane Doe" |
| Log a conversation | obsidian__section_append note="Jane Doe" section="Conversation History" content="| 2026-07-31 | Call | … |" |
| Add general context | obsidian__section_append note="Jane Doe" section="General Notes" content="…" |
| Add or check off a pending topic | obsidian__checklist_set note="Jane Doe" section="Pending Topics" item="…" |
| Associate a project | obsidian__section_append note="Jane Doe" section="Associated Projects" content="- [[Wayfinder]]" |
Update the projects: property | obsidian__note_set_field note="Jane Doe" field="projects" value="Wayfinder" |
obsidian__section_append appends at the end of the named section, so a conversation row cannot land under the wrong heading. ## Conversation History is a table: pass the content as a pipe-delimited row and the tool appends it as a row — if you pass prose, the error names the columns.
Person File Template
---
type: person
role: Employee / Client / Vendor / Family / Friend / Other
created: YYYY-MM-DD
projects: []
---
# [First Last]
## General Notes
Relevant strengths, preferences, context, or relationship notes.
## Conversation History
| Date | Context | Summary |
|------|---------|---------|
## Pending Topics
- [ ] Topic to discuss
## Associated Projects
- [[Project Name]]projects: holds quoted wikilinks: projects: ["[[Project Name]]"]. You do not write that syntax — obsidian__note_set_field note="Jane Doe" field="projects" value="Wayfinder, Atlas" takes plain names and quotes them, which is what makes Obsidian count them as graph edges. Keep it in sync with ## Associated Projects.
Workflow
When creating a person note:
obsidian__note_create type="person" name="First Last". Pass a known role asfields={"role":"Client"}. The sections above are laid out for you.- If the person already has a note, the call returns
created=falseand says so — add to the existing note instead of recreating it. - Populate only what is known. Do not infer sensitive personal details.
When logging a conversation:
- Determine the person and the date in the local timezone.
- Append the row:
obsidian__section_append note="First Last" section="Conversation History" content="| 2026-07-31 | Kickoff call | Agreed to send pricing |". Wikilink any projects or other people named in the summary. - If the conversation belongs to a project, add it to
## Associated Projectsand to theprojects:property, and route project-specific content toproject-tracking. - If the conversation creates action items, route concrete tasks to
task-tracking. - If it was just a daily-life note, optionally route a brief note to
daily-journalwhen the user's wording suggests journaling.
Pending Topics
- Use
## Pending Topicsfor things the user wants to discuss with a person later. Add one withobsidian__checklist_set note="First Last" section="Pending Topics" item="…". - Mark a topic handled with the same call plus
checked=true, and only when the user says it was handled. Nothing removes the line — a checked topic is the record that it happened. - If a pending topic is tied to a project, include the
[[Project Name]]wikilink in the topic text. - If a topic carries a relative date ("before end of month"), resolve it with
obsidian__date_resolveand write the exact date into the topic text — a relative phrase left in stored text is ambiguous to whoever reads it back later:
obsidian__date_resolve expression="end of month"
obsidian__checklist_set note="Jane Doe" section="Pending Topics" item="Follow up about the raise by 2026-08-31"Cadence
On "who haven't I talked to" or "who should I reach out to":
obsidian__vault_list type="person" stale_days=60, sorted oldest first (a nulllast_entry_date— never logged at all — sorts first, ahead of every real date).- For each, read the note and report: the person's name as a wikilink, their
last_entry_date(or "no logged conversation yet"), and any open items under## Pending Topics. - This is a suggestion, never a write — do not log a conversation, close a pending topic, or change
statusfrom a cadence check. The user decides who to reach out to; this skill only surfaces who has gone quiet.
Relationship to Projects and Tasks
- People files link to projects under
## Associated Projectsand in frontmatterprojects:. - Project files should hold project decisions, blockers, and waiting items, and link back to people via
people:frontmatter and[[First Last]]stakeholder links — this is what makes person-project connections visible in the graph from both sides. - Task files should hold actionable work, due dates, and waiting states.
- Do not use people files as the only place for project blockers or task commitments; route those to
project-trackingortask-trackingas well.
Privacy and Tone
- Treat people notes as sensitive private context.
- Keep notes factual and useful; avoid judgmental phrasing unless the user explicitly gives that wording.
- Do not expose people-note details in group chats or public channels.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

