CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

66

Quality

83%

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

78%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, instruction-only design skill: an efficient overview body, concrete MUST constraints, a clearly sequenced six-step workflow with embedded verification, and exemplary one-level-deep progressive disclosure to a real, well-organized reference file. Remaining weaknesses are minor — duplicated description content in the body and the absence of an explicit feedback loop in the workflow.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it never explains what Parallel Change or Flyway is — but the 'What is covered in this Skill?' list and the 'When to use this skill' phrase list substantially duplicate the frontmatter description, which could be trimmed. Fits 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place 5.

4 / 5

Actionability

Concrete, specific guidance throughout: MUST constraints and a workflow naming exact verification artifacts ('previous-release fixture checks, row-count expectations, duplicate detection, backfill monitoring, rollback behavior') and exact routing targets. Not a 5 because some steps remain at the design-instruction level ('identify the schema shape... data meaning... rollout window') without worked examples inline, though the reference file carries those.

4 / 5

Workflow Clarity

Six clearly sequenced steps with verification embedded in steps 4 and 6 ('verification evidence, cleanup trigger, tradeoffs, skipped checks, and remaining risks'). Not a 5 because there is no explicit validate-then-fix-then-retry feedback loop despite database operations being a context where the rubric calls for them; not a 3 because validation and verification checkpoints are explicitly present in the workflow.

4 / 5

Progressive Disclosure

The body is a concise overview with a single, clearly signaled, one-level-deep reference: a MUST constraint ('read references/055-design-parallel-change.md before applying Parallel Change guidance'), a dedicated Reference section with a link, and the referenced file exists and is well-organized (constraints, steps, five worked examples, output format, safeguards). This matches the clear-overview anchor exactly.

5 / 5

Total

17

/

20

Passed

Description

80%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, trigger-rich description with comprehensive concrete scenario coverage, an explicit 'Use when' clause, and deliberate boundary-setting against adjacent Flyway skills. Its only gaps are a few missing natural synonyms (e.g., 'zero-downtime') and a 'what' that is stated only implicitly through the trigger enumeration.

DimensionReasoningScore

Specificity

The description lists concrete capabilities and comprehensive scenario coverage: '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' — seven specific scenarios plus the sequencing action, matching the comprehensive-coverage anchor.

5 / 5

Completeness

Both are present: 'when' is explicit via 'Use when a database schema or data-meaning change needs Parallel Change' and 'what' is embedded in the enumerated change types and expand/migrate/contract sequencing. Not a 5 because the 'what' is stated only inside the trigger enumeration rather than as an explicit capability statement, and not a 3 because the when-clause is explicit and specific.

4 / 5

Trigger Term Quality

Good natural keyword coverage ('column rename', 'backfill', 'schema change', 'compatibility window', 'Flyway') but missing common variations users would say such as 'zero-downtime migration', 'online schema change', or file extensions like '.sql'. Fits the 'good coverage, a few natural terms missing' anchor rather than the 5, and is clearly above the 3 with its multiple relevant natural phrases.

4 / 5

Distinctiveness Conflict Risk

The explicit boundary 'This should trigger before framework-specific Flyway implementation guidance' distinguishes it from sibling Flyway skills and the enumerated scenario list gives it a clear niche. Minor overlap risk remains with the Spring/Quarkus/Micronaut migration skills it deliberately routes to, so it sits at 'mostly distinct' rather than the 5 anchor.

4 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jabrena/plinth

Path

skills/055-design-parallel-change/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.