context-passport

majiayu000's avatarfrom majiayu000

Solve context fragmentation across Claude sessions. Use when users mention re-explaining themselves, losing conversation context, starting over, "you forgot," context loss, session continuity, picking up where we left off, or wanting Claude to remember across chats. Also use when users want to create/update their passport, generate session summaries, or maintain project continuity.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026

When & Why to Use This Skill

Context Passport is a specialized Claude skill designed to eliminate context fragmentation by maintaining a persistent, structured record of user identity and project history. By utilizing a GitHub-hosted 'PASSPORT.md', it allows Claude to remember specific preferences, past decisions, and project states across different sessions, ensuring seamless continuity and reducing the need for repetitive explanations.

Use Cases

  • Long-term Project Management: Maintain a 'Context Stack' of recent decisions and blockers to resume complex engineering or writing tasks across multiple days without re-explaining the background.
  • Personalized AI Interaction: Store a 'Brain Manual' containing communication preferences, learning styles, or ADHD accommodations to ensure every new Claude session is immediately optimized for your workflow.
  • Session Continuity: Generate and append automated session summaries to a central repository, allowing you to pick up exactly where you left off even after starting a fresh chat thread.
  • Knowledge Synchronization: Use a single source of truth for 'Don't Make Me Repeat' facts, ensuring Claude remembers specific technical constraints or personal details across all interactions.
namecontext-passport
descriptionSolve context fragmentation across Claude sessions. Use when users mention re-explaining themselves, losing conversation context, starting over, "you forgot," context loss, session continuity, picking up where we left off, or wanting Claude to remember across chats. Also use when users want to create/update their passport, generate session summaries, or maintain project continuity.

Context Passport

Maintain user and project context across Claude sessions via a structured GitHub-hosted document.

Core Components

1. The Passport (PASSPORT.md)

Token-efficient markdown in user's GitHub repo. See references/passport-template.md.

Sections:

  • Identity: Name, timezone, communication preferences
  • Brain Manual: ADHD accommodations, learning style, energy patterns
  • Active Projects: Current focus, phase, blockers
  • Context Stack: Recent decisions, open questions, where we left off
  • Don't Make Me Repeat: Facts explained too many times

2. Session Summary

Run scripts/session-summary.py on conversation exports to extract updates.

3. Quick-Start Prompt

User pastes at session start: "Read my Context Passport at [URL] and continue where we left off."

Workflows

Creating a New Passport

  1. Read references/passport-template.md
  2. Interview user for core info (max 5 questions)
  3. Generate PASSPORT.md
  4. User commits to repo

End-of-Session Update

  1. Export conversation (JSON preferred)
  2. Run session-summary.py
  3. Append to Context Stack
  4. Commit changes

Resuming with Context

  1. User provides passport URL or content
  2. Acknowledge context without restating
  3. Continue from Context Stack

Design Principles

  • Token-efficient: Passport under 500 words
  • Low-friction: 2-min end-of-session ritual max
  • Accountability: Git history shows evolution