skills.rest
MolcajeteAI
MolcajeteAIOFFICIAL
Explore all skills by this author →
GitHub

documentation-standards

Enforce godoc conventions for Go package, function, and type documentation.

2|1|Updated Nov 13, 2025
Search Tags:#best practices#documentation#go#code standards#godoc
One-click install
npx skills add https://github.com/MolcajeteAI/plugin --skill documentation-standards-molcajeteai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: documentation-standards
Source: https://github.com/MolcajeteAI/plugin/tree/main/deprecated/tech-stacks/go/skills/documentation-standards
Command: npx skills add https://github.com/MolcajeteAI/plugin --skill documentation-standards-molcajeteai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers adhere to Go's standard documentation conventions (godoc) and best practices, ensuring code is well-documented and maintainable.

Core Features & Use Cases

  • GoDoc Compliance: Provides examples and rules for documenting packages, functions, and types according to godoc standards.
  • README Structure: Offers a template for effective project README files.
  • Best Practices: Outlines key principles for clear, concise, and up-to-date code documentation.
  • Use Case: When writing a new Go function, consult this Skill to ensure your function's comment clearly explains its purpose, parameters, return values, and potential errors in the standard godoc format.

Quick Start

Follow the provided godoc conventions for documenting your Go functions.

Frequently Asked Questions about documentation-standards

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write Go documentation that follows godoc conventions?▼

To write Go documentation following godoc conventions, you must comment your packages, functions, and types using clear, concise sentences directly preceding the code block to ensure maintainability.

What should be included in a Go function comment according to Go code standards?▼

Go code standards require function comments to explain the purpose, parameters, return values, and potential errors in a standard godoc format for effective code communication.

What is the standard structure for a Go project README?▼

A standard Go project README structure provides a template for effective project documentation, ensuring your repository clearly communicates setup and usage alongside godoc compliant code.

Do I need to use a specific tool to enforce Go documentation standards?▼

You do not need a specific external tool to enforce Go documentation standards; you apply godoc conventions directly to your package, function, and type documentation for maintainability.

When do I need to apply Go documentation best practices?▼

You need to apply Go documentation best practices when writing new Go packages, functions, or types to ensure your code communication remains clear, concise, and up-to-date according to godoc standards.

Related Skills

Explore More Software Engineering Skills→
LuigiAPCPereiraLuigiAPCPereira

golang-documentation

Generate and review Go project documentation, including godoc comments, READMEs, and CHANGELOGs.

Community
Advanced
xiaolaixiaolai
6

lang-go

Detect exported identifiers in Go code and enforce godoc-compliant comments for public APIs.

Community
Intermediate
sambersamber
2.9k

golang-lint

Configure and run golangci-lint to analyze Go projects and interpret results.

Community
Advanced
kcenonkcenon
2

documentation

Enforce documentation standards for READMEs, API docs, and code comments.

Community
Basic