gopherguides

@gopherguides source repo

42 skills
0 followers
6 hours ago last updated

▌
Go · gopherguides bundle
Idiomatic Go: interfaces, error handling, concurrency, testing, package layout, and debugging. Use when the user writes, reviews, or debugs Go code, or asks any open Go question that doesn't fit a more specific child skill. SKIP for Go performance/profiling work (use go-profiling-optimization) and explicit Gopher Guides training/API requests (use gopher-guides).

0
installs
▌
Htmx · gopherguides bundle
htmx for Go/templ apps: hx-* attributes, swap strategies, triggers, OOB updates, SSE, WebSockets, forms, redirects, debounce, server integration. Trigger when user writes or pastes templates containing hx-* attributes, asks about HTMX swaps/triggers/OOB updates, or wires HTMX to a Go handler. SKIP generic web, fetch/AJAX, or templUI questions with no htmx context.

0
installs
▌
Bench · gopherguides bundle
Generates and runs statistically useful Go benchmarks with allocation and profile analysis. Use for benchmark creation or measured performance comparison; do not use for general correctness tests.

0
installs
▌
Verify · gopherguides bundle
Runs the complete project verification stack and fixes safe failures until blocking checks pass. Use before push or handoff; do not use when only one known test needs diagnosis.

0
installs
▌
Init · gopherguides bundle
Initializes Tailwind CSS v4 in an existing project, including dependencies, CSS entry points, and build integration. Invoke explicitly when setup changes are requested.

0
installs
▌
Explain · gopherguides
Explains targeted Go files, functions, or packages with focused diagrams and idiom analysis. Use when understanding existing Go code; do not use when implementation or refactoring is requested.

0
installs
▌
Profile · gopherguides bundle
Profiles Go CPU and memory behavior, identifies bottlenecks, and verifies measured optimizations. Use for evidence-driven performance work; do not use for benchmark generation alone.

0
installs
▌
Templui · gopherguides bundle
templUI component library for Go templ apps. templUI is vanilla JavaScript only - zero JS frameworks (per templui.io). Covers Script() setup, Go variable interpolation into inline JavaScript, HTML-to-templ conversion, HTMX integration, and optional Alpine.js as a separate app-level state layer. Use when user pastes templUI/templ code, builds templUI components, asks 'how do I add an icon/button/dialog/dropdown' in templ, or interpolates Go state into client-side scripts. SKIP generic htmx issues with no templUI/component context.

0
installs
▌
Audit · gopherguides
Audits Tailwind CSS projects for consistency, performance, accessibility, and v4 compliance. Use for Tailwind health checks and actionable reports; use --fix only when changes are requested.

0
installs
▌
Lint Fix · gopherguides bundle
Finds and fixes Go lint findings while preserving behavior and verifying the result. Use for golangci-lint or formatting failures; do not use for compiler-only failures.

0
installs
▌
Test Gen · gopherguides bundle
Generates idiomatic table-driven Go tests for a selected file, function, or package and verifies them. Use when test coverage is missing; do not use to diagnose an existing test failure.

0
installs
▌
Build Fix · gopherguides bundle
Detects project build systems and fixes compiler or generated-code failures until every detected build is clean. Use for active build errors; do not use for lint-only cleanup.

0
installs
▌
Ship · gopherguides bundle
Ship a PR end-to-end: verify locally, push, create/update the PR, watch CI, handle review feedback, and merge without admin override. Use for 'ship', 'ship it', or 'push and merge'. SKIP if the user only wants a PR opened; use `create-pr`.

0
installs
▌
Gemini · gopherguides bundle
Delegates an explicit analysis, review, or second-opinion request to Google Gemini CLI with a disclosed cloud-data boundary. Use only when the user asks to consult Gemini; do not invoke implicitly or send repository context without explicit confirmation.

0
installs
▌
Ollama · gopherguides bundle
Delegates an explicit analysis, review, or second-opinion request after checking the configured Ollama endpoint and requiring consent for non-loopback destinations. Use only when the user asks for Ollama; do not start a server or download a model without consent.

