CtrlK
BlogDocsLog inGet started
Tessl Logo

golang-documentation

Comprehensive documentation guide for Golang projects, covering godoc comments, README, CONTRIBUTING, CHANGELOG, Go Playground, Example tests, API docs, and llms.txt. Use when writing or reviewing doc comments, documentation, adding code examples, setting up doc sites, or discussing documentation best practices. Triggers for both libraries and applications/CLIs.

92

Quality

92%

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 a strong skill description that clearly defines its scope (Go documentation), lists specific artifacts and actions, and includes explicit trigger guidance. It uses third-person voice appropriately and covers both the 'what' and 'when' dimensions well. The Go-specific terminology provides excellent distinctiveness from other potential documentation skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and artifacts: godoc comments, README, CONTRIBUTING, CHANGELOG, Go Playground, Example tests, API docs, and llms.txt. These are clearly defined documentation types rather than vague references.

3 / 3

Completeness

Clearly answers both 'what' (comprehensive documentation guide covering godoc comments, README, CONTRIBUTING, CHANGELOG, etc.) and 'when' (explicit 'Use when writing or reviewing doc comments, documentation, adding code examples, setting up doc sites, or discussing documentation best practices').

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'doc comments', 'documentation', 'code examples', 'doc sites', 'documentation best practices', 'godoc', 'README', 'CONTRIBUTING', 'CHANGELOG', 'libraries', 'applications/CLIs'. Good coverage of terms a Go developer would naturally use.

3 / 3

Distinctiveness Conflict Risk

Clearly scoped to Golang documentation specifically, with distinct triggers like 'godoc', 'Go Playground', 'Example tests', and 'llms.txt'. The Go-specific terminology makes it unlikely to conflict with general documentation or other language documentation skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a well-structured, comprehensive documentation skill with excellent progressive disclosure and actionability. The 10-step workflow provides clear sequencing, and references to detailed sub-documents keep the main file navigable. Minor verbosity in the persona section and some explanatory text could be trimmed, but overall the skill is effective and well-organized.

DimensionReasoningScore

Conciseness

The skill is fairly well-organized but includes some unnecessary explanation (e.g., 'Good documentation makes code discoverable, understandable, and maintainable' and general truisms about documentation). The persona/modes section adds overhead. The CalculateDiscount example is quite long for illustrating doc comment format. However, most content is substantive and not egregiously padded.

2 / 3

Actionability

The skill provides concrete, executable examples throughout: full doc comment format with Go code, exact badge markdown, specific bash commands for installation, a complete README section order, and references to copy-paste templates. The checklist table and API documentation table give specific tool recommendations.

3 / 3

Workflow Clarity

The 10-step sequential workflow is clearly numbered and logically ordered, starting with project type detection and progressing through increasingly specific documentation layers. The checklist table in Step 2 serves as a validation checkpoint. The parallelization guidance for sub-agents is explicit. While there aren't traditional validate-fix-retry loops, documentation writing doesn't involve destructive operations that would require them.

3 / 3

Progressive Disclosure

Excellent progressive disclosure: the main skill provides a clear overview with well-signaled one-level-deep references to separate files (references/library.md, references/application.md, references/code-comments.md, references/project-docs.md, and asset templates). Each reference is contextually placed at the relevant step. Cross-references to related skills are clearly noted at the top.

3 / 3

Total

11

/

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.