# Personalize Skills

> Customize Operator Skills for your environment. Use when first installing skills or when you want to update your personal values. Use when this capability is needed.

- Skill: `tomevault-io/personalize-skills` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/personalize-skills`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/personalize-skills/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/personalize-skills

---


# 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:
```bash
cp -r ~/.claude/skills ~/.claude/skills-backup
```

### Check the guide
See CUSTOMIZATION-GUIDE.md in the repo for detailed explanations of each placeholder.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/dazuck) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->