CtrlK
BlogDocsLog inGet started
Tessl Logo

055-design-parallel-change

Use when a database schema or data-meaning change needs Parallel Change, including expand, migrate, and contract sequencing for column renames, type or data reinterpretation, large-table backfills, relationship-table changes, enum/status transitions, timezone/default changes, and index or uniqueness changes. This should trigger before framework-specific Flyway implementation guidance when deciding whether a migration needs a compatibility window or whether a simpler migration is sufficient. Part of Plinth Toolkit

80

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The body is a well-structured interactive design skill: lean, with concrete decision criteria, a sequenced workflow including verification, and proper one-level progressive disclosure to a real reference file. It earns the top anchor on every dimension.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence—numbered workflow, explicit MUST constraints, and a one-level reference link—without padding or explaining concepts Claude already knows. Not level 2 because there is no unnecessary explanation to tighten.

3 / 3

Actionability

Provides concrete decision criteria ("Recommend Parallel Change when old and new application versions or data interpretations must coexist" vs. "simpler forward-only migration when the change is additive, small, immediately safe") and named routing targets, which qualifies as concrete actionable guidance for an instruction-only skill. Absence of code is not penalized per the rubric's code-vs-instruction note.

3 / 3

Workflow Clarity

A six-step sequenced workflow with explicit verification artifacts in step 4 (row-count expectations, duplicate detection, backfill monitoring, rollback behavior) and risk reporting in step 6, giving feedback/checkpoint loops appropriate for destructive database operations. Not level 2 because validation checkpoints are explicit rather than implicit.

3 / 3

Progressive Disclosure

SKILL.md is an overview that delegates detail to a real, one-level-deep reference (references/055-design-parallel-change.md, confirmed present), signaled in the Constraints, the workflow, and a dedicated Reference section with a markdown link. Organization is clear and navigation is easy.

3 / 3

Total

12

/

12

Passed

Description

100%

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 is a strong, third-person trigger statement that covers what the skill does and when to use it, with concrete scenarios and a clear distinctiveness boundary. It earns the top anchor on every dimension.

DimensionReasoningScore

Specificity

Lists multiple concrete scenarios—"column renames, type or data reinterpretation, large-table backfills, relationship-table changes, enum/status transitions, timezone/default changes, and index or uniqueness changes"—plus the expand/migrate/contract sequencing, matching the comprehensive concrete-actions anchor rather than the partial level-2 anchor.

3 / 3

Completeness

Explicitly answers both what (expand/migrate/contract sequencing across the listed scenarios) and when ("Use when a database schema or data-meaning change needs Parallel Change" and the "should trigger before framework-specific Flyway implementation guidance when deciding whether a migration needs a compatibility window" clause), with explicit triggers present.

3 / 3

Trigger Term Quality

Opens with a natural "Use when" trigger and includes terms users would say ("database schema," "column renames," "compatibility window," "backfills"); while some terms like "data reinterpretation" are specialized, coverage of natural triggers is good. Not level 2 because the breadth of user-facing terms exceeds 'some relevant keywords'.

3 / 3

Distinctiveness Conflict Risk

Carves a clear niche (Parallel Change design for database migrations) with distinct triggers and an explicit hand-off boundary to framework-specific Flyway skills, making it unlikely to trigger for the wrong skill.

3 / 3

Total

12

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/plinth
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.