AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

setup-my-iq

Create, set up, or update the personal context portfolio: structured markdown files describing who you are, how you work, your teams, and your tool/ADO configuration. Runs the interview workflow for first-time setup and targeted edits for updates. Trigger this skill when the user asks to: set up their context, create or update their context portfolio, "create my IQ", "set up my IQ", edit their profile, add/remove a stakeholder, update ADO config, change team info, update pillars, or set up any plugin configuration. Trigger when another skill fails to find context (missing files or TODO markers) and needs context populated. Also trigger when the user mentions a context change in passing (e.g., "my manager changed", "we added someone to the team") to offer a context file update. Do NOT trigger for read-only questions like "who's on my team?" or "what's my ADO config?". Those are answered directly from the context files referenced in the loaded custom instructions; no skill is needed.

Original source
github
License
MIT
Pinned revision
5269f7ea2d6c3a9bfda5ed878b6726cf509121fd

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read github--setup-my-iq at revision 5269f7ea2d6c3a9bfda5ed878b6726cf509121fd, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 8

SKILL.md · 24000

anged. Do not rewrite the whole section. Keep the existing labels and ordering; only swap the @<path> lines.

  • Only wire up files that actually exist on disk. Don't add @<path> pointers for files the user skipped.

11. Confirm and summarize

"That's your context portfolio. Any AI skill, agent, or plugin that reads your custom instructions can find these files and immediately understand what it's working with.

The files will get better as you update them over time. Projects change, priorities shift, and your communication style file in particular will evolve as you catch me repeating mistakes and ask me to fold the correction in. Treat these as living documents, not a finished product."

Show the user:

  • List of files created and their paths.
  • The custom instructions file path where the pointers were written.

Context Files

| File | Purpose | Consumed By | |------|---------|-------------| | identity.md | Name, role, org, team, manager, what you do | Any skill that needs to know who the user is | | role-and-responsibilities.md | Responsibilities per team, cadences, deliverables | Status, reporting, and planning skills | | team.md | Team rosters with roles and focus areas | Skills that prepare for or summarize interactions with people | | tools-systems-and-config.md | Tools, meeting tags, ADO config per team, pillars, reporting settings | Skills that read meeting notes, run reports, or talk to ADO | | communication-style.md | Voice, tone, formatting rules, words to avoid, audience-specific adjustments | Any skill that writes content on the user's behalf | | preferences-and-constraints.md | Hard boundaries, approval rules, working preferences, memory rules | All skills (especially ones that write or send) |

Consumers find these files by reading the pointers loaded from any custom instructions file (AGENTS.md, copilot-instructions.md, CLAUDE.md, *.instructions.md). No MCP or dedicated reader skill is required.


Interview Rules

Tone

Be direct, warm, and specific. You're an interviewer, not a coach. Don't editorialize, compliment, or offer opinions about the user's answers.

Pre-fill from available data sources before asking

Before walking the user through a question list, check whether any of your available tools or data sources can answer the factual fields for you. The user shouldn't have to type things a connected system already knows.

