you

YOU.md

Your AI doesn't know you. This fixes that.

50 specialist frameworks analyze how you think, communicate, decide, what you're great at, and what you struggle with. It builds a living profile that makes Claude actually understand who you are — one global profile at ~/.claude/YOU.md, shared across every project.

Install (Claude Code Plugin)

Add this repo as a plugin marketplace and install globally, so the hook fires in every Claude Code session everywhere on your machine.

# Inside Claude Code:
/plugin marketplace add AliBassam/the-you-skill
/plugin install you@the-you-skill

That's it. No per-project setup. Your profile lives at ~/.claude/YOU.md and follows you into every directory.

To uninstall:

/plugin uninstall you@the-you-skill

Your ~/.claude/YOU.md is left untouched — delete it yourself if you want a clean slate.

How It Works

Two tiers:

Passive (every message)

A hook fires on every message you send, in every project. It injects your current global profile + a condensed signal detection guide covering all 50 dimensions. Claude silently observes your message, and if it detects new signal, it updates ~/.claude/YOU.md without telling you. You don't do anything — it just learns.

Deep analysis (/you)

When you type /you, the full orchestrator runs. It reads all 50 specialist sub-skill files, scans the conversation for signal strength, activates the relevant specialists, and does a thorough analysis pass. Then it gives you an honest summary of what it learned.

Passive = lightweight continuous learning. /you = the deep dive.

Context Footprint

The plugin is split into two hooks to keep per-turn overhead small:

• SessionStart — injects the static ~7KB signal-detection guide + update rules once when the session begins. Paid one time, not per message.
• UserPromptSubmit — on every message, injects only the current YOU.md + a one-line nudge to update it after the response.

That means the growing cost each turn is just the size of your profile, not the full guide. For most sessions this is negligible; if your profile gets very large over time, trim older/less useful observations in ~/.claude/YOU.md.

The 50 Dimensions

Cluster	Dimensions
Communication	Lexicon, Tone, Brevity Dial, Humor DNA, Conflict Voice, Request Grammar
Cognition	Learning Mode, Problem Cracker, Pattern Eye, Abstraction Layer, Focus Profile, Creative Spark, Memory Map
Technical	Code Signature, Architecture Mind, Debug Radar, Stack Identity, Test Philosophy, Ship Impulse, Docs Instinct
Decisions	Risk Thermostat, Speed/Quality Knob, Decision Velocity, Trade-off Algebra, Commitment Curve, Priority Stack
Psychology	Frustration Fingerprint, Confidence Map, Patience Waveform, Motivation Fuel, Stress Signature, Perfectionism Spectrum, Ego Elasticity, Energy Cycle
Social	Collaboration Stance, Authority Dynamic, Feedback Loop, Trust Ramp, Teaching Instinct, Empathy Radar
Values	Opinion Topology, Aesthetic Compass, Ethics Engine, Curiosity Gradient, Identity Anchors
Growth	Growth Edge, Blind Spot Atlas, Comfort Perimeter, Resistance Map, Evolution Trajectory

Confidence Tags

Every observation carries a tag:

• [hypothesis] — Seen once, could be situational
• [pattern] — Seen 2-3 times across contexts
• [established] — Consistent across many interactions
• [core] — Fundamental to who you are

Plugin Structure

.claude-plugin/
├── plugin.json                 ← Plugin manifest
└── marketplace.json            ← Marketplace manifest (makes this repo installable)
hooks/
└── hooks.json                  ← SessionStart + UserPromptSubmit registration
scripts/
├── you-session-start.sh        ← Fires once per session (static guide + seeds profile)
├── you-observe-active.sh       ← Per-turn slim hook; nudges Edit to ~/.claude/YOU.md (default)
└── you-observe-passive.sh      ← Per-turn slim hook; read-only, /you to update
skills/you/
├── SKILL.md                    ← Orchestrator (runs on /you)
└── you-*.md                    ← 50 specialist sub-skills

Your profile lives at ~/.claude/YOU.md — not inside this repo.

Modes

Default is active — auto-updates your profile on every message. To switch to passive (read-only, /you to update), edit the plugin's hooks/hooks.json and change:

"command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/you-observe-active.sh\""

to:

"command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/you-observe-passive.sh\""

Privacy

Everything is local. Your profile is a file on your machine at ~/.claude/YOU.md. Nothing leaves your machine. You can read, edit, or delete it at any time.

License

MIT