skills.rest
JKHeadley
JKHeadleyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agent-identity

Create persistent agent identity files for Claude Code sessions.

75|18|Updated Feb 19, 2026
Search Tags:#project setup#claude code#session memory#persistent context#agent identity#context compaction
One-click install
npx skills add https://github.com/JKHeadley/instar --skill agent-identity-jkheadley
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-identity
Source: https://github.com/JKHeadley/instar/tree/main/skills/agent-identity
Command: npx skills add https://github.com/JKHeadley/instar --skill agent-identity-jkheadley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents Claude Code sessions from starting blank by persisting who the agent is, who it works with, and what it has learned across restarts and context compaction.

Core Features & Use Cases

  • Persistent identity files: Creates AGENT.md, USER.md, and MEMORY.md so the agent has a stable self-model and project memory.
  • Session-start grounding: Adds a CLAUDE.md instruction block that tells the agent to read identity files at the beginning of every session.
  • Long-running project support: Helps teams maintain consistent behavior, preferences, and lessons learned in projects that span many sessions.
  • Use case: Set up a new Claude Code project so the agent remembers its role, your communication style, and important project discoveries after every restart.

Quick Start

Ask the agent to create the identity files under .claude/identity and wire them into CLAUDE.md so they are read at every session start.

Frequently Asked Questions about agent-identity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep persistent context across Claude Code sessions after restarts?▼

Persistent context across Claude Code sessions is maintained by creating AGENT.md, USER.md, and MEMORY.md files under .claude/identity and wiring them into CLAUDE.md to be read at every session start.

Why does my Claude Code agent lose its identity and memory after context compaction?▼

Claude Code agents lose identity after context compaction because session memory is volatile. Adding a CLAUDE.md instruction block forces the agent to read persistent identity files immediately after compaction occurs.

How do I set up agent identity files for a new Claude Code project?▼

To set up agent identity files, ask the agent to create AGENT.md, USER.md, and MEMORY.md under .claude/identity, then add a CLAUDE.md instruction block directing the agent to read them at session start.

Can I maintain stable user preferences and project memory for long-running Claude Code projects?▼

You can maintain stable user preferences and project memory for long-running Claude Code projects by persisting agent identity, user communication style, and lessons learned in dedicated markdown files.

Does Claude Code support persistent agent self-models across multiple team sessions?▼

Claude Code supports persistent agent self-models by reading AGENT.md, USER.md, and MEMORY.md files configured in CLAUDE.md, ensuring teams maintain consistent agent behavior across new sessions and restarts.

Related Skills

Explore More Software Engineering Skills→
shawn-sandyshawn-sandy
2

path-rules-advisor

Generate path-specific rule files in .claude/rules/ from glob patterns.

Community
Intermediate
kortix-aikortix-ai
20.1k

kortix-memory

Manage persistent user preferences and per-project context via USER.md, MEMORY.md, and CONTEXT.md files.

Official
Advanced
JKHeadleyJKHeadley
75

instar-identity

Restore persistent agent identity from .instar files after session restarts.

Community
Advanced
rawvegrawveg
40

midjourney-replicate-flux

Transform basic descriptions into 5-layer Midjourney-style prompts for FLUX 1.1 Pro on Replicate.

Community
Advanced