CtrlK
BlogDocsLog inGet started
Tessl Logo

golang-database

Comprehensive guide for Go database access. Covers parameterized queries, struct scanning, NULLable column handling, error patterns, transactions, isolation levels, SELECT FOR UPDATE, connection pool, batch processing, context propagation, and migration tooling. Use this skill whenever writing, reviewing, or debugging Golang code that interacts with PostgreSQL, MariaDB, MySQL, or SQLite. Also triggers for database testing or any question about database/sql, sqlx, pgx, or SQL queries in Golang. This skill explicitly does NOT generate database schemas or migration SQL.

84

Quality

82%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

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 thoroughly covers what the skill does, when to use it, and what it explicitly excludes. It uses natural trigger terms across multiple dimensions (language, databases, libraries) and provides a clear niche that minimizes conflict with other skills. The description is comprehensive without being padded, and uses proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and topics: parameterized queries, struct scanning, NULLable column handling, error patterns, transactions, isolation levels, SELECT FOR UPDATE, connection pool, batch processing, context propagation, and migration tooling. Also explicitly states what it does NOT do.

3 / 3

Completeness

Clearly answers both 'what' (comprehensive list of database access topics) and 'when' ('Use this skill whenever writing, reviewing, or debugging Golang code that interacts with PostgreSQL, MariaDB, MySQL, or SQLite. Also triggers for database testing or any question about database/sql, sqlx, pgx, or SQL queries in Golang'). Includes explicit exclusion boundary as well.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'Go', 'Golang', 'PostgreSQL', 'MariaDB', 'MySQL', 'SQLite', 'database/sql', 'sqlx', 'pgx', 'SQL queries', 'database testing'. These are terms developers would naturally use when seeking help with Go database code.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive: scoped specifically to Go/Golang database access with named libraries (database/sql, sqlx, pgx) and named databases. The explicit exclusion of schema generation and migration SQL further reduces conflict risk with schema-design or migration-focused skills.

3 / 3

Total

12

/

12

Passed

Implementation

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, comprehensive Go database skill with excellent actionability — concrete code examples, clear anti-patterns, and decisive library recommendations. Its main weaknesses are moderate verbosity (repeated points between the summary and detailed sections, some unnecessary explanation) and the lack of explicit validation/feedback loops in multi-step workflows. The progressive disclosure structure is reasonable but cannot be fully verified without bundle files, and some content duplication between sections could be tightened.

Suggestions

Reduce redundancy between the 'Best Practices Summary' numbered list and the detailed sections below — either make the summary truly terse (one-liners without explanation) or remove it and let the sections speak for themselves.

Add explicit validation/feedback loops for transaction workflows (e.g., 'if commit fails with serialization error → retry entire transaction' as a numbered sequence with checkpoints) rather than deferring entirely to references/transactions.md.

Remove the 'Schema Creation' section or merge it into the single bullet point (#14) in the best practices summary — it repeats the same rationale verbatim and adds no new actionable guidance.

DimensionReasoningScore

Conciseness

The skill is mostly efficient with good use of tables and code examples, but includes some unnecessary explanation Claude already knows (e.g., why ORMs are bad is belabored, the 'Schema Creation' section repeats points already made in the best practices summary, and some phrasing like 'Go's database/sql provides a solid foundation' is filler). The best practices summary and the detailed sections below it also have significant overlap.

2 / 3

Actionability

The skill provides fully executable Go code examples for parameterized queries, error handling, row closing, connection pool configuration, and dynamic IN clauses. Code is copy-paste ready with both good and bad patterns clearly marked. The library comparison table is concrete and decisive.

3 / 3

Workflow Clarity

The persona/modes section at the top provides some workflow guidance (write mode vs review/debug mode with sub-agent usage), and the error handling patterns include clear sequences. 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 'always close rows' pattern shows a good sequence but lacks a verification step.

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 includes substantial inline content that could have been further split. The 'Deep Dives' section at the bottom duplicates navigation already provided inline (e.g., transactions referenced twice).

2 / 3

Total

9

/

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.