Execute use when you need to work with ORM code generation. This skill provides ORM model and code generation with comprehensive guidance and automation. Trigger with phrases like "generate ORM models", "create entity classes", or "scaffold database models".
49
54%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/database/orm-code-generator/skills/generating-orm-code/SKILL.mdQuality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description adequately communicates its purpose and includes explicit trigger guidance, which is a strength. However, it relies on vague filler language ('comprehensive guidance and automation') rather than listing specific concrete capabilities, and the trigger terms could be expanded to cover more natural user phrasings and specific ORM technologies. The second-person 'you' in the opening line is a minor voice issue.
Suggestions
Replace vague phrases like 'comprehensive guidance and automation' with specific concrete actions, e.g., 'Generates ORM entity classes, repository patterns, migration scripts, and relationship mappings'.
Expand trigger terms to include specific ORM frameworks (SQLAlchemy, Hibernate, Prisma, TypeORM) and related terms users might say like 'database schema to code', 'model classes', or 'data access layer'.
Rewrite in third person voice ('Generates ORM models and scaffolds database code') instead of second person ('when you need to work with').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (ORM code generation) and mentions some actions like 'generate ORM models', 'create entity classes', 'scaffold database models', but the core description 'provides ORM model and code generation with comprehensive guidance and automation' is vague and doesn't list specific concrete actions beyond the trigger phrases. | 2 / 3 |
Completeness | It answers both 'what' (ORM model and code generation) and 'when' (explicitly states 'Use when you need to work with ORM code generation' and provides trigger phrases), satisfying the explicit trigger guidance requirement. | 3 / 3 |
Trigger Term Quality | Includes some relevant trigger terms like 'generate ORM models', 'create entity classes', 'scaffold database models', but misses common variations users might say such as specific ORM frameworks (SQLAlchemy, Hibernate, Prisma), 'database schema', 'migration', 'model classes', or 'data access layer'. | 2 / 3 |
Distinctiveness Conflict Risk | ORM code generation is a reasonably specific niche, but the description could overlap with general code generation skills or database-related skills. The trigger terms help narrow it somewhat but 'code generation' is broad enough to cause potential conflicts. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a comprehensive but overly broad overview of ORM code generation across six frameworks. Its main weakness is trying to cover too much in a single file without executable code examples or progressive disclosure into framework-specific guides. The workflow is reasonably clear but lacks intermediate validation checkpoints and concrete, copy-paste ready output examples.
Suggestions
Split ORM-specific guidance (Prisma, TypeORM, SQLAlchemy, Drizzle, Django, Sequelize) into separate referenced files, keeping SKILL.md as a concise overview with navigation links to each.
Add at least one fully executable code example showing the complete flow for one ORM (e.g., a Python script that introspects a schema and generates SQLAlchemy models), rather than narrative descriptions.
Add intermediate validation checkpoints after type mapping (step 3) and relationship detection (step 5), with explicit fix-and-retry loops for common errors.
Trim the examples section to show actual generated output (e.g., a concrete Prisma schema block) rather than describing what would be generated narratively.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately verbose. It covers six different ORMs in a single file, leading to broad but shallow coverage. Some sections like the examples are descriptive rather than concrete, and the overview/prerequisites contain information Claude could infer. However, it's not egregiously padded with basic concept explanations. | 2 / 3 |
Actionability | The instructions provide a clear sequence of steps and mention specific commands (e.g., `npx prisma migrate dev`, `alembic revision --autogenerate`), but lack executable code examples. The type mapping table is useful but the examples section describes scenarios narratively rather than showing actual generated output. No copy-paste ready code blocks for the core generation logic. | 2 / 3 |
Workflow Clarity | The 10-step workflow is clearly sequenced and step 10 includes validation against a temporary database. However, the validation step is at the very end rather than integrated as checkpoints throughout. There's no explicit feedback loop (validate -> fix -> retry) for intermediate steps like type mapping or relationship detection, which are error-prone operations. | 2 / 3 |
Progressive Disclosure | The entire skill is a monolithic document with no bundle files and no references to supplementary materials. Given the breadth of six ORMs, the content would benefit enormously from splitting ORM-specific guidance into separate files. The Resources section links to external docs but there's no internal progressive disclosure structure. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | 9 / 11 Passed | |
6e9558f
Table of Contents
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.