К основному содержанию
скилл CX Codex

django-drf · gentleman-programming — скилл для Claude Code: API и установка

Скилл django-drf помогает проектировать REST API на Django: ViewSet, сериализаторы, фильтры и тесты. Пригодится при сборке нового API.

Apache-2.0 162 установок ★ 678 обновлён 2026-03-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a claude-code
Открыть на GitHub

Что делает django-drf

Скилл задаёт шаблоны для Django REST Framework. Он показывает ModelViewSet с разными сериализаторами для создания, обновления и чтения, дополнительным действием activate, разрешениями и фильтрацией через UserFilter.

Внутри есть примеры сериализаторов для чтения, создания и обновления пользователей, пагинации, маршрутизации через DefaultRouter и настроек REST_FRAMEWORK. Также разобраны проверки владельца объекта и доступ администратора к операциям записи.

Отдельный раздел посвящён тестам с pytest, APIClient и force_authenticate, а также базовым командам manage.py. Фильтрация в примере использует django_filters, поэтому без этой библиотеки UserFilter не заработает.

Какие задачи решает

  • спроектировать ViewSet для REST API
  • разделить сериализаторы чтения, создания и обновления
  • добавить фильтры по email, статусу и датам
  • настроить пагинацию и маршруты API
  • проверить эндпоинты через APIClient

Примеры запросов агенту

  • Собери UserViewSet для REST API с отдельными сериализаторами создания и обновления.
  • Добавь UserFilter с поиском по email, is_active и диапазоном created_at.
  • Напиши тесты pytest для списка и создания пользователей через APIClient.

Как установить django-drf

1Через Skills CLI (Vercel)

npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a claude-code

2Вручную: положить файлы

~/.claude/skills/django-drf/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/django-drf/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о django-drf

Как установить django-drf в Claude Code?

Выполните npx skills add Gentleman-Programming/Gentleman-Skills --skill django-drf -a claude-code, затем проверьте файл ~/.claude/skills/django-drf/SKILL.md.

Что делает django-drf?

Скилл даёт паттерны для REST API на Django REST Framework: ViewSet, сериализаторы, фильтры, разрешения, пагинацию, маршрутизацию и тесты.

Какие темы по тестированию есть в django-drf?

Примеры используют pytest, APIClient, фикстуры для аутентифицированного клиента и проверки ответов для списка и создания пользователей.

Исходный текст

SKILL.md · Apache-2.0
---
name: django-drf
description: >
  Django REST Framework patterns.
  Trigger: When building REST APIs with Django - ViewSets, Serializers, Filters.
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.0"
---

## ViewSet Pattern

```python
from rest_framework import viewsets, status
from rest_framework.response import Response
from rest_framework.decorators import action

class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all()
    serializer_class = UserSerializer
    filterset_class = UserFilter
    permission_classes = [IsAuthenticated]

    def get_serializer_class(self):
        if self.action == "create":
            return UserCreateSerializer
        if self.action in ["update", "partial_update"]:
            return UserUpdateSerializer
        return UserSerializer

    @action(detail=True, methods=["post"])
    def activate(self, request, pk=None):
        user = self.get_object()
        user.is_active = True
        user.save()
        return Response({"status": "activated"})
```

## Serializer Patterns

```python
from rest_framework import serializers

# Read Serializer
class UserSerializer(serializers.ModelSerializer):
    full_name = serializers.SerializerMethodField()

    class Meta:
        model = User
        fields = ["id", "email", "full_name", "created_at"]
        read_only_fields = ["id", "created_at"]

    def get_full_name(self, obj):
        return f"{obj.first_name} {obj.last_name}"

# Create Serializer
class UserCreateSerializer(serializers.ModelSerializer):
    password = serializers.CharField(write_only=True)

    class Meta:
        model = User
        fields = ["email", "password", "first_name", "last_name"]

    def create(self, validated_data):
        password = validated_data.pop("password")
        user = User(**validated_data)
        user.set_password(password)
        user.save()
        return user

# Update Serializer
class UserUpdateSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ["first_name", "last_name"]
```

## Filters

```python
from django_filters import rest_framework as filters

class UserFilter(filters.FilterSet):
    email = filters.CharFilter(lookup_expr="icontains")
    is_active = filters.BooleanFilter()
    created_after = filters.DateTimeFilter(
        field_name="created_at",
        lookup_expr="gte"
    )
    created_before = filters.DateTimeFilter(
        field_name="created_at",
        lookup_expr="lte"
    )

    class Meta:
        model = User
        fields = ["email", "is_active"]
```

## Permissions

```python
from rest_framework.permissions import BasePermission

class IsOwner(BasePermission):
    def has_object_permission(self, request, view, obj):
        return obj.owner == request.user

class IsAdminOrReadOnly(BasePermission):
    def has_permission(self, request, view):
        if request.method in ["GET", "HEAD", "OPTIONS"]:
            return True
        return request.user.is_staff
```

