CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

go-chi-project-starter

Scaffold and develop production-ready REST APIs using the Chi v5 router with clean architecture, structured logging (slog), SQLX, and idiomatic Go patterns.

Quality

68%

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 ./backend-go/go-chi-project-starter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 content is highly actionable, providing a nearly complete, executable reference implementation with a clear setup workflow. Its weaknesses are token weight from inlining an entire multi-file project (no progressive disclosure) and minor coverage gaps in the service, config, and auth layers.

Suggestions

Move the full code templates (handler, repository, middleware, migration files) into references/ files and keep SKILL.md as a concise overview with pointers, adding progressive disclosure for a skill this size.

Show one exemplar CRUD handler in full and summarize the rest as a pattern ('same shape: parse id, call service, map ErrNotFound/ErrDuplicateEmail to status codes'), cutting significant token overhead.

Add the missing service layer, config loader, and auth handler examples (or reference files) so every file in the project structure has corresponding executable guidance, and include brief error-recovery notes for failed migrations or startup errors.

DimensionReasoningScore

Conciseness

The body is dominated by dense, executable code with little concept-explanation padding, but the five CRUD handlers repeat near-identical error-handling boilerplate, and a full reference implementation is inlined where 1-2 exemplar handlers plus a pattern note would suffice. This matches 'mostly efficient but could be tightened' rather than 'minor instances of over-explanation'.

3 / 5

Actionability

Scaffold commands, router setup, handlers, repository, middleware, migrations, and a 'First Steps After Scaffold' sequence are copy-paste ready, covering the common cases. It is not 5 because internal/service/user.go, internal/config/config.go, and internal/handler/auth.go appear in the project structure without any code shown — a concrete gap in an otherwise executable skill.

4 / 5

Workflow Clarity

The scaffold → configure → migrate → run → test sequence is clearly laid out with explicit commands and a verification checkpoint (curl /healthz). It falls short of 5 because there is no error-recovery guidance (e.g., what to do when migrations fail or the server won't start).

4 / 5

Progressive Disclosure

Sections are well organized and navigable (Prerequisites, Scaffold, Structure, Patterns, First Steps, Commands, Integration Notes), but a ~760-line full project implementation is inlined entirely in SKILL.md with zero reference files — content that should be separate is inline. It is not 2 because the structure is genuinely good, and not 4 because a skill of this size should split code templates into references/ files.

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 specific and stack-focused, clearly conveying what the skill does with concrete technology names. Its main weakness is the complete absence of any 'when to use' trigger guidance, which both caps completeness and slightly weakens trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g., 'Use when starting a new Go API/service project, scaffolding a chi-based REST API, or when the user mentions chi, slog, SQLX, or Go backend development.'

Broaden trigger coverage with natural synonyms users would say — 'golang', 'backend service', 'API server' — to lift trigger_term_quality from good to comprehensive.

Enumerate a couple more concrete capabilities (e.g., JWT auth middleware, database migrations, Swagger docs) so specificity reflects the skill's actual scope.

DimensionReasoningScore

Specificity

The description names the domain ('production-ready REST APIs') and two concrete actions ('Scaffold and develop') with a specific stack (Chi v5, slog, SQLX), but stops at setup — it omits auth, migrations, and testing that the body delivers, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not 4 because it does not list several distinct specific actions.

3 / 5

Completeness

The 'what' is clear (scaffold and develop production REST APIs with a named stack), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 2 because the 'what' is specific and concrete rather than vague.

3 / 5

Trigger Term Quality

'Chi v5 router', 'REST APIs', 'slog', 'SQLX', and 'Go' are natural terms users would say when needing this skill, giving good keyword coverage. It falls short of 5 because common variations like 'golang', 'backend service', or 'API server' are missing.

4 / 5

Distinctiveness Conflict Risk

The named stack (Chi v5 router, slog, SQLX) carves a distinct niche with minimal conflict risk. It is not 5 because 'production-ready REST APIs' and 'idiomatic Go patterns' could overlap with other Go backend starter skills (e.g., Gin or Echo equivalents).

4 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (763 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

achreftlili/deep-dev-skills

Path

backend-go/go-chi-project-starter/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.