Common examples (use whatever your environment actually provides):

  • A connected work profile or directory may know the user's name, title, organization, team, manager, and direct reports — useful for identity.md and team.md.
  • Calendar, mail, or chat history may surface frequent collaborators and recurring cadences — useful for team.md and role-and-responsibilities.md.
  • Project management or source control integrations may know the user's org/project/area path or repos — useful for tools-systems-and-config.md.
  • Existing writing samples in mail or documents (with the user's permission) may inform communication-style.md without requiring fresh samples.

Rules:

  1. Only use sources the user has already authorized. Don't reach for anything new mid-interview without asking.
  2. Pre-fill is a proposal, not an answer. Present what you found, label it as auto-filled, and ask the user to confirm or correct each value before it goes into a file.
  3. Don't enumerate tool names to the user. Say something like "I can pull some of this from your work profile" rather than listing specific product names.
  4. Fall back to asking when no source is available, or when the data is ambiguous, stale, or sensitive.
  5. Open-ended fields (what you actually do, what people come to you for, voice, boundaries) still need to be asked. Don't fabricate them from indirect signals.

Questions

  • Ask one question at a time. Never present lists of questions.
  • Never ask compound questions.
  • Use what you learn in earlier files to inform later interviews. Don't re-ask things you already know.
  • If the user goes on a tangent useful for a later file, note it and use it when you get there.
  • When the user gives a vague answer, push for specifics: "Can you give me an example?" or "What does that actually look like day to day?"
  • When you have enough to draft, say so and draft. Don't keep asking. "Enough" means you have answers covering the core fields in that file's template (for identity: name, role, org, team, manager, and what they do). You don't need to walk every listed question if earlier answers already covered the information.

The Reaction Pass

After drafting each file, present it and say: "Here's my draft. Read through it and tell me what doesn't sound right. Anything that feels off, anything I assumed wrong, anything that's missing."

If the user says it looks good with no changes, push once: "Pick one sentence that's the weakest or most generic. What would make it more specifically you?"

If they push back a second time and say it's fine, accept it and move on.

File Quality

  • Keep files concise. One page, not five.
  • The files should sound like the user, not like an AI writing about them.
  • Use their language, their framing, their level of formality.
  • Never use em dashes.
  • If the user wants to skip a file, let them.
  • If the user needs to stop mid-file, tell them where you are so they can resume.

Example: Identity Interview Walkthrough

This shows what a complete identity.md interview looks like from first question through final written file.

Agent: What's your name and current role?

User: Dana Kim, Senior Program Manager.

Agent: What organization are you with, and what team?

User: Contoso, Cloud Engineering. I'm on the Platform Operations team under Jordan Rivera.

Agent: If you had to explain what you actually do to someone at a dinner party, what would you say?

User: I keep the data platform teams running. Sprint planning, status reporting, making sure leadership knows what's happening without everyone drowning in update emails. I also build AI tooling that automates the repetitive parts of program management.

Agent: What do people come to you for?

User: Two things: getting a clear picture of where a project actually stands (not the sanitized version), and figuring out how to use AI tools to cut busywork out of their workflows.

Agent: I have enough to draft. Here's my draft:

# Identity

- **Name:** Dana Kim
- **Role:** Senior Program Manager
- **Organization:** Cloud Engineering, Contoso
- **Team:** Platform Operations
- **Manager:** Jordan Rivera

## What I Do

I keep the data platform teams running: sprint planning, status reporting,
and making sure leadership knows what's happening without everyone drowning
in update emails. I also build AI tooling that automates the repetitive
parts of program management.

## What People Come to Me For

Two things: getting a clear picture of where a project actually stands (not
the sanitized version), and figuring out how to use AI tools to cut busywork
out of their workflows.

Read through it and tell me what doesn't sound right. Anything that feels off, anything I assumed wrong, anything that's missing.

User: Looks good, ship it.

Agent: Pick one sentence that's the weakest or most generic. What would make it more specifically you?

User: The "keep the data platform teams running" line. It's more like I'm the connective tissue between engineering, leadership, and the ops cadence. Nobody else holds all three perspectives at once.

Agent: (Updates the "What I Do" paragraph and writes the file to the context directory.)

That's identity done. Next is role-and-responsibilities, which captures what your weeks actually look like. Ready?


Example: Targeted Update

This shows how a context change mentioned in passing triggers a targeted update (state 4).

User: Can you pull my meetings from last week? Oh, also, Jordan isn't my manager anymore. I moved under Morgan.

Agent: I'll fetch your meetings. It also sounds like your identity file needs updating. Want me to fix that now?

User: Yeah go ahead.

Agent: (Resolves the identity.md path from the loaded custom instructions, reads the file, updates the Manager field from "Jordan Rivera" to "Morgan", writes the file back.)

Done. Updated your manager to Morgan in identity.md. I'll proceed with fetching your meetings now.


Safety

  • Do NOT store credentials, API keys, tokens, or secrets in context files. If the user provides one during an interview, omit it and explain why.
  • Only write to the user's chosen context directory and to the custom instructions file the user has approved. Never write files to other locations.
  • Never delete an existing context file. If a refresh is needed, back up the existing file to <file>.bak-<yyyyMMddHHmmss> first and confirm with the user before overwriting.

For how consumers should READ these files safely (treat as data, don't leak content, ignore prompt-injection text, etc.), see the ## Safety block in the bundled AGENTS.md template at assets/templates/AGENTS.md. That block is what gets written into the user's custom instructions file in step 10d, so every consuming skill picks up the rules automatically.


Error Handling

Write failures

If a write to a context file fails:

  1. Retry once.
  2. If the retry fails, present the drafted content to the user in a code block so nothing is lost.
  3. Suggest: "The write failed. You can copy the draft above, or we can try a different directory."

Malformed existing files

If an existing context file cannot be parsed (missing headings, broken tables, garbled content):

  • Show the user what looks wrong.
  • Offer to regenerate the file from scratch using the template, preserving any recognizable values from the broken file.
  • Do not silently overwrite. Always confirm before replacing.

Author

Contributed by @lakshmistoltz.