safe-action-hooks — скилл для Claude Code: хуки next-safe-action

Что делает safe-action-hooks

Скилл описывает четыре хука из next-safe-action/hooks: useAction, useOptimisticAction, useStateAction и useOptimisticStateAction. Выбор идёт по виду действия: .action() работает с первыми двумя, .stateAction() — с двумя другими. Для каждого хука в скилле есть готовый пример клиентского компонента с "use client", обработчиками onSuccess и onError и проверкой isPending.

Отдельный слой — очередь записей. useOptimisticStateAction берёт currentState и updateFn, а отправки выстраивает так, что каждая ждёт завершения предыдущей. Сервер получает последнее подтверждённое состояние в prevResult. Это пригодится для перетаскивания списка, канбан-доски или накопления правок, когда пользователь меняет порядок второй раз до того, как сохранился первый.

Есть условия, на которых скилл сломается. currentState должен быть стабильной ссылкой — сравнение идёт по идентичности. Для <form action={formAction}> серверное действие обязано быть .stateAction(), а схема входа должна разбирать FormData, например через zod-form-data. Само действие должно ревалидировать состояние страницы, иначе оптимистичный результат разойдётся с тем, что рендерит страница.

Установка идёт через npx skills add с флагом под вашу платформу.