Name: jazz-schema-design
Rating: 67.2 (1 reviews)
Author: garden-co

jazz-schema-design

Design and implement collaborative data schemas using the Jazz framework. Use this skill when building or working with Jazz apps to define data structures using CoValues. This skill focuses exclusively on schema definition and data modeling logic.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

The canonical home for this skill is jazz-schema-design in garden-co/classic-jazz

Quality

Content

82%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, action-dense reference for Jazz schema modeling with strong executable examples and clear on-demand external references. Minor verbosity and inlined reference-style detail keep it just short of the top anchors.

Dimension	Reasoning	Score
Conciseness	The body is dense and largely lean—tables, code blocks, and rules with minimal padding—though a few editorial lines ('Permissions are integral to the data model, not an afterthought') and the long 'USE EXTREME CAUTION' paragraph could be trimmed slightly.	4 / 5
Actionability	Numerous copy-paste-ready TypeScript examples (maps, withPermissions, forward references, migrations, accounts) cover the common schema-design cases with concrete, executable code.	5 / 5
Workflow Clarity	A 'Design Checklist' sequences the design process and migration guidance includes early-exit and per-load warnings, but there is no explicit validate→fix→retry feedback loop; this is a reference-style skill rather than a destructive/batch workflow, so the cap does not apply.	4 / 5
Progressive Disclosure	No bundle files exist (references/scripts/assets absent), sections are well organized, and the References section links five external docs on a clearly signaled one-level 'load on demand' basis; some inlined reference detail (permission option table, full type table) could live in separate files.	4 / 5
	Total	17 / 20 Passed

Description

78%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 clear, third-person description that answers both what and when with concrete triggers and a tight scope. Slightly limited specificity (narrow action set) and a broad opening trigger that relies on the 'exclusively' qualifier to avoid sibling-skill overlap.

Suggestions

Lead with the scoped trigger ('Use when designing data models, defining CoValue schemas, or planning schema migrations for Jazz apps') so the 'when' is distinct from sibling Jazz skills before any broad wording.

Add one or two more concrete actions (e.g., 'configure schema-level permissions', 'plan schema migrations') to lift specificity above the 1-2-action level.

Dimension	Reasoning	Score
Specificity	The description names the domain (Jazz, CoValues) and a couple of concrete actions ('Design and implement collaborative data schemas', 'define data structures using CoValues'), but coverage stays narrow to schema definition rather than listing multiple specific actions.	3 / 5
Completeness	It explicitly states both what it does ('Design and implement collaborative data schemas') and when to use it ('Use this skill when building or working with Jazz apps to define data structures using CoValues') with concrete trigger phrasing.	5 / 5
Trigger Term Quality	Natural terms a user would say appear ('data model', 'schema', 'Jazz apps', 'data structures') with good coverage, though a few synonyms or variations are missing.	4 / 5
Distinctiveness Conflict Risk	'Focuses exclusively on schema definition and data modeling logic' carves a clear niche, but the broad 'building or working with Jazz apps' trigger could overlap sibling Jazz skills before the scope clause disambiguates.	4 / 5
	Total	16 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: garden-co/classic-jazz
Path: packages/cursor-docs/.skills/jazz-schema-design/SKILL.md
Commit: 4f90501

Reviewed: 8 days ago

Table of Contents

Discovery Implementation Validation

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.