0
installs
▌
Migrate · gopherguides bundle
Migrates Tailwind CSS v3 projects to v4 CSS-based configuration and verifies the result. Invoke explicitly for migration changes; use --check for a read-only preview.

0
installs
▌
Optimize · gopherguides
Analyzes Tailwind CSS bundle size, source coverage, class usage, and build performance. Use for read-only optimization reports; use --fix only when safe project changes are requested.

0
installs
▌
Go Code Audit · gopherguides
WHEN: User asks for a code quality audit, code review, or wants to find code smells, anti-patterns, or non-idiomatic Go code in their project. Also when asked "how good is this code?" or "audit my code." WHEN NOT: When the user wants to fix bugs, run tests, or just lint (use go-lint-audit for linting).

0
installs
▌
Go Lint Audit · gopherguides
WHEN: User wants to run linting on their Go project, understand lint findings, improve their golangci-lint configuration, or asks "what's wrong with my code?" from a linting perspective. WHEN NOT: Deep code quality audit (use go-code-audit), or auto-fixing lint issues (use /lint-fix command).

0
installs
▌
Commit · gopherguides
Create a git commit with an auto-generated conventional message from staged changes. Use for 'commit', 'save my work', or 'make a commit'. Does not push or open PRs; use `create-pr` for PR-only flow and `ship` for verify+push+merge.

0
installs
▌
Go Code Review · gopherguides
WHEN: User wants an automated first-pass code review on a PR, diff, or set of changes. Also when asked "review this PR", "review my changes", or "what do you think of this code?" WHEN NOT: Full project audits (use go-code-audit), or when user just wants linting (use go-lint-audit).

0
installs
▌
Worktree · gopherguides bundle
Create, remove, or prune git worktrees for issue/PR isolation. Use when the user asks for a worktree, wants an isolated workspace per issue, or wants completed worktrees cleaned up.

0
installs
▌
Go Test Coverage · gopherguides
WHEN: User wants to improve test coverage, find untested code, generate test stubs, or asks "what tests am I missing?" or "how do I improve coverage?" for a Go project. WHEN NOT: When running existing tests, debugging test failures, or benchmarking.

0
installs
▌
Refactor Clean · gopherguides bundle
Finds and safely removes dead Go code, orphaned tests, and avoidable complexity with verification. Use for behavior-preserving cleanup; do not use for product feature changes.

0
installs
▌
Create Pr · gopherguides
Create a pull request using the repo PR template. Use when the user wants to open or submit a PR without immediately merging it. SKIP for end-to-end ship flows; use `ship` instead.

0
installs
▌
Validate Skills · gopherguides
Validates fenced bash, sh, shell, and zsh blocks in plugin Markdown with syntax checks, conservative command classification, guarded execution, and portability review. Use after editing command or skill Markdown or when its shell validation fails.

0
installs
▌
E2e Verify · gopherguides bundle
Run end-to-end PR verification with browser testing. Use before merge or in fix-and-ship mode when the user asks to verify a PR, run E2E, browser-test, or visually check UI changes. SKIP backend-only checks with no browser/UI path; use review-deep or ship as appropriate.

0
installs
▌
Tmux Start · gopherguides bundle
Start issue work in a new tmux window with its own worktree. Use when the user has tmux running and wants issue startup to continue outside the current session. SKIP when not inside a tmux session ($TMUX unset) or when the user wants to work in the current session; use start-issue directly.

0
installs
▌
Gemini Image · gopherguides bundle
Generate images via the Google Gemini API. Supports GA model selection, aspect ratios, resolutions (512/1K/2K/4K), batch generation, image editing. Trigger when user wants AI-generated visual output: image, picture, photo, graphic, illustration, banner, logo, icon, thumbnail, header, hero image. SKIP screenshot inspection or image analysis with no generation/edit request.

0
installs
▌
Go Standards Audit · gopherguides
WHEN: User wants to validate their Go project against Gopher Guides coding standards, check documentation completeness, review concurrency patterns, or validate project structure. WHEN NOT: Quick one-off Go questions (use the gopher-guides skill), or linting (use go-lint-audit).

0
installs
▌
Cancel Loop · gopherguides bundle
Cancel active persistent go-workflow loop state. Use when the user explicitly invokes the qualified cancel-loop skill with an optional loop name.

0
installs
▌
Review Deep · gopherguides bundle
Deep-review a PR or branch with issue and repo context, then fix and commit actionable findings; PR-backed runs push new review commits by default. Use for 'review my changes', 'check this PR', or post-implementation quality/spec review requests. SKIP existing human/bot review comments that need replies/thread resolution; use address-review.

0
installs
▌
Start Issue · gopherguides bundle
Start implementation of a GitHub issue: fetch context, prepare worktree flow, implement with TDD, verify, and submit PR. Use for 'start issue #N', issue URLs, or requests to begin issue work. SKIP fully autonomous issue-to-merge requests; use complete-issue.

0
installs
▌
Create Go Project · gopherguides
Creates a greenfield Go web project with Echo, Templ, HTMX, Tailwind, sqlc, goose, and Air. Use for new project scaffolding and requested application functionality. Skips conversion of existing applications.

0
installs
▌
Second Opinion · gopherguides
Get a second LLM opinion via codex/gemini/ollama on architectural decisions, design trade-offs, library or framework choices, and security-sensitive code. Use when uncertain on a 'should I' call, want a sanity check before a high-stakes commit, or facing a contested code review. SKIP for routine questions where one model's answer is clearly sufficient.

0
installs
▌
Clear Cache · gopherguides
Clears Gopher Guides API response cache data and reports each resolved target. Use when cached training guidance must be refreshed; do not use to clear Codex, Claude, or unrelated application caches.

0
installs
▌
Address Review · gopherguides bundle
Address pull request review feedback from humans or bots. Use when existing comments, requested changes, unresolved review threads, or CodeRabbit/codex review findings need code fixes, verification, push updates, and thread resolution. SKIP fresh code-review requests with no existing feedback; use review-deep.

0
installs
▌
Complete Issue · gopherguides bundle
Take a GitHub issue from implementation to merged PR. Use for 'complete issue #N', 'finish this issue end-to-end', or fully autonomous issue-to-merge requests. SKIP issue startup without merge intent; use start-issue.

0
installs
▌
Gopher Guides · gopherguides
Authoritative Gopher Guides Go training materials accessed via REST API/cache wrapper. Use when reviewing Go code and the user explicitly asks 'what would Gopher Guides recommend?', 'how do professionals do this?', or wants training-material-backed practices/examples/audit. SKIP for general Go idiom questions handled by the `go` skill.

0
installs
▌
Convert To Go Project · gopherguides
Converts existing Express/Fastify, Django/Flask/FastAPI, Laravel/PHP, Next.js/React, and Go projects to Go + Templ + HTMX + Tailwind. Applies to whole-project migrations and existing Go projects that need this stack. Skips greenfield creation and isolated HTMX or templUI help.

0
installs
▌
Go Profiling Optimization · gopherguides bundle
Profile and optimize Go performance: pprof CPU/memory/block/mutex profiles, allocation analysis, escape analysis, sync.Pool, GOGC/GOMEMLIMIT tuning, benchmarks with -benchmem, PGO workflow, execution tracing. Use when user asks 'why is this slow', 'is this allocating', mentions pprof/profiling, runs benchmarks, or needs to reduce p99 latency. SKIP for general Go idioms — use `go` skill.

0
installs
▌
Tailwind Best Practices · gopherguides bundle
Tailwind CSS v4 guidance: utility-first patterns, @theme directive for color/spacing/font config, @source for content paths, dark mode, responsive design, oklch colors, custom variants, v4 vs v3 differences. Use when user writes Tailwind utility classes, configures @theme or @source in CSS, asks about v4 syntax, or styles components.

0
installs

42 published skills