CtrlK
BlogDocsLog inGet started
Tessl Logo

schema-unify

Migrate a brain from gbrain-base (or any pack) to gbrain-base-v2's 14-canonical-type taxonomy via gbrain onboard --check + the unify-types Minion handler. Collapses 94 noisy types to 15 canonical with subtypes, alias rows, and link rows. Triggers when an agent notices pack_upgrade_available, type_proliferation, or asks "what is the canonical taxonomy / how do I clean up my page types".

70

Quality

86%

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

81%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 excellent operational playbook: every phase has executable commands, expected results, gotchas, and rollback paths, and the destructive batch operation is properly gated by dry-run and verify steps. Its weakness is redundancy — a duplicated Anti-Patterns section and decorative output transcripts that pad the token budget without adding actionable guidance.

Suggestions

Merge the two 'Anti-Patterns' sections (~lines 175-181 and 229-236) into one — they overlap heavily (autopilot, mapping_rules, restore window) and the duplication wastes context tokens.

Move the multi-line Output Format stderr transcript and celebration-summary box to a reference file, keeping only the one or two lines Claude needs to recognize progress (e.g. 'phase=retype-explicit applied=N'), trimming roughly 20 lines from the body.

Tighten the 'Mental model' paragraph to the decision-relevant facts (94 → 15 canonical types, subtypes to frontmatter, redirects to alias rows, unknowns binned to note) and drop the historical narrative about how the proliferation accreted.

DimensionReasoningScore

Conciseness

The body is mostly efficient — non-obvious operational gotchas like 'the job sits queued forever' without --follow on PGLite and 'apply defaults to false' earn their tokens. But it can clearly be tightened: the 'Anti-Patterns' section appears twice (lines ~175 and ~229) with overlapping content, the boxed 'celebration summary' is decorative, and the 'Mental model' paragraph narrates history ('accreted 94 distinct pages.type values over years') beyond what's needed to act. This matches anchor 3 — mostly efficient with some unnecessary content — rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Fully executable throughout: exact commands with JSON params ('gbrain jobs submit unify-types --follow --params "{\"target_pack\":\"gbrain-base-v2\",\"apply\":true}"'), expected outputs for verification, a copy-paste rollback SQL statement, and concrete failure signals ('stays queued here means no worker is running'). Guidance covers the common cases end-to-end.

5 / 5

Workflow Clarity

A five-phase migration with explicit checkpoints befitting a batch/destructive operation: dry-run preview before apply ('don't proceed... file an issue'), a dedicated Verify phase with expected findings ('pack_upgrade_available → ok', '≤16 distinct types'), a full Rollback section with a 72h restore window, and feedback loops ('A job that stays queued here means no worker is running; resubmit with --follow'). The validation cap for batch operations is satisfied — not a 4 because checkpoints, error recovery, and rollback are all explicit.

5 / 5

Progressive Disclosure

No bundle files exist, so this scores on body structure: well-organized sections with clear headers and a final Reference list of one-level-deep external links. Anchor 4 fits — good structure, mostly well-placed content — but the duplicated Anti-Patterns sections, the multi-line Output Format transcript, and the Contract section's detail are candidates for separate reference files in a ~270-line body, which is the 'minor organization gaps' of anchor 4 rather than the clean split of anchor 5.

4 / 5

Total

17

/

20

Passed

Description

92%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 dense, highly specific description that states both what the skill does (taxonomy migration via named gbrain commands) and explicit when-to-fire triggers, in third person. Its only weakness is that some natural user phrasings live in the frontmatter triggers list rather than the description itself.

DimensionReasoningScore

Specificity

Multiple concrete actions are enumerated: 'Migrate a brain from gbrain-base... via gbrain onboard --check + the unify-types Minion handler' and 'Collapses 94 noisy types to 15 canonical with subtypes, alias rows, and link rows'. Coverage is comprehensive — it names the exact tooling, the transformation, and its outputs. Not a 4 because there are no minor gaps in action coverage; every clause describes a specific capability.

5 / 5

Completeness

Explicitly answers both: what — 'Migrate a brain... to gbrain-base-v2's 14-canonical-type taxonomy... Collapses 94 noisy types to 15 canonical'; and when — 'Triggers when an agent notices pack_upgrade_available, type_proliferation, or asks "what is the canonical taxonomy / how do I clean up my page types"'. Both are concrete and explicit, matching the anchor-5 example's structure.

5 / 5

Trigger Term Quality

Good natural-phrase coverage: 'how do I clean up my page types', 'what is the canonical taxonomy', 'migrate', 'unify'. It falls at anchor 4 rather than 5 because common synonyms a user might actually say ('consolidate my types', 'retype pages', 'migrate to v2') appear only in the frontmatter triggers list, not in the description itself, and 'pack_upgrade_available' / 'type_proliferation' are internal jargon findings rather than user-spoken terms.

4 / 5

Distinctiveness Conflict Risk

A clear niche (gbrain pack migration to a named taxonomy) with named tooling and trigger phrases that no other plausible skill would claim. Conflict risk is minimal — nothing generic remains that would fire on an unrelated skill.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
garrytan/gbrain
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.