using-sqlite-worktrees

Use when creating a git worktree for a Rails project that uses SQLite - copies the main working tree's development SQLite databases (including Rails 8 Solid Queue/Cache/Cable) into the worktree's storage/ directory with proper WAL checkpointing, so the new worktree has real dev data without re-seeding or re-migrating

Quality

94%

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

Quality

Content

92%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, actionable skill body that delegates execution to a real bundled script and pairs it with explicit prerequisites, validation, a failure contract, and recovery guidance. Minor conciseness gains are available in the example workflow and announce line.

Suggestions

Consider trimming the Example Workflow block, which restates output already described in the Invocation section and could be shortened to the essential transcript beats.

The 'Announce at start' line duplicates the spirit of the Overview; fold it into a single concise instruction if retained.

Dimension	Reasoning	Score
Conciseness	Largely efficient and assumes Claude's competence (no explaining what SQLite/Rails are), but the 'Announce at start' line and the fairly long Example Workflow section add some tokens that could be trimmed without losing clarity.	4 / 5
Actionability	Provides a copy-paste-ready invocation command with the exact bundled script path, explicit prerequisites expressed as runnable shell checks, and documented exit codes; the real work is delegated to an executable bundled script that exists at the referenced path.	5 / 5
Workflow Clarity	Multi-step process is clearly sequenced (prerequisites → checkpoint → backup → copy → summary) with explicit validation checkpoints, a failure contract for non-zero exits, and feedback loops (locked DB → stop server and retry); the destructive overwrite is guarded by backup and validation.	5 / 5
Progressive Disclosure	A single well-organized SKILL.md with one one-level-deep reference to the bundled scripts/create_sqlite_worktree.rb (verified to exist), clear section headers, and no nested references; structure matches the simple-skill exception.	5 / 5
	Total	19 / 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 strong, specific description that clearly states both what the skill does and when to use it, with concrete trigger terms and a distinct niche. The only minor gap is slightly less than comprehensive keyword/synonym coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and multiple concrete actions — 'copies the main working tree's development SQLite databases', 'with proper WAL checkpointing', targeting storage/ — with comprehensive coverage of the Rails 8 multi-DB case.	5 / 5
Completeness	Explicitly answers both 'what' (copies dev SQLite DBs with WAL checkpointing into worktree storage/) and 'when' ('Use when creating a git worktree for a Rails project that uses SQLite') with a concrete trigger clause.	5 / 5
Trigger Term Quality	Includes natural terms users would say ('git worktree', 'Rails project', 'SQLite', 'development SQLite databases') but is missing common synonyms and file extensions; not a level 5 because the spread is slightly less than the comprehensive anchor.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear narrow niche (Rails + SQLite + git worktree with WAL handling) that is unlikely to trigger for any other skill; minimal conflict risk.	5 / 5
	Total	19 / 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: lucianghinda/superpowers-ruby
Path: skills/using-sqlite-worktrees/SKILL.md
Commit: 99fac3d

Reviewed: 7 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.