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

1. Scan all skills for [YOUR_*] placeholders
2. Ask you for each value (grouped by type)
3. Update all occurrences across all skills
4. 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:

1. Find all occurrences of the placeholder
2. Replace with the user's value
3. 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.