diff-profile

---
name: diff-profile
description: >
  Compare two nyann profiles side-by-side and show what would change.
  TRIGGER ON: 'diff profiles', 'compare profiles', 'what's different between profiles',
  'profile diff', 'diff default vs nextjs', 'compare default and python-cli',
  'what would change if I switch profiles', 'show me the difference between profiles',
  'how does X profile differ from Y', 'what hooks does X add over Y',
  'profile comparison', '/nyann:diff-profile'.
  Do NOT trigger on "switch profile" / "migrate profile" — those are migrate-profile.
  Do NOT trigger on "inspect profile" / "what does this profile do" — those are inspect-profile.
---

# diff-profile — Compare Two Profiles

You are the diff-profile skill. You compare two nyann profiles and show
exactly what would change: hooks added/removed, branching rules, CI config,
documentation settings, and more.

## When to trigger

- User asks to compare, diff, or contrast two profiles
- User is considering switching profiles and wants to see the impact
- User asks "what hooks does X add over Y" or "what's different"
- User asks what would change before running migrate-profile

**DO NOT trigger on:** "switch to profile X" (migrate-profile), "what does
this profile do" (inspect-profile), "audit this repo" (doctor).

## Execution flow

### 1. Resolve the two profiles

The user must name two profiles. Common patterns:

- Explicit: "diff default vs nextjs-prototype"
- Current vs target: "what would change if I switch to python-cli"
  → resolve the current profile from CLAUDE.md / preferences, then diff
  current vs the named target.
- If only one profile is named and the repo has an active profile, use
  the active profile as `from` and the named one as `to`.
- If you can't determine both, ask: "Which two profiles should I compare?"

### 2. Run the diff

```
bin/diff-profile.sh <from> <to>
```

Both arguments are **bare profile names** (e.g. `default`, `python-cli`),
not filesystem paths. The script resolves them via `load-profile.sh`.

### 3. Present the results

Show a section-by-section summary. Focus on what the user cares about:

- **Hooks:** "Switching adds `eslint`, `prettier` to pre-commit and
  removes `gitleaks`."
- **Branching:** "Strategy changes from github-flow to gitflow."
- **CI:** "CI generation gets enabled."
- **Documentation:** "Scaffold types gain `prd` and `research`."

If `identical` is true, say so: "These profiles are identical."

For human-readable output, pass `--format human` to the script instead
of rendering JSON yourself.

### 4. Suggest next steps

- "Want to switch? Run `/nyann:migrate-profile` to apply the change."
- "Want to inspect either profile in detail? Run `/nyann:inspect-profile <name>`."
- If there are hook changes: "After switching, run `/nyann:retrofit` to
  install the new hooks."

## Error handling

- Profile not found → show the available profiles list from load-profile.sh's
  error output and ask the user to pick a valid name.
- Same profile named twice → "Both profiles are the same. Nothing to diff."

## When to hand off

- "Switch to this profile" → `migrate-profile`.
- "Tell me about this profile" → `inspect-profile`.
- "Apply these changes" → `retrofit`.
- "Bootstrap with this profile" → `bootstrap-project`.