refine-dev — скилл для Claude Code: CRUD на Refine
Скилл refine-dev по Refine: агент знает, как связать data provider, ресурсы и хуки, чтобы собрать админку на React поверх REST, GraphQL, Supabase или Strapi.
MIT 210 установок ★ 23 обновлён 2026-10-24
npx skills add itechmeat/llm-code --skill refine-dev -a claude-codeЧто делает refine-dev
Скилл даёт агенту рабочую модель Refine: адаптер бэкенда, объявленные ресурсы, хуки, auth provider и роутер. Рядом лежат справочники — data-providers.md, resources.md, routing.md, hooks.md, auth.md, mantine-ui.md, inferencer.md, notifications.md, i18n.md, realtime.md. В версии 5.0.12 useList и useTable сохраняют дополнительные поля, которые вернул getList.
Новый проект агент предложит поднять через npm create refine-app@latest с Vite, Mantine и REST либо поставить пакеты руками. Дальше фича собирается по шагам: объявить сущность в <Refine resources={[...]}>, написать страницы List/Create/Edit/Show, связать их с маршрутами и взять нужные хуки — useTable для списков, useForm для форм.
Ограничения прописаны жёстко, в разделе «Critical Prohibitions». Смешивать UI-библиотеки нельзя: выбрали Mantine — держитесь её. Данные тянуть только через хуки Refine, адреса API держать в конфигурации data provider, каждую CRUD-сущность объявлять в resources.
Какие задачи решает
- собрать админку на React поверх REST или GraphQL
- подключить Supabase или Strapi через data provider
- настроить вход и права в auth provider
- сгенерировать CRUD-страницы по схеме API через inferencer
- добавить живые обновления через LiveProvider
Примеры запросов агенту
- Собери админку для
postsна Refine с Mantine и REST-провайдером. - Почему
useTableне показывает лишнее поле, которое вернулgetList? - Добавь auth provider с проверкой ролей пользователя.
Как установить refine-dev
1Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill refine-dev -a claude-code2Вручную: положить файлы
~/.claude/skills/refine-dev/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/refine-dev/
1Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill refine-dev -a codex2Вручную: положить файлы
.agents/skills/refine-dev/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill refine-dev -a cursor2Вручную: положить файлы
.cursor/skills/refine-dev/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install itechmeat/llm-code skills/refine-dev2Вручную: положить файлы
.github/skills/refine-dev/SKILL.md1Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill refine-dev -a gemini-cli2Командой платформы
gemini skills install https://github.com/itechmeat/llm-code --path skills/refine-devВручную: положить файлы
.devin/skills/refine-dev/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add itechmeat/llm-code --skill refine-dev -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о refine-dev
Как установить refine-dev в Claude Code?
Выполните npx skills add itechmeat/llm-code --skill refine-dev -a claude-code. Файл скилла появится по пути ~/.claude/skills/refine-dev/SKILL.md.
Что делает refine-dev?
Разбирает с агентом устройство Refine: data provider, ресурсы, хуки, auth provider и роутер. Отдельные справочники посвящены inferencer, i18n, realtime и уведомлениям.
Refine даёт готовый интерфейс?
Это headless-фреймворк: логику CRUD он берёт на себя, а UI подключается отдельно, в скилле — Mantine. Поэтому две UI-библиотеки в одном проекте смешивать нельзя.
Исходный текст
SKILL.md · MIT
---
name: refine-dev
description: "Refine.dev headless React framework for CRUD apps: data providers, resources, routing, authentication, hooks, and forms. Use when building admin panels, dashboards, or internal tools with React and various backends (REST, GraphQL, Supabase, Strapi), or configuring Refine data providers and authentication. Keywords: Refine, CRUD, admin panel, data provider, React."
metadata:
version: "5.0.12"
release_date: "2026-04-02"
---
# Refine.dev Framework
Refine is a headless React framework for building enterprise CRUD applications. It provides data fetching, routing, authentication, and access control out of the box while remaining UI-agnostic.
## Core Concepts
Refine is built around these key abstractions:
1. **Data Provider** — adapter for your backend (REST, GraphQL, etc.)
2. **Resources** — entities in your app (e.g., `posts`, `users`, `products`)
3. **Hooks** — `useList`, `useOne`, `useCreate`, `useUpdate`, `useDelete`, `useForm`, `useTable`
4. **Auth Provider** — handles login, logout, permissions
5. **Router Provider** — integrates with React Router, etc.
## Quick Start (Vite)
Scaffold: `npm create refine-app@latest` (select Vite, Mantine, REST API). For manual setup, install `@refinedev/core @refinedev/mantine @refinedev/react-router` and Mantine packages.
## Minimal App Structure
```tsx
// src/App.tsx
import { Refine } from "@refinedev/core";
import { MantineProvider } from "@mantine/core";
import routerProvider from "@refinedev/react-router";
import dataProvider from "@refinedev/simple-rest";
import { BrowserRouter, Routes, Route } from "react-router-dom";
function App() {
return (
<BrowserRouter>
<MantineProvider>
<Refine
dataProvider={dataProvider("https://api.example.com")}
routerProvider={routerProvider}
resources={[
{
name: "posts",
list: "/posts",
create: "/posts/create",
edit: "/posts/edit/:id",
show: "/posts/show/:id",
},
]}
>
<Routes>{/* Your routes here */}</Routes>
</Refine>
</MantineProvider>
</BrowserRouter>
);
}
```
## Critical Prohibitions
- Do NOT mix multiple UI libraries (pick Mantine and stick with it)
- Do NOT bypass data provider — always use Refine hooks for data operations
- Do NOT hardcode API URLs — use data provider configuration
- Do NOT skip resource definition — all CRUD entities must be declared in `resources`
- Do NOT ignore TypeScript types — Refine is fully typed, leverage it
## Steps for New Feature
1. Define the resource in `<Refine resources={[...]}>`
2. Create page components (List, Create, Edit, Show)
3. Set up routes matching resource paths
4. Use appropriate hooks (`useTable` for lists, `useForm` for create/edit)
5. Configure auth provider if authentication is needed
## Definition of Done
- [ ] Resource defined in Refine configuration
- [ ] All CRUD pages implemented with proper hooks
- [ ] Routes match resource configuration
- [ ] TypeScript types for resource data defined
- [ ] Error handling in place
- [ ] Loading states handled
## Release Note (5.0.12)
- `useList` and `useTable` now preserve custom fields returned by `getList`, which matters when your data provider returns extra aggregate or pagination metadata alongside the row list.
## References (Detailed Guides)
### Core
- [data-providers.md](references/data-providers.md) — Data provider interface, available providers, custom implementation
- [resources.md](references/resources.md) — Resource definition and configuration
- [routing.md](references/routing.md) — React Router integration and route patterns
### Hooks
- [hooks.md](references/hooks.md) — All hooks: useList, useOne, useCreate, useUpdate, useDelete, useForm, useTable, useSelect
### Security & Auth
- [auth.md](references/auth.md) — Auth provider, access control, RBAC/ABAC, Casbin/CASL integration
### UI & Components
- [mantine-ui.md](references/mantine-ui.md) — Mantine components integration
- [inferencer.md](references/inferencer.md) — Auto-generate CRUD pages from API schema
### Utilities & Features
- [notifications.md](references/notifications.md) — Notification provider and useNotification hook
- [i18n.md](references/i18n.md) — Internationalization with i18nProvider
- [realtime.md](references/realtime.md) — LiveProvider for websocket/realtime subscriptions
## Links
- [Documentation](https://refine.dev/docs/)
- [Releases](https://github.com/refinedev/refine/releases)
- [GitHub](https://github.com/refinedev/refine)
- [npm](https://www.npmjs.com/package/@refinedev/core)
© itechmeat · MIT · itechmeat/llm-code