Improving DRF Endpoints
Skill ActiveUse when editing, reviewing, or auditing DRF viewsets and serializers in PostHog. Triggers on files in posthog/api/, products/*/backend/api/, products/*/backend/presentation/, or any file importing rest_framework. Covers field typing, schema annotations, enum collision fixes, and OpenAPI spec quality — everything that flows downstream into generated TypeScript types and MCP tools.
Improve the quality and accuracy of DRF viewset and serializer definitions to ensure correct type generation for frontend, MCP tools, and API documentation.
Features
- Audits DRF viewsets and serializers.
- Covers field typing, schema annotations, and OpenAPI spec quality.
- Ensures correct TypeScript types and MCP tool compatibility.
- Provides guidance on `help_text`, `ListField`, `JSONField`, `SerializerMethodField`, and choice fields.
- Details best practices for `@validated_request` and `@extend_schema` decorators.
Use Cases
- Editing or reviewing files defining DRF `Serializer` or `ViewSet`.
- Fixing OpenAPI spec warnings or generated type issues.
- Preparing an endpoint for MCP tool exposure.
- Code review of API changes for type accuracy.
Non-Goals
- Directly modifying or executing code.
- Performing automated code fixes.
- Reviewing non-DRF code or general Python code.
Workflow
- Identify relevant DRF serializer or viewset files.
- Audit generated types and API schema for issues.
- Review serializer fields for `help_text`, typed lists/JSON, and explicit choices.
- Verify viewset methods have appropriate schema annotations (`@validated_request` or `@extend_schema`).
- Ensure correct response serializers and error types are defined.
- Apply recommended patterns and fix anti-patterns.
Practices
- API Design
- Code Quality
- Type Safety
- OpenAPI Specification
Trust
- warning:Issues AttentionThere are 544 open issues and 163 closed issues in the last 90 days, indicating a low closure rate and potentially slow response times.
Installation
npx skills add PostHog/posthogRuns the Vercel skills CLI (skills.sh) via npx — needs Node.js locally and at least one installed skills-compatible agent (Claude Code, Cursor, Codex, …). Assumes the repo follows the agentskills.io format.
Quality Score
Trust Signals
Similar Extensions
Google Docs
100Interact with Google Docs - create documents, search by title, read content, and edit text. Use when user asks to: create a Google Doc, find a document, read doc content, add text to a doc, or replace text in a document. Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication.
Django Framework
65Django full-featured Python web framework with batteries included (ORM, admin, auth)
X Twitter Scraper
100Use when the user needs X (Twitter) data or confirmation-gated X actions through Xquik: tweet search, user lookup, follower extraction, media download, monitoring, webhooks, MCP, SDKs, posting, likes, DMs, and profile updates. Requires a Xquik API key. Never ask for X login material.
Slack
100Use the Slack tool to react, pin/unpin, send, edit, delete messages, or fetch Slack member info.
Github
100Use gh for GitHub issues, PR status, CI/logs, comments, reviews, releases, and API queries.
Product Self Knowledge
100Stop and consult this skill whenever your response would include specific facts about Anthropic's products. Covers: Claude Code (how to install, Node.js requirements, platform/OS support, MCP server integration, configuration), Claude API (function calling/tool use, batch processing, SDK usage, rate limits, pricing, models, streaming), and Claude.ai (Pro vs Team vs Enterprise plans, feature limits). Trigger this even for coding tasks that use the Anthropic SDK, content creation mentioning Claude capabilities or pricing, or LLM provider comparisons. Any time you would otherwise rely on memory for Anthropic product details, verify here instead — your training data may be outdated or wrong.