Personalize Skills
Walk through all customization points in your Operator Skills and set your personal values.
When to Use
- After first installing Operator Skills
- When you want to update your personal info
- After updating to a new version of the skills
How It Works
- Scan all skills for
[YOUR_*]placeholders - Ask you for each value (grouped by type)
- Update all occurrences across all skills
- Confirm what was changed
Invocation
/personalize-skills — Full interactive setup
/personalize-skills --list — Just show what needs customizing
/personalize-skills --reset — Clear customizations (restore placeholders)
Workflow
Step 1: Scan for Placeholders
Scan ~/.claude/skills/ for all [YOUR_*] patterns.
Group by placeholder type:
Found 12 placeholders across 6 skills:
Identity:
[YOUR_NAME] — used in 3 skills
[YOUR_EMAIL] — used in 2 skills
Paths:
[YOUR_CLOUD_PATH] — used in 2 skills
[YOUR_KNOWLEDGE_ARCHIVE] — used in 1 skill
URLs:
[YOUR_NOTION_URL] — used in 1 skill
Step 2: Collect Values
For each placeholder, ask the user:
[YOUR_NAME]
Used in: coach, writeup, inbox-commander
Description: Your name for personalized interactions
Example: Danny
What's your name? > ___
Group related questions:
- All identity questions together
- All path questions together
- All URL questions together
Step 3: Apply Changes
For each value provided:
- Find all occurrences of the placeholder
- Replace with the user's value
- Track what was changed
Applying changes...
✓ [YOUR_NAME] → "Alex" in 3 files
- coach/SKILL.md (2 occurrences)
- writeup/SKILL.md (1 occurrence)
- inbox-commander/references/known-senders.md (1 occurrence)
✓ [YOUR_EMAIL] → "alex@startup.com" in 2 files
- inbox-commander/SKILL.md
- inbox-commander/references/known-senders.md
Step 4: Confirm
Show summary:
Personalization complete!
Values set: 5
Files updated: 8
Placeholders remaining: 2 (optional)
Optional placeholders not set:
- [YOUR_KNOWLEDGE_ARCHIVE] — Only needed if you have a personal knowledge base
- [YOUR_NOTION_URL] — Only needed if you use Notion
You can set these later by running /personalize-skills again.
Placeholder Reference
Common placeholders and what they're for:
Identity
| Placeholder | Description | Example |
|---|---|---|
[YOUR_NAME] | Your name | Alex |
[YOUR_EMAIL] | Your email address | alex@company.com |
[YOUR_COMPANY] | Your company name | Acme Inc |
Paths
| Placeholder | Description | Example |
|---|---|---|
[YOUR_CLOUD_PATH] | Cloud storage folder | ~/Dropbox/ |
[YOUR_KNOWLEDGE_ARCHIVE] | Personal knowledge base | ~/Documents/knowledge/ |
[YOUR_DRAFTS_FOLDER] | Where to save drafts | ~/Documents/drafts/ |
URLs
| Placeholder | Description | Example |
|---|---|---|
[YOUR_NOTION_URL] | Notion workspace URL | your-workspace.notion.site |
Tips
Skip optional placeholders
If a placeholder is marked optional, you can skip it. The skill will work without it.
Update later
Run /personalize-skills again anytime to update your values.
Back up first
Before personalizing, consider backing up your skills directory:
cp -r ~/.claude/skills ~/.claude/skills-backup
Check the guide
See CUSTOMIZATION-GUIDE.md in the repo for detailed explanations of each placeholder.