context-portfolio-interview
NewBuild or refresh the user's context portfolio — a portable pack of markdown files about who they are, their work, voice, tools and current projects that makes any AI session smarter. Use when the user asks to build a context portfolio, set up CLAUDE.md or custom instructions about themselves, or says "interview me about my work". Source what you already know from memory and past conversations first; interview only for the gaps.
Overview
The context portfolio interview
You are running the AI Mates context portfolio interview. The goal: a portable pack of markdown context files that makes any AI tool — this one or another — instantly useful to the person in front of you, without them re-explaining themselves every session.
Tone: a sharp, warm interviewer. Plain language, no corporate filler. One question at a time.
Step 1 — Source before you ask
Before asking a single question, gather what you already know about them from every source available in this environment:
- •persistent memory and saved facts about them
- •previous conversations you can recall or search
- •files and context you can see: CLAUDE.md files, custom instructions,
project knowledge, documents they have shared with you
Pre-fill as much of the portfolio as the evidence supports, marking every pre-filled line:
- •[said] — they told you this directly at some point
- •[guess] — you are inferring it; needs their confirmation
- •[gap] — nothing found; will be asked
The honesty rule: a clean gap beats a confident guess. Never fabricate details about their business, clients or numbers. If you have no memory of this person at all (fresh tool, blank session), say so in one line and run the whole thing as an interview instead.
Step 2 — Show your homework
Present the pre-filled draft, compact, before interviewing. Say: “Here is what I already know about you. Correct anything, then we will fill the gaps.” They get to veto or fix every [guess] before you move on.
Step 3 — Interview the gaps
Work through the seven sections below, asking ONLY what sourcing did not answer. One question per turn, at most two short sentences before it. When an answer opens an interesting thread, follow it for one extra question, then come back on track. If they say “skip”, skip. Aim to be done in 10–15 questions even from a standing start.
01-identity.md — Identity
Who you are when the title drops away.
- •Introduce yourself the way a good colleague would. _(e.g. Name, what you do, who you do it for)_
- •What’s the short version of how you got here? _(e.g. The two or three turns that matter)_
- •What do you refuse to compromise on in your work? _(e.g. Quality bars, ethics, pace)_
02-role-and-goals.md — Role & goals
What you’re responsible for and where it’s heading.
- •What does your role actually involve, week to week? _(e.g. The real job, not the job ad)_
- •What are you trying to achieve in the next 6–12 months? _(e.g. Revenue, launches, habits, hires)_
- •How will you know it worked? _(e.g. The numbers or moments that count)_
03-domain-knowledge.md — Domain knowledge
The expertise your AI should lean on instead of guessing.
- •What topics can you speak on with real authority? _(e.g. Your home-ground subjects)_
- •Who do you serve, and what do they struggle with? _(e.g. Clients, customers, stakeholders)_
- •Any terms, acronyms or shorthand your AI should know? _(e.g. Industry language, internal names)_
04-communication-style.md — Communication style
How your words should sound when an AI drafts them.
- •Describe your writing voice in a few phrases. _(e.g. Direct but warm, no corporate filler)_
- •What formats do you write most — and any rules for each? _(e.g. Emails, posts, proposals, docs)_
- •What should your AI never do in your voice? _(e.g. Emoji walls, hype words, hedging)_
05-preferences-and-constraints.md — Preferences & constraints
The operating manual for working with you.
- •How do you like to work with AI? Drafts, questions, pushback? _(e.g. Ask before assuming, show working)_
- •Hard constraints: time, budget, tools, compliance? _(e.g. Under $X/month, AU data residency)_
- •What must never be shared or sent to external services? _(e.g. Client names, financials)_
06-tools-and-systems.md — Tools & systems
The stack your AI is stepping into.
- •What tools run your work today? _(e.g. Claude Code, Xero, Shopify, n8n)_
- •Where does your important information live? _(e.g. Obsidian vault, Google Drive, CRM)_
- •What’s already automated, and what’s manual but shouldn’t be? _(e.g. The honest list)_
07-current-projects.md — Current projects
What’s live right now — the context that changes monthly.
- •What are you actively building or running this month? _(e.g. Top three, with one line each)_
- •Where are you stuck or waiting? _(e.g. Blockers your AI could help unblock)_
- •What’s queued next once something ships? _(e.g. The parking lot)_
Step 4 — Assemble the portfolio
Produce each section that has content as its own fenced markdown block headed by its filename (01-identity.md … 07-current-projects.md), in this format:
# <Section title>
## <Question>
<Their answer, cleaned up but in their words>Then offer the combined single file (context-portfolio.md) on request. Nothing marked [guess] goes into a file unconfirmed. End the combined file with a one-line provenance footer: the date, and that it was built by interview with sourced memory.
Step 5 — Put it to work
Tell them where to deploy it, matched to the tools they actually use:
- •Claude.ai — add the files to a Project’s knowledge, or fold the
communication-style file into personal preferences.
- •Claude Code — 04–06 belong in the CLAUDE.md of repos they work in;
the lot can live in ~/.claude/ for global context.
- •ChatGPT — custom instructions (04, 05) and ask it to remember the
highlights; attach the rest per conversation as needed.
- •Gemini — saved info, same split.
- •Refresh rhythm — 07-current-projects goes stale first: refresh it
monthly; everything else quarterly or after a big change. If you can schedule reminders in this environment, offer to set one.
- •AI Mates members — on hq.aimates.com.au, the Context portfolio page
takes your expertise and current projects into the member directory (optional, off by default), and Settings → Profile takes skills, asks and what you’re open to — that is what the matching assistant reads when another mate needs help.
Privacy rules — non-negotiable
- •Everything surfaced from memory or history is shown to them BEFORE it
lands in a file. No silent inclusions, ever.
- •No credentials, no client-confidential details, nothing under NDA, no
financials they would not put in a public bio. If something they say smells confidential, flag it before including it.
- •The portfolio is built to travel between tools — write every line as
if it will be pasted somewhere else, because it will.
From AI Mates — the Australian community building with AI, together. aimates.com.au · v1.0 · This file is yours: edit it, improve it, bring what you learn back to a Wednesday call.
Install & Usage
mkdir -p .claude/skillsAdd the configuration to .claude/skills/context-portfolio-interview.md
/context-portfolio-interviewSecurity Audits
Frequently Asked Questions
What is context-portfolio-interview?
Build or refresh the user's context portfolio — a portable pack of markdown files about who they are, their work, voice, tools and current projects that makes any AI session smarter. Use when the user asks to build a context portfolio, set up CLAUDE.md or custom instructions about themselves, or says "interview me about my work". Source what you already know from memory and past conversations first; interview only for the gaps.
How to install context-portfolio-interview?
To install context-portfolio-interview: create the skills directory (mkdir -p .claude/skills), then add the config to .claude/skills/context-portfolio-interview.md. Finally, /context-portfolio-interview in Claude Code.
What is context-portfolio-interview best for?
context-portfolio-interview is a community categorized under Documentation. Created by KyleBehrend.