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.md

View on GitHub
---
description: "General Swift development for iOS, macOS, watchOS, tvOS, visionOS, and server-side Swift: Swift 6 strict concurrency, Apple API Design Guidelines, App Store security, build/test gates."
type: reference
---

# General Swift Development

Rules for idiomatic, production-ready Swift following the Swift 6 concurrency
model, Apple API Design Guidelines, and App Store security requirements. Use for
full Swift development. For concurrency patterns or test writing in isolation,
the `swift/` references are enough (see the Swift table in `SKILL.md`).

## Expertise areas

- **Swift 6 strict concurrency:** actor isolation, `Sendable` conformance,
  structured concurrency (`async let`, `TaskGroup`), typed throws, data-race
  avoidance.
- **Protocol-oriented design:** small focused protocols, protocol extensions for
  shared defaults, associated types, DI via protocol with a default parameter.
- **Apple platforms:** SwiftUI, UIKit, AppKit, Combine, SwiftData, CoreData
  across iOS, macOS, watchOS, tvOS, visionOS.
- **Server-side Swift:** Vapor routing/middleware, async-await and
  EventLoopFuture interop, no UIKit on server targets.
- **Toolchain:** SwiftFormat, SwiftLint, `swift build` type-checking, Swift
  Package Manager.
- **Testing:** Swift Testing (`import Testing`, `@Test`, `#expect`),
  parameterized tests with `arguments:`, protocol-based mock injection,
  fresh-instance isolation.
- **Security:** Keychain Services, App Transport Security, certificate pinning,
  input validation for API, deep link, and pasteboard data.
- **Immutability:** `let` over `var`, `struct` over `class`, value types for
  DTOs and models.

## Environment assumptions

| Assumption | Value |
|------------|-------|
| Swift version | 6.0+ (strict concurrency checking enabled) |
| Xcode | 16+ (`swift-format` available alongside SwiftFormat) |
| Target platforms | iOS 17+, macOS 14+, watchOS 10+, tvOS 17+, visionOS 1+ (check Package.swift / project settings) |
| Testing framework | Swift Testing for new tests; XCTest for existing suites that have not migrated |
| Concurrency model | `async`/`await` + actors; Combine only for existing code unless Combine is a stated requirement |
| Server-side | Vapor 4+ with async-await; Hummingbird 2+ |

## Hard rules

- **Read the file before editing.** Never edit a file you have not read in this
  session.
- **Run tests and build before reporting completion:** `swift test` and
  `swift build`. Show the actual output, not "tests pass".
- **Feature branch, never main.** If on main, create a branch before committing.
- **Verify dependencies exist before importing them.** Check `Package.swift`
  first.
- **Format every edited `.swift` file:** `swiftformat .` or
  `swift-format format --recursive .`, then `swiftlint lint`, then
  `swift build` to type-check.
- **`let` by default;** `var` only when the compiler requires it.
- **`struct` by default;** `class` only when identity or reference semantics
  are genuinely needed.
- **No `print()` in production code** (test files excepted). Use
  `os.Logger(subsystem: Bundle.main.bundleIdentifier ?? "app", category: "subsystem")`.
  After an edit, grep the non-test file for `print(`.
- **No credentials in UserDefaults.** After an edit, check any `UserDefaults`
  call whose key contains `token`, `password`, `key`, `secret`, `credential`,
  or `auth`; move it to Keychain Services.
- **Safe unwrapping on external data.** `guard let` / `if let` for all API,
  deep link, and pasteboard data. `URL(string:)!`, `data!`, and other force
  unwraps are hard boundaries.
- **Version-aware code.** Detect the minimum deployment target from project
  settings and use only APIs available there.

## Defaults (on unless disabled)

- Run `swift test --enable-code-coverage` after changes; show full output.
- Run `swiftlint lint` after edits; fix all errors, review warnings.
- `///` doc comments on all public functions, types, and properties.

## Off unless requested

- Aggressive refactoring beyond the immediate task.
- Migrating XCTest suites to Swift Testing.
- New SPM dependencies.
- Instruments profiling and micro-optimizations before a bottleneck is confirmed.

## Reference loading table

| Signal | Load | Why |
|---|---|---|
| SwiftUI or UIKit screen layout, hierarchy, spacing, type, color, states (load first; Apple Human Interface Guidelines win over web defaults) | [ui-design-judgment.md](../../../shared-patterns/ui-design-judgment.md), then `ui-design-recipes.md` and `ui-design-examples.md` in the same folder | Design defaults with reasons and the look-then-fix loop |
| immutability, actors, Sendable, async let, typed throws, protocol-oriented design, state modeling | [swift-patterns.md](swift-general/swift-patterns.md) | Core Swift idiom and concurrency patterns |
| secret management, xcconfig, input validation, Swift Testing vs XCTest, fresh-instance isolation, llvm-cov, failure-mode detection | [swift-security-testing.md](swift-general/swift-security-testing.md) | Secret and input rules, test methodology, failure-mode detection table |
| security, auth, Keychain, ATS, WebView, biometrics, certificate pinning, deep links, or any vulnerability-related code | [swift-security.md](swift-general/swift-security.md) | Secure implementation patterns for iOS, macOS, and server-side, with detection commands |
| TaskGroup, AsyncSequence, AsyncStream, cancellation | [task-patterns.md](swift/task-patterns.md) | Task deep reference |
| Blocking MainActor, leaking tasks, actor reentrancy | [preferred-patterns.md](swift/preferred-patterns.md) | Concurrency pitfalls |
| XCTest, Swift Testing, async tests, UI tests | [swift-testing.md](swift/swift-testing.md) | Testing deep reference |

## Related skills

- `workflow` for multi-phase tasks, feature builds, and planning.
- `testing` for TDD, E2E, and verification.
- `review` for code review.
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: 471kUpdated 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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall