CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bun-sqlite

Use for bun:sqlite, SQLite operations, prepared statements, transactions, and queries.

55

Quality

69%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/bun/skills/bun-sqlite/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a strong, fully executable API reference with excellent code examples and no concept padding. It loses points on duplication between query-method sections, inlined reference-grade content, dangling references to nonexistent files, and the absence of validation/retry loops for transaction and batch operations.

Suggestions

Create the referenced files references/pragmas.md and references/fts.md (or remove the 'When to Load References' section) — the references directory does not exist, so both links are broken.

Consolidate 'Running Queries', 'Query Methods', and 'Parameters' into a single section, and move reference-grade material (column types, serialize/deserialize, repository pattern) into separate reference files to cut duplication and token cost.

Add a validation/feedback step after transaction and batch operations, e.g. verify result.changes equals the expected count and retry on SQLITE_BUSY, matching the fix the skill's own error table recommends.

DimensionReasoningScore

Conciseness

Code-heavy with almost no concept padding, but noticeably redundant: .get()/.all()/.values()/.iterate() appear in both 'Running Queries' and 'Query Methods', there are two overlapping transaction examples, and bulk API-reference material (column types, serialize/deserialize) is inlined. Anchor 3 ('mostly efficient but could be tightened'); not 4, which expects only minor trimmable instances.

3 / 5

Actionability

Every section contains fully executable, copy-paste-ready TypeScript covering the common cases: open/close, DDL, positional and named parameters, transactions, error handling, and a repository pattern. Matches anchor 5 (fully executable, specific examples covering common cases).

5 / 5

Workflow Clarity

The rubric's scoring notes cap workflow clarity at 3 for database and batch operations lacking validation/verification steps. Transactions and bulk inserts are shown with no verification (e.g. checking result.changes) and no retry loop despite the error table itself recommending 'add retry logic' for SQLITE_BUSY. The error-handling try/catch is a partial checkpoint, so above 3 is not justified.

3 / 5

Progressive Disclosure

Section structure is good and references are clearly signaled in 'When to Load References', but references/pragmas.md and references/fts.md do not exist (no references/ directory is present in the bundle), and roughly 150 lines of API-reference material that belongs in separate files is inlined. Anchor 3 ('references present but not clearly signaled; content that should be separate is inline'); not 2 because references are clearly signaled rather than buried, not 4 because the referenced files are missing.

3 / 5

Total

14

/

20

Passed

Description

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

The description is concise, on-niche, and uses natural trigger terms centered on the distinctive 'bun:sqlite' module name. Its main weakness is structure: it is only a 'Use for' trigger clause with a topic list, never stating what the skill actually does, which leaves both completeness and specificity mid-range.

Suggestions

Split the single sentence into a what-clause plus an explicit trigger, e.g. 'Run queries, manage transactions, and use prepared statements with bun:sqlite. Use when working with SQLite in Bun projects, .sqlite database files, or bun:sqlite imports.'

Add missing natural trigger variations such as 'database', '.sqlite', and 'bun database' to broaden keyword coverage.

Lead with concrete actions (verbs) rather than noun-topics, so the description communicates capabilities, not just subject areas.

DimensionReasoningScore

Specificity

Names the domain ('bun:sqlite') plus specific topics ('prepared statements', 'transactions', 'queries'), but these are noun-topics rather than concrete actions — no verbs like 'run', 'create', or 'manage'. Matches anchor 3 (domain plus limited concrete actions); not 4 because anchor 4 expects several listed actions with only minor gaps.

3 / 5

Completeness

The 'when' is explicit ('Use for...'), but the 'what' is only weakly implied by the topic list — there is no statement of what the skill does. Better than anchor 2's vague 'Use when working with documents' because the topic list conveys real coverage, but not anchor 4 since 'what' and 'when' are not both explicit.

3 / 5

Trigger Term Quality

'bun:sqlite', 'SQLite', 'prepared statements', 'transactions', and 'queries' are terms users would naturally say. Not 5 because common variations are missing ('database', '.sqlite', 'bun database'), which anchor 5 requires alongside synonyms and file extensions.

4 / 5

Distinctiveness Conflict Risk

'bun:sqlite' is a clear, distinct module name, but generic terms ('SQLite operations', 'transactions', 'queries') could also match skills for other SQLite libraries (better-sqlite3, node:sqlite). Minor overlap risk with closely related skills — anchor 4 rather than 5.

4 / 5

Total

14

/

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

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

secondsky/claude-skills

Path

plugins/bun/skills/bun-sqlite/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.