From persona-manager
This skill should be used when the user asks to "update persona", "check for updates", "sync with framework", "persona maintenance", or mentions "persona drift", "persona outdated", or "update hooks". Detects drift between an existing persona and the current framework version, diffs persona files against current templates, and applies changes intelligently.
How this skill is triggered — by the user, by Claude, or both
Slash command
/persona-manager:persona-updateThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Diffs persona files against the current framework templates. You — the persona — are the merge engine. Read the diffs, understand what's framework vs custom, apply intelligently, and ask the user only when something is genuinely ambiguous.
Diffs persona files against the current framework templates. You — the persona — are the merge engine. Read the diffs, understand what's framework vs custom, apply intelligently, and ask the user only when something is genuinely ambiguous.
These are persona-specific and must never be overwritten:
CLAUDE.md personality, rules, skills table (only CHECK for missing framework sections).claude/skills/{domain}/user/profile.md, user/memory/.mcp.json.claude/output-styles/allowedDomains in settings.jsonenabledPlugins beyond persona-manager@personasTemplates live in the persona-dev skill's references/ directory (sibling skill in this plugin). Find them at ~/.claude/plugins/marketplaces/personas/plugins/persona-manager/skills/persona-dev/references/.
| Persona File | Template |
|---|---|
hooks.json | references/hooks-template.json |
.claude/settings.json | references/settings-template.json |
.gitignore | references/gitignore-template |
.claude/hooks/public-repo-guard.sh | references/public-repo-guard.sh |
.claude/skills/self-improve/SKILL.md | references/self-improve-skill.md |
.claude/output-styles/*.md | references/output-style-template.md |
CLAUDE.md and .claude-flags are too customized for template diffing — handle these conversationally (Step 5).
Output-style diffs: The output-style template provides structural guidance (sections, boundary rule). Persona customization in output-style files (personality, voice, specific opinions) must always be preserved — personality is unique to each persona. Only check for missing structural sections, not content alignment.
.framework-version from persona root (treat missing as 0.0.0)jq -r '.version' ~/.claude/plugins/marketplaces/personas/plugins/persona-manager/.claude-plugin/plugin.jsonFor each row in the mapping table:
Show a grouped summary:
## Drift Report for {name} ({current_version} → {plugin_version})
### hooks.json
- Missing: PostCompact hook (crash recovery after compaction)
- Changed: SessionStart command updated (dependency-free format)
- Preserved: Custom Stop prompt additions
### .claude/settings.json
- Missing: extraKnownMarketplaces entry
- Preserved: 5 custom allowedDomains entries
### .gitignore
- Missing: .DS_Store, Thumbs.db patterns
### No drift: public-repo-guard.sh, self-improve skill
Apply using your judgment:
jq for safe JSON manipulation. Always preserve persona-specific content.chmod +x.AskUserQuestion — show both versions, explain the conflict, let the user decide.These files are too customized for diffing. Check them conversationally:
CLAUDE.md — Read the persona's CLAUDE.md and verify these framework sections exist:
If any are missing, read references/claude-md-template.md for the canonical version and propose additions that fit the persona's style. Never rewrite personality or rules.
Output-style — Read .claude/output-styles/ files and verify:
keep-coding-instructions: false in frontmatter.claude-flags — Read and verify:
--name {persona} is present (use directory name)--setting-sources project,local is present--dangerously-skip-permissions is NOT present on Windows nativejq . hooks.json && jq . .claude/settings.jsontest -x .claude/hooks/public-repo-guard.sh.framework-versionchore({name}): update to framework v{version}Self-update: CWD is inside ~/.personas/{name}/ — update this persona directly.
Cross-update: CWD is elsewhere — ask which persona: ls ~/.personas/, then operate on ~/.personas/{name}/.
Batch: Update all personas — ls ~/.personas/, run on each sequentially, present a combined report.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub kickinrad/personas --plugin persona-manager