Skip to content

notque/vexjoy-agent / skills/programming/programming

programming

Flagged

Language rules, workflows, and tooling: Go, Python, Rust, Kotlin, Swift, PHP, TypeScript type checks and debugging, OpenStack Python, MCP local-docs servers, Node.js backend APIs.

FileKindSize
SKILL.mdskill md19.3 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/golang-general.mdmarkdown8.9 KB
references/golang-general/go-modern-code.mdmarkdown17.2 KB
references/golang-general/go-verification-workflow.mdmarkdown5.0 KB
references/golang-general/go-version-idioms.mdmarkdown6.8 KB
references/kotlin-general.mdmarkdown7.5 KB
references/kotlin-general/kotlin-patterns.mdmarkdown7.9 KB
references/kotlin-general/kotlin-security-testing.mdmarkdown4.4 KB
references/kotlin-general/kotlin-security.mdmarkdown11.1 KB
references/kotlin/concurrency-patterns.mdmarkdown5.4 KB
references/kotlin/kotlin-testing.mdmarkdown7.9 KB
references/mcp-local-docs.mdmarkdown6.9 KB
references/mcp-local-docs/mcp-patterns.mdmarkdown9.6 KB
references/mcp-local-docs/mcp-preferred-patterns.mdmarkdown6.9 KB
references/mcp-local-docs/server-templates.mdmarkdown4.4 KB
references/mcp-local-docs/typescript-async-patterns.mdmarkdown8.9 KB
references/nodejs-api.mdmarkdown7.3 KB
references/nodejs-api/auth-patterns.mdmarkdown10.0 KB
references/nodejs-api/middleware-patterns.mdmarkdown10.5 KB
references/nodejs-api/nodejs-security.mdmarkdown12.3 KB
references/nodejs-api/webhook-patterns.mdmarkdown9.9 KB
references/php-general.mdmarkdown4.7 KB
references/php-general/php-behaviors.mdmarkdown5.2 KB
references/php-general/php-conventions.mdmarkdown5.8 KB
references/php/modern-php-features.mdmarkdown4.4 KB
references/php/testing-patterns.mdmarkdown7.5 KB
references/python-general.mdmarkdown7.7 KB
references/python-general/flask-jinja-webapp.mdmarkdown5.7 KB
references/python-general/python-local-gates.mdmarkdown4.4 KB
references/python-general/python-modern-code.mdmarkdown23.1 KB
references/python-openstack.mdmarkdown5.2 KB
references/python-openstack/error-handling.mdmarkdown658 B
references/python-openstack/hacking-rules.mdmarkdown4.1 KB
references/python-openstack/openstack-patterns.mdmarkdown1.2 KB
references/python-openstack/oslo-patterns.mdmarkdown6.4 KB
references/python-openstack/output-format.mdmarkdown2.4 KB
references/python-openstack/preferred-patterns.mdmarkdown1.9 KB
references/python-openstack/rpc-versioning.mdmarkdown5.3 KB
references/rust-general.mdmarkdown8.2 KB
references/rust-general/rust-modern-code.mdmarkdown13.4 KB
references/rust-general/rust-verification-workflow.mdmarkdown5.5 KB
references/rust-general/rust-version-idioms.mdmarkdown7.0 KB
references/swift-general.mdmarkdown5.7 KB
references/swift-general/swift-patterns.mdmarkdown6.7 KB
references/swift-general/swift-security-testing.mdmarkdown6.6 KB
references/swift-general/swift-security.mdmarkdown13.3 KB
references/swift/preferred-patterns.mdmarkdown2.4 KB
references/swift/swift-testing.mdmarkdown6.6 KB
references/swift/task-patterns.mdmarkdown3.6 KB
references/typescript-debugging.mdmarkdown9.3 KB
references/typescript-debugging/debugging-workflows-async-memory.mdmarkdown5.8 KB
references/typescript-debugging/debugging-workflows.mdmarkdown5.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/swift-general/swift-patterns.md

View on GitHub
# Swift Patterns

## Immutability

### `let` vs. `var` Rules

| Rule | Rationale |
|------|-----------|
| Always declare as `let` first | If the compiler accepts it, it is immutable — keep it |
| Change to `var` only when compiler requires it | The compiler is the source of truth, not habit |
| Never pre-emptively declare `var` in case it changes | That change may never come; premature mutability creates data-race surface area |
| Use `mutating func` in structs for controlled mutation | Keeps value semantics; each mutation is explicit at call sites |

```swift
// Wrong — var when let suffices
var name = "Alice"
print(name)  // never reassigned

// Correct
let name = "Alice"
print(name)
```

### `struct` vs. `class` Decision Matrix

| Use `struct` when... | Use `class` when... |
|----------------------|---------------------|
| Data is copied between contexts (DTO, model, config) | Identity matters — two references must point to the same object |
| Thread-safety via value semantics is desired | Objective-C interoperability requires `NSObject` subclassing |
| No subclassing is needed | Reference sharing is an intentional design decision (e.g., shared cache) |
| All stored properties are value types or `Sendable` | Lifecycle management via `deinit` is required |
| SwiftUI view models that do not need `ObservableObject` | `ObservableObject` / `@Published` Combine integration |

