CtrlK
BlogDocsLog inGet started
Tessl Logo

golang-database

Comprehensive guide for Go database access — parameterized queries, struct scanning, NULLable columns, transactions, isolation levels, SELECT FOR UPDATE, connection pool, batch processing, context propagation, and migration tooling. Use when writing, reviewing, or debugging Golang code that interacts with PostgreSQL, MariaDB, MySQL, or SQLite; for database testing; or for questions about database/sql, sqlx, or pgx. Does NOT generate database schemas or migration SQL.

67

Quality

82%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

64%

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

This is a solid, actionable skill with excellent executable code examples and clear best practices for Go database access. Its main weaknesses are moderate verbosity (some repeated points and explanations Claude doesn't need) and a lack of explicit validation/feedback loops for multi-step workflows like transactions and batch operations. The progressive disclosure structure is reasonable but the main file carries more detail than ideal for an overview, and referenced files cannot be verified.

Suggestions

Remove the redundant 'Schema Creation' and 'Avoid Hidden SQL Features' standalone sections since they repeat best practices #14 and #15 verbatim — a single mention in the summary suffices.

Add an explicit validation/retry workflow for transaction handling inline (e.g., serialization failure retry loop) rather than deferring all transaction patterns to references, since transactions are a core concern.

Trim the 'Why NOT ORMs' section to a single line — Claude understands ORM tradeoffs and this explanation is for human persuasion, not AI instruction.

DimensionReasoningScore

Conciseness

The skill is mostly efficient but includes some unnecessary content: the 'Why NOT ORMs' section elaborates on something Claude already understands, the 'Schema Creation' section repeats points already made in the best practices summary, and the 'Avoid Hidden SQL Features' section restates rule #15 verbatim. The library comparison table and best practices list are well-structured but could be tighter.

2 / 3

Actionability

The skill provides fully executable Go code examples for parameterized queries, dynamic IN clauses, column allowlists, error handling with sql.ErrNoRows, rows.Close() patterns, and connection pool configuration. The code is copy-paste ready with both correct and incorrect examples clearly marked.

3 / 3

Workflow Clarity

The persona/modes section at the top provides a useful workflow distinction (write vs review/debug), and the best practices are clearly numbered. However, there are no explicit validation checkpoints or feedback loops for multi-step operations like transaction handling or batch processing — those are deferred to reference files. The error patterns table is helpful but doesn't include retry/recovery workflows inline.

2 / 3

Progressive Disclosure

The skill references four deep-dive files (transactions.md, testing.md, performance.md, scanning.md) and cross-references other skills, which is good structure. However, no bundle files were provided, so we cannot verify these references exist. The main file itself is quite long (~200+ lines) and some content (like the full error handling examples and dynamic query patterns) could arguably be in reference files, while the overview retains too much detail for a top-level skill.

2 / 3

Total

9

/

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.

This is an excellent skill description that hits all the marks. It provides comprehensive specificity with concrete topics, includes abundant natural trigger terms covering language, databases, and libraries, explicitly states both what it does and when to use it, and even includes a helpful exclusion clause to reduce conflict risk. The third-person voice is used correctly throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and topics: parameterized queries, struct scanning, NULLable columns, transactions, isolation levels, SELECT FOR UPDATE, connection pool, batch processing, context propagation, and migration tooling. This is highly specific and comprehensive.

3 / 3

Completeness

Clearly answers both 'what' (comprehensive guide for Go database access with specific topics listed) and 'when' (explicit 'Use when writing, reviewing, or debugging Golang code that interacts with PostgreSQL, MariaDB, MySQL, or SQLite; for database testing; or for questions about database/sql, sqlx, or pgx'). Also includes a helpful exclusion clause ('Does NOT generate database schemas or migration SQL').

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'Go', 'Golang', 'PostgreSQL', 'MariaDB', 'MySQL', 'SQLite', 'database/sql', 'sqlx', 'pgx', 'transactions', 'parameterized queries', 'connection pool'. These are terms developers naturally use when seeking database help in Go.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — scoped specifically to Go language database access with named libraries (database/sql, sqlx, pgx) and named databases. The exclusion clause further sharpens the boundary. Unlikely to conflict with general database schema skills or non-Go programming skills.

3 / 3

Total

12

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Repository
samber/cc-skills-golang
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.