CtrlK
BlogDocsLog inGet started
Tessl Logo

parallel-fix-django

Fix Django-specific blockers identified in parallelization readiness assessment

Install with Tessl CLI

npx tessl i github:jpoutrin/product-forge --skill parallel-fix-django
What are skills?

Overall
score

61%

Does it follow best practices?

Validation for skill structure

SKILL.md
Review
Evals

Discovery

33%

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 description identifies a narrow domain (Django parallelization blockers) but fails to provide concrete actions or explicit usage triggers. The technical jargon may not match natural user queries, and the lack of a 'Use when...' clause makes it difficult for Claude to know when to select this skill over others.

Suggestions

Add a 'Use when...' clause with trigger terms like 'parallel tests', 'Django test isolation', 'concurrent test failures', 'shared database state'

List specific concrete actions such as 'refactor database transactions', 'isolate test fixtures', 'resolve shared state conflicts', 'configure test database settings'

Include natural language variations users might say: 'tests failing in parallel', 'Django tests not thread-safe', 'test database conflicts'

DimensionReasoningScore

Specificity

Names the domain (Django) and a general action (fix blockers), but doesn't list specific concrete actions like 'refactor database connections', 'isolate test fixtures', or 'resolve shared state issues'.

2 / 3

Completeness

Describes what (fix Django blockers) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. The rubric caps completeness at 2 for missing triggers, and this is weaker than that threshold.

1 / 3

Trigger Term Quality

Includes 'Django' and 'parallelization' which are relevant technical terms, but uses jargon like 'parallelization readiness assessment' that users are unlikely to naturally say. Missing common variations like 'parallel tests', 'concurrent testing', 'test isolation'.

2 / 3

Distinctiveness Conflict Risk

Django-specific focus provides some distinction, but 'blockers' and 'parallelization' are vague enough to potentially overlap with general testing skills, CI/CD skills, or other Django-related skills.

2 / 3

Total

7

/

12

Passed

Implementation

65%

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

This skill provides highly actionable Django-specific fixes with excellent concrete code examples and clear before/after patterns. The main weaknesses are the lack of explicit validation checkpoints for risky operations (model migrations, squashing) and the monolithic structure that could benefit from splitting detailed fix patterns into separate reference files.

Suggestions

Add explicit validation steps after risky operations like model migrations and squashing (e.g., 'Run tests before proceeding', 'Verify migration applies cleanly')

Consider splitting detailed fix patterns into separate files (e.g., FIXES-APP-BOUNDARIES.md, FIXES-CONTRACTS.md) with SKILL.md providing overview and navigation

Add rollback guidance for fixes that might fail mid-way, especially for the 'God App' splitting workflow

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some redundancy in the fix patterns. The before/after examples are helpful but some sections could be tightened (e.g., the OpenAPI setup section has verbose explanations).

2 / 3

Actionability

Excellent actionability with fully executable code examples throughout. Every fix pattern includes concrete before/after code, specific commands, and copy-paste ready configurations for pyproject.toml, conftest.py, etc.

3 / 3

Workflow Clarity

The workflow has clear numbered steps (Read Report → Fix by Dimension → Re-run Assessment → Report Results), but lacks explicit validation checkpoints between fixes. For destructive operations like migration squashing or model moves, there's no verify-before-proceeding guidance.

2 / 3

Progressive Disclosure

References external files (remediation-checklist.md, infrastructure-setup.md) appropriately, but the main content is quite long with all fix patterns inline. The dimension-based organization helps, but detailed fix patterns could be split into separate reference files.

2 / 3

Total

9

/

12

Passed

Validation

91%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

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.