CtrlK
BlogDocsLog inGet started
Tessl Logo

django-verification

Run the full Django verification loop — environment check, mypy/ruff/black linting, migration safety, pytest with coverage targets, pip-audit and bandit security scans, settings and logging review, and diff review — producing a phased pass/fail report before release or PR. Use when preparing a Django pull request, validating migrations or coverage, or running pre-deploy readiness checks.

64

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/django-verification/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

Highly actionable and clearly sequenced: the 12-phase structure is easy to follow and nearly every phase gives executable commands with expected outcomes. The main weaknesses are a monolithic ~470-line body that inlines template/CI content better placed in reference files, redundant summary sections that inflate token cost, and implicit (rather than explicit) fix-and-retry validation gates after Phase 1.

Suggestions

Split the Output Template, GitHub Actions CI workflow, and Pre-Deployment Checklist into references/ files (e.g., references/output-template.md, references/ci-example.md) and link to them one level deep, which would also cut SKILL.md to a fraction of its current length.

Remove the Quick Reference table (it duplicates the commands already shown per phase) and drop the Phase 5 settings.DEBUG print in favor of the pass/fail checks dict already used in Phase 9.

Add explicit fail→fix→re-run gates after the security and migration phases (e.g., 'If pip-audit reports vulnerabilities, stop, upgrade the affected packages, and re-run this phase before continuing'), mirroring the Phase 1 stop-and-fix instruction.

DimensionReasoningScore

Conciseness

The body is mostly command listings with little re-explanation of concepts Claude already knows, but it carries noticeable padding: an ~80-line sample output report, a ~60-line GitHub Actions workflow, a Quick Reference table that duplicates commands already shown per phase, and a Pre-Deployment Checklist that repeats Phase 9 checks. It fits the score-3 anchor (mostly efficient but could be tightened) rather than 4, because the redundant template/CI/table sections are more than minor trimmable instances.

3 / 5

Actionability

Nearly all guidance is copy-paste ready (mypy/ruff/black/isort commands, pytest invocations, coverage targets table, settings checks with expected values), but there are minor gaps: speculative commands ('if gitleaks is installed', 'django-admin debugsqlshell # If django-debug-sqlshell installed', 'if using npm'), 'open htmlcov/index.html' which fails in headless contexts, and a Phase 5 check that only prints settings.DEBUG without pass/fail logic. This matches the score-4 anchor (mostly executable, minor gaps) rather than 5, where common cases would be fully covered without conditionals or manual interpretation.

4 / 5

Workflow Clarity

A clearly sequenced 12-phase pipeline with per-phase 'Report:' requirements, an explicit stop-gate in Phase 1 ('If environment is misconfigured, stop and fix'), and a final recommendation with next steps. It sits at the score-4 anchor (clear sequence, most checkpoints present, minor validation gaps) rather than 5 because feedback loops after Phase 1 are implicit — e.g., a failing pip-audit or migration conflict does not state 'fix and re-run before proceeding' — and Phase 3 applies migrations without an explicit re-verification step.

4 / 5

Progressive Disclosure

Sections are well-labeled (12 phases, checklist, quick reference), but the skill is a ~470-line monolith with no references/ files at all, inlining content that clearly belongs in separate files (the GitHub Actions CI workflow, the full output report template, the pre-deployment checklist). This matches the score-3 anchor (some structure, content that should be separate is inline) rather than 2, since headers make navigation genuinely easy; it cannot reach 4 because nothing is split out to one-level-deep references.

3 / 5

Total

14

/

20

Passed

Description

92%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: specific, comprehensive, third-person, and with an explicit 'Use when...' trigger clause covering the main scenarios. The only weakness is moderate synonym coverage in trigger terms, which slightly limits recall for phrasings like 'release readiness' or 'security audit'.

DimensionReasoningScore

Specificity

The description enumerates concrete actions — 'mypy/ruff/black linting', 'pip-audit and bandit security scans', 'pytest with coverage targets', 'settings and logging review, and diff review' — with comprehensive coverage of the loop's phases, all in third-person voice ('Run the full Django verification loop'). It matches the score-5 anchor (multiple specific concrete actions, comprehensive) and not score 4, since there are no notable gaps in the action list.

5 / 5

Completeness

It explicitly answers both what ('Run the full Django verification loop — ... producing a phased pass/fail report') and when ('Use when preparing a Django pull request, validating migrations or coverage, or running pre-deploy readiness checks') with concrete trigger phrases, matching the score-5 anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'Django pull request', 'validating migrations or coverage', 'pre-deploy readiness checks' — phrases users would plausibly say. A few natural terms are missing (e.g., 'release readiness', 'security audit', 'test suite', 'staging'), keeping it at the score-4 anchor rather than 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Django pre-release/pre-PR verification — with distinct triggers (migrations, coverage, pre-deploy) that would not collide with generic test/review skills. It fits the score-5 anchor (clear niche, distinct triggers, minimal conflict risk) and not score 4, since the Django-scoped tooling terms leave virtually no overlap ambiguity.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
affaan-m/ECC
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.