The bundled update-config skill (the one Claude uses to edit settings.json) was rewritten with explicit guidance on:
- When hooks are required vs preferences (
PreToolUse,PostToolUse,PreCompact,PostCompact,Stop,Notification,SessionStart). - "CRITICAL: Read Before Write" — always read the existing settings file before editing.
- Using
AskUserQuestionto disambiguate user/project/local scope. - Right-vs-wrong array merging examples for
permissions.allowand hook arrays. - Troubleshooting hook execution (debug flags, matcher checking, etc.).
Evidence
Skill prompt (search for "# Update Config Skill" and "## CRITICAL: Read Before Write").
Strings lifted out of the shipped bundle, so the claim above can be checked against them.