CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

framework-stores

How framework-owned tables in packages/core declare and change their schema with defineStore(). Use before adding a table, column, index, backfill or seed to a core store, before writing an ensure*Table() function, and when guard:release-schema-complete or SchemaNotMigratedError fires.

Quality

91%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally dense, high-signal body: rules are stated with their exact enforcement mechanisms, the worked example and command sequence are fully executable, and validation is baked into every step with named failing specs as feedback loops. The only structural criticism is that a ~120-line single file inlines readiness-mode and exception detail that a leaner SKILL.md plus one reference file could carry.

DimensionReasoningScore

Conciseness

Every token is repo-specific and load-bearing — rules carry only their own rationale ("the ledger would record it as applied and it would never retry") with no explanation of concepts Claude already knows and no padding. Matches the anchor-5 lean/efficient example; anchor 4 would require trimmable over-explanation, and none is present.

5 / 5

Actionability

Fully executable: a complete copy-paste defineStore() example with baseline, index and data migrations, exact commands ("pnpm gen:store-registry", "pnpm guard:release-schema-complete", "pnpm guard:additive-migrations"), named spec files, and a pointed test-helper ("db/store-ledger.test-helpers.ts"). Matches anchor 5's copy-paste-ready guidance covering the common cases.

5 / 5

Workflow Clarity

"Then run, in this order" gives a numbered generate → snapshot → guard → spec sequence with explicit validation checkpoints and failure feedback ("release-schema.snapshot.spec.ts fails when the snapshot no longer covers every schema migration"; the upgrade spec "fails when your change does not reach existing databases"). This satisfies the destructive/batch validation requirement that would otherwise cap the score at 3, and the error-recovery guidance ("fix the migration or the deploy, never catch it") matches anchor 5.

5 / 5

Progressive Disclosure

Sections are clear and well-ordered, but the ~120-line body inlines detail that could sit in reference files (the three readiness modes, the reviewed-exceptions list), and no bundle files exist at all. The <50-line simple-skill exception for scoring 5 does not apply; still comfortably above anchor 3 because nothing is misplaced or buried — it is genuinely good structure with minor organization gaps.

4 / 5

Total

19

/

20

Passed

Description

87%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: concrete, third-person, and sharply scoped, with an explicit 'Use before...' trigger clause covering all schema-change operations plus two machine-signal triggers. Its only weaknesses are minor — the synonym 'migration' is missing from the trigger terms and capability coverage is slightly narrower than the body delivers.

DimensionReasoningScore

Specificity

"declare and change their schema with defineStore()" plus "adding a table, column, index, backfill or seed to a core store" names several concrete actions in a specific domain. It stays at anchor 4 rather than 5 because coverage has minor gaps (e.g., folding a runMigrations list and releaseOnly stores are body-only capabilities not reflected here).

4 / 5

Completeness

Explicitly answers what ("How framework-owned tables in packages/core declare and change their schema with defineStore()") and when ("Use before adding... before writing an ensure*Table() function, and when guard:release-schema-complete or SchemaNotMigratedError fires") with concrete trigger phrases. Matches the anchor-5 example's structure of a clear what followed by explicit when-clauses.

5 / 5

Trigger Term Quality

Natural terms a developer would say are well covered: "table, column, index, backfill, seed", "ensure*Table()", and the concrete signals "guard:release-schema-complete" and "SchemaNotMigratedError". Not anchor 5 because a common synonym like "migration" (the skill's central concept) is absent from the trigger phrasing.

4 / 5

Distinctiveness Conflict Risk

"framework-owned tables in packages/core" carves a clear niche with distinct triggers; the closely-related app-owned-tables territory is explicitly excluded, leaving minimal conflict risk with sibling skills. Not a lower anchor: it is far more discriminating than the anchor-4 "PDF and Word document files" style of overlap.

5 / 5

Total

18

/

20

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 — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

BuilderIO/agent-native

Path

.agents/skills/framework-stores/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.