agentleFS
LuisUrrutiaLuisUrrutia/skills/people-memory/SKILL.md

people-memory

Skill2 starsChanged 15 days agoMITView on GitHub

Maintains Obsidian Personal vault People profiles in `06 - People/` as persistent relationship memory during conversation. Use when any person is mentioned by full name, aliases, nicknames, or contextual references, or when the user asks to create or update a person profile.

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 8 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep useful relationship memory in Obsidian People profiles without writing noise.

    line 10
  2. Very specific:

    Search existing profiles under 06 - People/ by filename, aliases, known names, and relevant context.

    line 16
  3. Very specific:

    Use Assets/Templates/t.people.md as the source template convention for new profiles.

    line 18
  4. Distinctive:

    If creation or a prompt is needed, use TEMPLATES.md for the exact profile shape and question wording.

    line 25
  5. Distinctive:

    Write only when allowed by the write gate.

    line 26
  6. Distinctive:

    Run the QA checklist before responding.

    line 28
  7. Distinctive:

    Write only when one of these is true:

    line 34
  8. Distinctive:

    Do not write when:

    line 39
  9. Distinctive:

    Ask one direct clarification question, then stop, when:

    line 47
  10. Distinctive:

    Do not expose unrelated profile contents.

    line 62
  11. Very specific:

    Do not read .omo/ runtime state for memory content, and do not edit .omo/.

    line 64

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

People Memory

Purpose

Keep useful relationship memory in Obsidian People profiles without writing noise. This skill is a concise entry point, with detailed matching, prompts, and QA kept in the companion docs.

Quick Start

  1. Trigger on any person mention, including full names, aliases, nicknames, and contextual references such as my manager, my cousin, or the founder I met last week.
  2. Load REFERENCE.md before matching or updating.
  3. Search existing profiles under 06 - People/ by filename, aliases, known names, and relevant context.
  4. Decide whether the write gate passes before editing.
  5. Use Assets/Templates/t.people.md as the source template convention for new profiles.
  6. Load QA.md before reporting completion after any write.

Core Workflow

  1. Detect the person mention or explicit create/update request.
  2. Match the person using REFERENCE.md, including confidence and contextual reference rules.
  3. If creation or a prompt is needed, use TEMPLATES.md for the exact profile shape and question wording.
  4. Write only when allowed by the write gate.
  5. Preserve existing profile structure and fields while making the smallest useful change.
  6. Run the QA checklist before responding.

Write Gate

Triggering is broad. Writing is narrow.

Write only when one of these is true:

  • The user explicitly asks to create or update a person profile.
  • The conversation adds new useful relationship memory, such as identity, contact details, role, company, alias, where-met context, preferences, commitments, follow-ups, or meaningful conversation notes.

Do not write when:

  • The person is only mentioned in passing.
  • The fact is already present in the matched profile.
  • The information is vague, unresolved, or not useful as durable relationship memory.

Ask Instead Of Writing

Ask one direct clarification question, then stop, when:

  • A name, alias, or nickname matches multiple plausible profiles.
  • A contextual reference does not resolve to exactly one confident person.
  • Creation is requested but the full name or one context clue is missing.
  • The update would overwrite an existing email, phone, linkedin, or company value.

Output Contract

Return exactly one of these modes:

  1. Mini diff after write: name the profile path and summarize only the fields or notes changed.
  2. No-write response: say no write was made and give the short reason.
  3. One clarification question and stop: ask only what is needed to proceed.

Do not expose unrelated profile contents.

Do not read .omo/ runtime state for memory content, and do not edit .omo/.

References

  • Load REFERENCE.md before matching, creating, or updating any profile.
  • Load TEMPLATES.md when you need exact prompts, profile shape, or output wording.
  • Load QA.md before reporting completion after a write.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.