CtrlK
BlogDocsLog inGet started
Tessl Logo

django-api

Django API development for 2025. Covers Django Ninja (modern, async-first, type-safe) and Django REST Framework (mature, ecosystem-rich). Use when building REST APIs, choosing between frameworks, implementing authentication, permissions, filtering, pagination, or async endpoints.

90

Quality

89%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-crafted skill description that excels across all dimensions. It provides specific capabilities, includes natural trigger terms developers would use, explicitly states both what it does and when to use it, and carves out a clear niche in Django API development that distinguishes it from general web development or Python skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'building REST APIs, choosing between frameworks, implementing authentication, permissions, filtering, pagination, or async endpoints' - these are all concrete, actionable capabilities.

3 / 3

Completeness

Clearly answers both what ('Django API development', 'Covers Django Ninja and Django REST Framework') and when ('Use when building REST APIs, choosing between frameworks, implementing authentication...') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'Django', 'REST APIs', 'Django Ninja', 'Django REST Framework', 'authentication', 'permissions', 'filtering', 'pagination', 'async endpoints' - all terms developers naturally use when seeking API help.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with clear niche: specifically Django API development with named frameworks (Django Ninja, DRF). Unlikely to conflict with general Python skills or other web framework skills due to explicit Django and API focus.

3 / 3

Total

12

/

12

Passed

Implementation

79%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality, actionable skill with excellent code examples and efficient use of tokens. The framework comparison table and clear section organization make it easy to navigate. The main weaknesses are the lack of explicit validation workflows for API development and the monolithic structure that could benefit from progressive disclosure to separate files for the two frameworks.

Suggestions

Add a validation workflow section showing how to verify endpoints work (e.g., 'After creating endpoint: 1. Run server, 2. Test with curl/httpie, 3. Check response matches schema, 4. Verify in /docs')

Consider splitting Django Ninja and DRF into separate referenced files (e.g., 'For DRF details: See [DRF.md](DRF.md)') to reduce cognitive load and improve progressive disclosure

DimensionReasoningScore

Conciseness

The content is lean and efficient, using tables for comparison, minimal prose, and letting code examples speak for themselves. No unnecessary explanations of concepts Claude already knows.

3 / 3

Actionability

Provides fully executable, copy-paste ready code examples throughout—from setup to schemas, endpoints, authentication, testing, and deployment commands. All examples are complete and runnable.

3 / 3

Workflow Clarity

While individual sections are clear, the skill lacks explicit validation checkpoints or feedback loops. For API development involving database operations and external calls, there's no guidance on verifying endpoints work correctly before proceeding.

2 / 3

Progressive Disclosure

Content is well-organized with clear sections and a logical flow from framework choice to implementation details. However, this is a long monolithic document (~350 lines) that could benefit from splitting advanced topics (async, DRF details) into separate referenced files.

2 / 3

Total

10

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jpoutrin/product-forge
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.