```swift
// Prefer struct for DTOs
struct UserProfile: Sendable {
    let id: UUID
    let displayName: String
    let email: String
}

// class only when identity semantics are needed
final class ImageCache {
    static let shared = ImageCache()  // single shared instance
    private var storage: [URL: UIImage] = [:]
    private init() {}
}
```

---

## Concurrency

### Core Principles

Swift 6 strict concurrency treats data races as compile-time errors. Every type crossing actor isolation boundaries must be `Sendable`.

### Actor Isolation

```swift
// Use actors for shared mutable state — not DispatchQueue or locks
actor DownloadManager {
    private var activeTasks: [URL: Task<Data, Error>] = [:]

    func fetch(_ url: URL) async throws -> Data {
        if let existing = activeTasks[url] {
            return try await existing.value
        }
        let task = Task { try await URLSession.shared.data(from: url).0 }
        activeTasks[url] = task
        defer { activeTasks.removeValue(forKey: url) }
        return try await task.value
    }
}
```

### Sendable Requirements

- Value types (`struct`, `enum`) that contain only `Sendable` properties are automatically `Sendable`
- Add `@unchecked Sendable` only with documented proof of manual thread-safety; it is a last resort
- Pass `Sendable` closures across actor boundaries; non-`Sendable` closures must stay on the originating actor

### Structured vs. Unstructured Concurrency

| Pattern | Use When |
|---------|----------|
| `async let` | Fixed number of independent operations with known result types |
| `TaskGroup` / `withThrowingTaskGroup` | Dynamic number of concurrent operations |
| `Task {}` | Background work not in an async context (UI event handlers, Combine sinks) |
| Prefer `async let` / `TaskGroup` over naked `Task {}` when applicable | Unstructured tasks escape scope, making cancellation and error propagation harder |

```swift
// Prefer async let for fixed parallel fetches
async let profile = fetchProfile(userID)
async let posts = fetchPosts(userID)
let (p, feed) = try await (profile, posts)

// Use TaskGroup for dynamic concurrency
let results = try await withThrowingTaskGroup(of: Item.self) { group in
    for id in ids {
        group.addTask { try await fetchItem(id) }
    }
    return try await group.reduce(into: []) { $0.append($1) }
}
```

### Typed Throws (Swift 6+)

```swift
enum FetchError: Error {
    case networkUnavailable
    case decodingFailed(underlying: Error)
}

func fetchUser(id: UUID) async throws(FetchError) -> User {
    guard NetworkMonitor.isAvailable else { throw .networkUnavailable }
    do {
        let data = try await urlSession.data(from: endpoint(id)).0
        return try JSONDecoder().decode(User.self, from: data)
    } catch {
        throw .decodingFailed(underlying: error)
    }
}
```

---

## Protocol-Oriented Design

### Small Focused Protocols

Define protocols around a single capability. Conformers implement only what they need.

```swift
// Wrong — fat protocol
protocol DataService {
    func fetch() async throws -> [Item]
    func save(_ item: Item) async throws
    func delete(_ id: UUID) async throws
    func export() -> Data
}

// Correct — segregated protocols
protocol ItemFetcher { func fetch() async throws -> [Item] }
protocol ItemWriter { func save(_ item: Item) async throws; func delete(_ id: UUID) async throws }
protocol DataExporter { func export() -> Data }
```

### Protocol Extensions for Shared Defaults

```swift
protocol Loggable {
    var logger: Logger { get }
}

extension Loggable {
    var logger: Logger {
        Logger(subsystem: Bundle.main.bundleIdentifier ?? "app", category: String(describing: Self.self))
    }
}
```

### Dependency Injection via Protocol with Default Parameter

Production code uses the real implementation by default; tests inject a mock without any additional configuration in the production call sites.

```swift
protocol HTTPClient: Sendable {
    func data(for request: URLRequest) async throws -> (Data, URLResponse)
}

extension URLSession: HTTPClient {}  // URLSession already matches the protocol

struct UserRepository {
    private let client: any HTTPClient

    // Default parameter means production callers never see the seam
    init(client: any HTTPClient = URLSession.shared) {
        self.client = client
    }
}

// In tests:
struct MockHTTPClient: HTTPClient {
    var stubbedData: Data = Data()
    func data(for request: URLRequest) async throws -> (Data, URLResponse) {
        (stubbedData, URLResponse())
    }
}
```

---

## State Modeling

### `LoadState<T>` Enum Pattern

Model async data loading states with an enum rather than multiple optionals.

```swift
enum LoadState<T: Sendable>: Sendable {
    case idle
    case loading
    case loaded(T)
    case failed(Error)
}

@Observable
final class ProfileViewModel {
    private(set) var state: LoadState<UserProfile> = .idle

    func load(userID: UUID) async {
        state = .loading
        do {
            let profile = try await repository.fetchProfile(userID)
            state = .loaded(profile)
        } catch {
            state = .failed(error)
        }
    }
}
```

```swift
// SwiftUI view consuming LoadState
switch viewModel.state {
case .idle: Color.clear
case .loading: ProgressView()
case .loaded(let profile): ProfileContentView(profile: profile)
case .failed(let error): ErrorView(error: error, retry: { await viewModel.load(userID: id) })
}
```
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 197kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 197kUpdated Claude CodeCodexVerifiedInstall