CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

django-perf-review

Django performance code review. Use when asked to "review Django performance", "find N+1 queries", "optimize Django", "check queryset performance", "database performance", "Django ORM issues", or audit Django code for performance problems.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is django-perf-review in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

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

A well-structured, highly actionable review skill with an excellent validated-only workflow, strong code examples, and thoughtful false-positive guidance. Its weaknesses are moderate redundancy across the validation sections and a monolithic 400-line body with no reference files to keep SKILL.md as a lean overview.

Suggestions

Move the detailed per-category pattern catalogs (Priorities 1-4) into reference files (e.g., references/n-plus-1.md, references/indexes.md, references/write-loops.md), leaving SKILL.md as a lean overview with the priority table, validation requirements, and output format.

Merge the 'Validation Requirements' section with the per-category checklists (or the closing sanity check) to eliminate the repeated validation guidance.

Complete the unfinished examples: show actual Prefetch/annotate code for the model-property rule and a runnable fix for the ORDER BY indexing rule.

DimensionReasoningScore

Conciseness

The body is largely efficient: compact PROBLEM/SOLUTION code pairs and impact tables assume Claude's competence without teaching Django basics. However, there is noticeable duplication — the 'Validation Requirements' section largely restates the per-category checklists, and the closing sanity-check questions repeat the 'What NOT to Report' list — keeping it at anchor 4 ('minor instances of over-explanation that could be trimmed') rather than the lean anchor 5.

4 / 5

Actionability

Most rules ship executable, copy-paste PROBLEM/SOLUTION code (select_related, annotate/Count, bulk_create, bulk_update, db_index, Meta.indexes) and a concrete output-format template. A few sections are incomplete — the model-property rule's fix is a one-line hint ('Use Prefetch with custom queryset, or annotate') with no code, and the ORDER BY example references code without a runnable fix — matching anchor 4 ('concrete code with minor gaps') rather than anchor 5's fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

The multi-step review workflow is clearly sequenced with explicit validation checkpoints: a 4-step Review Approach, per-category validation checklists, 5 numbered Validation Requirements, and a feedback loop in the output format ('If the answer to any is no - remove the finding') plus a pre-submission sanity check. This matches anchor 5's 'clear sequence with explicit validation steps; feedback loops; checklists for complex processes'.

5 / 5

Progressive Disclosure

There are no bundle files at all; the ~400-line body inlines detailed per-category pattern catalogs (N+1 rules, index rules, write-loop rules) that are natural candidates for one-level-deep reference files, with only internal headers for navigation. This matches anchor 3 ('content that should be separate is inline') — better than anchor 2's structureless dump thanks to the priority table and clean sections, but short of anchor 4's appropriate content split.

3 / 5

Total

16

/

20

Passed

Description

86%Weight 40%Scale 1-5

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

A strong description with excellent trigger-term coverage and an explicit, well-phrased 'Use when' clause. Its main limitation is a thin 'what' — a single composite action with no enumerated capabilities — plus one generic trigger phrase that slightly raises conflict risk.

Suggestions

Expand the 'what' clause to name the concrete capabilities (e.g., 'finds N+1 queries, unbounded querysets, missing indexes, and write loops in Django code') to complement the strong trigger list.

Scope the bare "database performance" trigger to Django (e.g., 'Django database performance') to eliminate overlap with generic SQL/database-performance skills.

DimensionReasoningScore

Specificity

The description names a specific domain ("Django performance code review") but states essentially one composite action — "audit Django code for performance problems" restates the same thing rather than enumerating distinct capabilities (e.g., finding N+1 queries, flagging unbounded querysets, checking indexes are only present as trigger terms, not capability claims). This matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") and falls short of anchor 4, which expects several specific listed actions.

3 / 5

Completeness

It clearly answers 'what' ("Django performance code review") and explicitly answers 'when' with concrete trigger phrases ("Use when asked to 'review Django performance', 'find N+1 queries'..."). Anchor 5's pattern of a clear what plus explicit when-with-concrete-triggers is met; anchor 4's deficiency ('when' could be more explicit) does not apply.

5 / 5

Trigger Term Quality

The "Use when" clause provides comprehensive natural user phrasing with synonyms: "review Django performance", "find N+1 queries", "optimize Django", "check queryset performance", "database performance", "Django ORM issues" — exactly the variations a user would naturally say. This matches anchor 5's comprehensive synonym coverage.

5 / 5

Distinctiveness Conflict Risk

The Django performance niche is clear and most triggers ("Django ORM issues", "find N+1 queries", "optimize Django") are distinct, but the bare trigger "database performance" is generic and could also fire for non-Django database-performance skills — minor overlap risk with a closely related skill, matching anchor 4 rather than anchor 5's 'minimal conflict risk'.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/django-perf-review/SKILL.md

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.