## Pagination

```python
from rest_framework.pagination import PageNumberPagination

class StandardPagination(PageNumberPagination):
    page_size = 20
    page_size_query_param = "page_size"
    max_page_size = 100

# settings.py
REST_FRAMEWORK = {
    "DEFAULT_PAGINATION_CLASS": "api.pagination.StandardPagination",
}
```

## URL Routing

```python
from rest_framework.routers import DefaultRouter

router = DefaultRouter()
router.register(r"users", UserViewSet, basename="user")
router.register(r"posts", PostViewSet, basename="post")

urlpatterns = [
    path("api/v1/", include(router.urls)),
]
```

## Testing

```python
import pytest
from rest_framework import status
from rest_framework.test import APIClient

@pytest.fixture
def api_client():
    return APIClient()

@pytest.fixture
def authenticated_client(api_client, user):
    api_client.force_authenticate(user=user)
    return api_client

@pytest.mark.django_db
class TestUserViewSet:
    def test_list_users(self, authenticated_client):
        response = authenticated_client.get("/api/v1/users/")
        assert response.status_code == status.HTTP_200_OK

    def test_create_user(self, authenticated_client):
        data = {"email": "[email protected]", "password": "pass123"}
        response = authenticated_client.post("/api/v1/users/", data)
        assert response.status_code == status.HTTP_201_CREATED
```

## Commands

```bash
python manage.py runserver
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py shell
```

## Keywords
django, drf, rest framework, viewset, serializer, api, rest api

© gentleman-programming · Apache-2.0 · Gentleman-Programming/Gentleman-Skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →

Сначала — django-drf от других авторов.

django-drf prowler-cloud Скилл django-drf для быстрого создания REST API на Django с ViewSet'ами, сериализаторами и фильтрами по стандартам Prowler. Подключайте, когда пишете endpoints с RLS, JSON:API и OpenAPI документацией. CX Codex +1 484установок django-tdd affaan-m Скилл django-tdd настраивает TDD-разработку в Django и DRF с помощью pytest-django и factory_boy. Помогает писать тесты для моделей, фикстуры и проверять API. CX Codex +1 6 500установок django sanjeed5 Правило задаёт структуру проекта, организацию кода и паттерны безопасности для Django-приложений в Cursor. CX Codex +1 ★ 3 589звёзд репо django-expert https://github.com/Jeffallan Скилл django-expert помогает проектировать модели Django 5.0, настраивать сериализаторы DRF, оптимизировать ORM-запросы и конфигурировать аутентификацию по JWT. CX Codex +1 4 600установок django-rest-api-development Mindrally Скилл django-rest-api-development задаёт агенту правила разработки REST API на Django: структура проекта, сериализаторы, JWT-аутентификация и работа с запросами к базе. CX Codex +1 921установок rest-api-django Mindrally Скилл rest-api-django для Claude Code задаёт правила разработки Django REST API: структуру проекта, работу с сериализаторами и JWT-аутентификацией, борьбу с N+1. CX Codex +1 758установок django-access-review getsentry Скилл django-access-review ищет IDOR и дыры в авторизации Django: проходит по вьюхам, DRF-вьюсетам и ORM-запросам и показывает, где проверок не хватает. CX Codex +1 2 900установок

Из того же набора20

Весь набор →
elixir-antipatterns Скилл elixir-antipatterns для Claude Code содержит восемь антипаттернов Elixir и Phoenix для код-ревью и рефакторинга, включая N+1 в Ecto и логику в LiveView. CX Codex +1 194установок nextjs-15 Скилл задаёт паттерны работы с App Router в Next.js 15: маршрутизацию, Server Actions, параллельную загрузку данных и настройку middleware. CX Codex +1 185установок electron Организует структуру проекта на Electron, настраивает безопасный IPC через contextBridge и даёт типизированные шаблоны взаимодействия между процессами. CX Codex +1 175установок skill-creator Скилл skill-creator для Claude Code создаёт новые скиллы по спецификации Agent Skills. Оформляет повторяемые паттерны, проектные правила и сложные рабочие процессы. CX Codex +1 171установок angular-forms Скилл angular-forms для работы с формами Angular: покрывает Signal Forms (экспериментальные, на Angular 21+) и Reactive Forms для продакшена. Триггер срабатывает при работе с валидацией, состоянием формы или её созданием. CX Codex +1 150установок spring-boot-3 Набор правил для ИИ-агента: как писать конфигурацию, инъекцию зависимостей и REST-слой в Spring Boot 3, чтобы код не разъезжался по стилю. CX Codex +1 143установок ai-sdk-5 Помогает писать код на Vercel AI SDK 5 с учётом ломающих изменений после четвёртой версии. CX Codex +1 138установок jira-epic Скилл jira-epic генерирует готовые описания эпиков в Jira по стандарту Prowler со схемами Mermaid и разбивкой на задачи. CX Codex +1 138установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой