Skip to content

notque/vexjoy-agent / skills/programming/programming

programming

Flagged

Language-specific patterns and tooling: Go, Kotlin, PHP, Swift, TypeScript.

FileKindSize
SKILL.mdskill md11.6 KB
references/go/code-review.mdmarkdown12.0 KB
references/go/code-review/common-review-comments.mdmarkdown6.6 KB
references/go/concurrency.mdmarkdown11.5 KB
references/go/concurrency/concurrency-patterns.mdmarkdown5.7 KB
references/go/error-handling.mdmarkdown10.8 KB
references/go/error-handling/patterns.mdmarkdown4.2 KB
references/go/google-style-guide/SHA256SUMSother313 B
references/go/google-style-guide/UPSTREAM_REVISIONother41 B
references/go/google-style-guide/best-practices/part-01.mdmarkdown10.0 KB
references/go/google-style-guide/best-practices/part-02.mdmarkdown15.0 KB
references/go/google-style-guide/best-practices/part-03.mdmarkdown14.1 KB
references/go/google-style-guide/best-practices/part-04.mdmarkdown13.5 KB
references/go/google-style-guide/best-practices/part-05.mdmarkdown10.5 KB
references/go/google-style-guide/best-practices/part-06.mdmarkdown14.4 KB
references/go/google-style-guide/best-practices/part-07.mdmarkdown16.1 KB
references/go/google-style-guide/best-practices/part-08.mdmarkdown11.4 KB
references/go/google-style-guide/best-practices/part-09.mdmarkdown13.7 KB
references/go/google-style-guide/best-practices/part-10.mdmarkdown16.9 KB
references/go/google-style-guide/decisions/part-01.mdmarkdown15.0 KB
references/go/google-style-guide/decisions/part-02.mdmarkdown12.5 KB
references/go/google-style-guide/decisions/part-03.mdmarkdown11.5 KB
references/go/google-style-guide/decisions/part-04.mdmarkdown8.4 KB
references/go/google-style-guide/decisions/part-05.mdmarkdown9.8 KB
references/go/google-style-guide/decisions/part-06.mdmarkdown14.7 KB
references/go/google-style-guide/decisions/part-07.mdmarkdown13.3 KB
references/go/google-style-guide/decisions/part-08.mdmarkdown14.3 KB
references/go/google-style-guide/decisions/part-09.mdmarkdown15.3 KB
references/go/google-style-guide/decisions/part-10.mdmarkdown8.3 KB
references/go/google-style-guide/guide/part-01.mdmarkdown16.3 KB
references/go/google-style-guide/guide/part-02.mdmarkdown3.0 KB
references/go/google-style-guide/index.mdmarkdown8.4 KB
references/go/preferred-patterns.mdmarkdown12.5 KB
references/go/preferred-patterns/code-examples.mdmarkdown11.6 KB
references/go/quality-gate.mdmarkdown7.3 KB
references/go/quality-gate/common-lint-errors.jsonconfig7.6 KB
references/go/quality-gate/examples.mdmarkdown11.0 KB
references/go/quality-gate/makefile-targets.jsonconfig5.1 KB
references/go/sapcc-conventions.mdmarkdown34.6 KB
references/go/sapcc-conventions/api-design-detailed.mdmarkdown22.7 KB
references/go/sapcc-conventions/architecture-patterns.mdmarkdown18.6 KB
references/go/sapcc-conventions/build-ci-detailed.mdmarkdown18.7 KB
references/go/sapcc-conventions/error-handling-detailed.mdmarkdown20.1 KB
references/go/sapcc-conventions/extended-patterns.mdmarkdown7.1 KB
references/go/sapcc-conventions/go-bits-philosophy-detailed.mdmarkdown24.5 KB
references/go/sapcc-conventions/library-reference.mdmarkdown14.0 KB
references/go/sapcc-conventions/pr-mining-insights.mdmarkdown17.5 KB
references/go/sapcc-conventions/review-standards.mdmarkdown10.5 KB
references/go/sapcc-conventions/sapcc-code-patterns.mdmarkdown46.2 KB
references/go/testing.mdmarkdown9.7 KB
references/go/testing/go-benchmark-and-concurrency.mdmarkdown5.6 KB
references/go/testing/go-test-patterns.mdmarkdown9.0 KB
references/kotlin/concurrency-patterns.mdmarkdown5.4 KB
references/kotlin/kotlin-testing.mdmarkdown7.9 KB
references/php/modern-php-features.mdmarkdown4.4 KB
references/php/testing-patterns.mdmarkdown7.5 KB
references/swift/preferred-patterns.mdmarkdown2.4 KB
references/swift/swift-testing.mdmarkdown6.6 KB
references/swift/task-patterns.mdmarkdown3.6 KB
scripts/bench-compare.shscript7.1 KB
scripts/check-errors.shscript7.1 KB
scripts/check-interface-compliance.shscript6.4 KB
scripts/check-sapcc-auth-ordering.shscript5.5 KB
scripts/check-sapcc-httptest.shscript4.4 KB
scripts/check-sapcc-identify-endpoint.shscript5.8 KB
scripts/check-sapcc-json-strict.shscript4.9 KB
scripts/check-sapcc-time-now.shscript4.2 KB
scripts/check-sapcc-todo-format.shscript4.1 KB
scripts/gen-table-test.shscript4.2 KB
scripts/quality_checker.pyscript16.2 KB
scripts/sync-google-style-guide.pyscript2.5 KB
scripts/validate.pyscript6.3 KB

references/go/quality-gate/common-lint-errors.json

View on GitHub
{
  "errcheck": {
    "description": "Unchecked error returns - detects when error values are not checked",
    "fix": "Check error return values or explicitly ignore with _ = err. Common pattern: if err != nil { return err }",
    "severity": "high",
    "example": "resp, err := http.Get(url)\n// Must check: if err != nil { return err }"
  },
  "gosec": {
    "description": "Security vulnerabilities - identifies potential security issues",
    "fix": "Review security issue and apply recommended fix. Common issues: weak crypto, command injection, SQL injection",
    "severity": "critical",
    "reference": "https://github.com/securego/gosec"
  },
  "govet": {
    "description": "Suspicious constructs - reports constructs that look like bugs",
    "fix": "Review code logic and fix reported issue. Common issues: printf format mismatches, unreachable code, suspicious comparisons",
    "severity": "high",
    "reference": "https://pkg.go.dev/cmd/vet"
  },
  "staticcheck": {
    "description": "Static analysis issues - advanced code analysis for bugs and performance",
    "fix": "Follow staticcheck recommendations for code improvements. Usually indicates real bugs or inefficiencies",
    "severity": "medium",
    "reference": "https://staticcheck.io/"
  },
  "ineffassign": {
    "description": "Ineffectual assignments - detects assignments to existing variables that are never used",
    "fix": "Remove the ineffectual assignment or use the variable. Often indicates dead code",
    "severity": "low",
    "example": "x := 5\nx = 10  // If x is never used after this, it's ineffectual"
  },
  "unused": {
    "description": "Unused code - detects unused constants, variables, functions, and types",
    "fix": "Remove unused code or use it. Helps keep codebase clean",
    "severity": "low"
  },
  "gocritic": {
    "description": "Opinionated code quality checks - suggests improvements and simplifications",
    "fix": "Review suggestion and apply if it improves code quality. Often suggests simpler or more idiomatic Go",
    "severity": "medium",
    "reference": "https://go-critic.github.io/overview"
  },
  "bodyclose": {
    "description": "HTTP response body not closed - detects HTTP response bodies that are not properly closed",
    "fix": "Add defer resp.Body.Close() after checking error from HTTP request",
    "severity": "high",
    "example": "resp, err := http.Get(url)\nif err != nil { return err }\ndefer resp.Body.Close()"
  },
  "errorlint": {
    "description": "Error wrapping issues - detects incorrect error wrapping patterns",
    "fix": "Use fmt.Errorf with %w for wrapping errors, %v for non-wrapping. Use errors.Is/As for checking wrapped errors",
    "severity": "medium",
    "example": "return fmt.Errorf(\"failed to process: %w\", err)"
  },
  "forbidigo": {
    "description": "Forbidden function/pattern usage - detects use of forbidden functions",
    "fix": "Replace forbidden function with approved alternative. Common: fmt.Println → logger, panic → error return",
    "severity": "medium"
  },
  "goconst": {
    "description": "Repeated string/numeric constants - suggests defining constants for repeated values",
    "fix": "Define a constant for repeated values to improve maintainability",
    "severity": "low",
    "example": "const defaultTimeout = 30 * time.Second"
  },
  "misspell": {
    "description": "Misspelled words in code - detects common spelling mistakes",
    "fix": "Correct the spelling mistake",
    "severity": "low"
  },
  "whitespace": {
    "description": "Unnecessary whitespace - detects unnecessary blank lines",
    "fix": "Remove extra blank lines. Usually at start/end of blocks",
    "severity": "low"
  },
  "goimports": {
    "description": "Import formatting issues - detects improperly formatted or missing imports",
    "fix": "Run: make goimports (or goimports -w .)",
    "severity": "low"
  },
  "gci": {
    "description": "Import ordering issues - detects imports not in standard order",
    "fix": "Run: make goimports to fix import ordering (stdlib, external, local)",
    "severity": "low"
  },
  "revive": {
    "description": "Linting issues - general purpose linter with many rules",
    "fix": "Review specific revive rule and apply suggested fix",
    "severity": "medium",
    "reference": "https://revive.run/"
  },
  "typecheck": {
    "description": "Type checking errors - detects type errors that prevent compilation",
    "fix": "Fix type errors - usually indicates incorrect type usage or missing imports",
    "severity": "critical"
  },
  "nilnil": {
    "description": "Returning nil, nil - detects functions returning both nil values",
    "fix": "Return meaningful error instead of nil, nil. Pattern: return nil, fmt.Errorf(\"not found\")",
    "severity": "medium"
  },
  "nilerr": {
    "description": "Returning nil error with non-nil value - detects suspicious error returns",
    "fix": "Ensure error is non-nil when returning error condition",
    "severity": "high"
  },
  "gofmt": {
    "description": "Code formatting issues - detects code not formatted with gofmt",
    "fix": "Run: gofmt -w . or make goimports",
    "severity": "low"
  },
  "gofumpt": {
    "description": "Stricter gofmt - enforces more strict formatting rules",
    "fix": "Run: gofumpt -w . or make goimports if gofumpt is configured",
    "severity": "low"
  },
  "unconvert": {
    "description": "Unnecessary type conversions - detects redundant type conversions",
    "fix": "Remove unnecessary type conversion",
    "severity": "low",
    "example": "int(x) where x is already int"
  },
  "unparam": {
    "description": "Unused function parameters - detects parameters that are never used",
    "fix": "Remove unused parameter or use _ if required by interface",
    "severity": "low"
  },
  "gosimple": {
    "description": "Code simplification suggestions - suggests simpler code alternatives",
    "fix": "Apply suggested simplification to improve code readability",
    "severity": "low",
    "reference": "https://staticcheck.io/docs/checks#S"
  },
  "durationcheck": {
    "description": "Duration multiplication issues - detects incorrect duration multiplications",
    "fix": "Use time.Duration constants correctly: time.Second, time.Millisecond, etc.",
    "severity": "high",
    "example": "time.Sleep(5 * time.Second) not time.Sleep(5)"
  },
  "exhaustive": {
    "description": "Exhaustive switch/map - ensures all enum values are handled",
    "fix": "Add missing cases to switch statement or add default case",
    "severity": "medium"
  },
  "exportloopref": {
    "description": "Loop variable captured by reference - detects loop variable reference bugs",
    "fix": "Create local copy of loop variable before using in closure/goroutine",
    "severity": "high",
    "example": "for _, item := range items {\n  item := item // Create copy\n  go process(item)\n}"
  },
  "noctx": {
    "description": "Missing context.Context - detects HTTP requests without context",
    "fix": "Use context-aware HTTP methods: req.WithContext(ctx)",
    "severity": "medium"
  },
  "rowserrcheck": {
    "description": "SQL rows.Err() not checked - detects unchecked SQL iteration errors",
    "fix": "Check rows.Err() after rows.Next() loop",
    "severity": "high",
    "example": "for rows.Next() { ... }\nif err := rows.Err(); err != nil { return err }"
  },
  "sqlclosecheck": {
    "description": "SQL rows/stmt not closed - detects unclosed database resources",
    "fix": "Add defer rows.Close() or defer stmt.Close()",
    "severity": "high"
  },
  "wastedassign": {
    "description": "Wasted assignment - detects assignments that are overwritten before use",
    "fix": "Remove the wasted assignment or fix the logic",
    "severity": "low"
  }
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 321kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 321kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 321kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 321kUpdated Claude CodeCodexVerifiedInstall