[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M799TQBJ2CTB73KXEP065SVZ":3,"skill-same:01M799TQBJ2CTB73KXEP065SVZ":74},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":32,"commitSha":33,"skillDirectory":34,"forksCount":14,"repositoryHtmlUrl":35,"repositoryHomepageUrl":6,"ownerHtmlUrl":36,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":37,"install":38,"resources":51},"01M799TQBJ2CTB73KXEP065SVZ","swift-expert",null,"Builds iOS\u002FmacOS\u002FwatchOS\u002FtvOS applications, implements SwiftUI views and state management, designs protocol-oriented architectures, handles async\u002Fawait concurrency, implements actors for thread safety, and debugs Swift-specific issues. Use when building iOS\u002FmacOS applications with Swift 5.9+, SwiftUI, or async\u002Fawait concurrency. Invoke for protocol-oriented programming, SwiftUI state management, actors, server-side Swift, UIKit integration, Combine, or Vapor.","Elogic360\u002Fsoftware-factory","Elogic360","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F156535519?v=4","01M74NH3F0RB13PWB7JZDE2V80","elogic360","01M74NH3FPC65082MDZVMFHDM3",0,"MIT","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-jeffallan\u002Fskills\u002Fswift-expert\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: swift-expert\ndescription: Builds iOS\u002FmacOS\u002FwatchOS\u002FtvOS applications, implements SwiftUI views and state management, designs protocol-oriented architectures, handles async\u002Fawait concurrency, implements actors for thread safety, and debugs Swift-specific issues. Use when building iOS\u002FmacOS applications with Swift 5.9+, SwiftUI, or async\u002Fawait concurrency. Invoke for protocol-oriented programming, SwiftUI state management, actors, server-side Swift, UIKit integration, Combine, or Vapor.\nlicense: MIT\nmetadata:\n  author: https:\u002F\u002Fgithub.com\u002FJeffallan\n  version: \"1.1.0\"\n  domain: language\n  triggers: Swift, SwiftUI, iOS development, macOS development, async\u002Fawait Swift, Combine, UIKit, Vapor\n  role: specialist\n  scope: implementation\n  output-format: code\n  related-skills: \n---\n\n# Swift Expert\n\n## Core Workflow\n\n1. **Architecture Analysis** - Identify platform targets, dependencies, design patterns\n2. **Design Protocols** - Create protocol-first APIs with associated types\n3. **Implement** - Write type-safe code with async\u002Fawait and value semantics\n4. **Optimize** - Profile with Instruments, ensure thread safety\n5. **Test** - Write comprehensive tests with XCTest and async patterns\n\n> **Validation checkpoints:** After step 3, run `swift build` to verify compilation. After step 4, run `swift build -warnings-as-errors` to surface actor isolation and Sendable warnings. After step 5, run `swift test` and confirm all async tests pass.\n\n## Reference Guide\n\nLoad detailed guidance based on context:\n\n| Topic | Reference | Load When |\n|-------|-----------|-----------|\n| SwiftUI | `references\u002Fswiftui-patterns.md` | Building views, state management, modifiers |\n| Concurrency | `references\u002Fasync-concurrency.md` | async\u002Fawait, actors, structured concurrency |\n| Protocols | `references\u002Fprotocol-oriented.md` | Protocol design, generics, type erasure |\n| Memory | `references\u002Fmemory-performance.md` | ARC, weak\u002Funowned, performance optimization |\n| Testing | `references\u002Ftesting-patterns.md` | XCTest, async tests, mocking strategies |\n\n## Code Patterns\n\n### async\u002Fawait — Correct vs. Incorrect\n\n```swift\n\u002F\u002F ✅ DO: async\u002Fawait with structured error handling\nfunc fetchUser(id: String) async throws -> User {\n    let url = URL(string: \"https:\u002F\u002Fapi.example.com\u002Fusers\u002F\\(id)\")!\n    let (data, _) = try await URLSession.shared.data(from: url)\n    return try JSONDecoder().decode(User.self, from: data)\n}\n\n\u002F\u002F ❌ DON'T: mixing completion handlers with async context\nfunc fetchUser(id: String) async throws -> User {\n    return try await withCheckedThrowingContinuation { continuation in\n        \u002F\u002F Avoid wrapping existing async APIs this way when a native async version exists\n        legacyFetch(id: id) { result in\n            continuation.resume(with: result)\n        }\n    }\n}\n```\n\n### SwiftUI State Management\n\n```swift\n\u002F\u002F ✅ DO: use @Observable (Swift 5.9+) for view models\n@Observable\nfinal class CounterViewModel {\n    var count = 0\n    func increment() { count += 1 }\n}\n\nstruct CounterView: View {\n    @State private var vm = CounterViewModel()\n\n    var body: some View {\n        VStack {\n            Text(\"\\(vm.count)\")\n            Button(\"Increment\", action: vm.increment)\n        }\n    }\n}\n\n\u002F\u002F ❌ DON'T: reach for ObservableObject\u002FPublished when @Observable suffices\nclass LegacyViewModel: ObservableObject {\n    @Published var count = 0  \u002F\u002F Unnecessary boilerplate in Swift 5.9+\n}\n```\n\n### Protocol-Oriented Architecture\n\n```swift\n\u002F\u002F ✅ DO: define capability protocols with associated types\nprotocol Repository\u003CEntity> {\n    associatedtype Entity: Identifiable\n    func fetch(id: Entity.ID) async throws -> Entity\n    func save(_ entity: Entity) async throws\n}\n\nstruct UserRepository: Repository {\n    typealias Entity = User\n    func fetch(id: UUID) async throws -> User { \u002F* … *\u002F }\n    func save(_ user: User) async throws { \u002F* … *\u002F }\n}\n\n\u002F\u002F ❌ DON'T: use classes as base types when a protocol fits\nclass BaseRepository {  \u002F\u002F Avoid class inheritance for shared behavior\n    func fetch(id: UUID) async throws -> Any { fatalError(\"Override required\") }\n}\n```\n\n### Actor for Thread Safety\n\n```swift\n\u002F\u002F ✅ DO: isolate mutable shared state in an actor\nactor ImageCache {\n    private var cache: [URL: UIImage] = [:]\n\n    func image(for url: URL) -> UIImage? { cache[url] }\n    func store(_ image: UIImage, for url: URL) { cache[url] = image }\n}\n\n\u002F\u002F ❌ DON'T: use a class with manual locking\nclass UnsafeImageCache {\n    private var cache: [URL: UIImage] = [:]\n    private let lock = NSLock()  \u002F\u002F Error-prone; prefer actor isolation\n    func image(for url: URL) -> UIImage? {\n        lock.lock(); defer { lock.unlock() }\n        return cache[url]\n    }\n}\n```\n\n## Constraints\n\n### MUST DO\n- Use type hints and inference appropriately\n- Follow Swift API Design Guidelines\n- Use `async\u002Fawait` for asynchronous operations (see pattern above)\n- Ensure `Sendable` compliance for concurrency\n- Use value types (`struct`\u002F`enum`) by default\n- Document APIs with markup comments (`\u002F\u002F\u002F …`)\n- Use property wrappers for cross-cutting concerns\n- Profile with Instruments before optimizing\n\n### MUST NOT DO\n- Use force unwrapping (`!`) without justification\n- Create retain cycles in closures\n- Mix synchronous and asynchronous code improperly\n- Ignore actor isolation warnings\n- Use implicitly unwrapped optionals unnecessarily\n- Skip error handling\n- Use Objective-C patterns when Swift alternatives exist\n- Hardcode platform-specific values\n\n## Output Templates\n\nWhen implementing Swift features, provide:\n1. Protocol definitions and type aliases\n2. Model types (structs\u002Fclasses with value semantics)\n3. View implementations (SwiftUI) or view controllers\n4. Tests demonstrating usage\n5. Brief explanation of architectural decisions\n\n[Documentation](https:\u002F\u002Fjeffallan.github.io\u002Fclaude-skills\u002Fskills\u002Flanguage\u002Fswift-expert\u002F)\n","# Swift Expert\n\n## Core Workflow\n\n1. **Architecture Analysis** - Identify platform targets, dependencies, design patterns\n2. **Design Protocols** - Create protocol-first APIs with associated types\n3. **Implement** - Write type-safe code with async\u002Fawait and value semantics\n4. **Optimize** - Profile with Instruments, ensure thread safety\n5. **Test** - Write comprehensive tests with XCTest and async patterns\n\n> **Validation checkpoints:** After step 3, run `swift build` to verify compilation. After step 4, run `swift build -warnings-as-errors` to surface actor isolation and Sendable warnings. After step 5, run `swift test` and confirm all async tests pass.\n\n## Reference Guide\n\nLoad detailed guidance based on context:\n\n| Topic | Reference | Load When |\n|-------|-----------|-----------|\n| SwiftUI | `references\u002Fswiftui-patterns.md` | Building views, state management, modifiers |\n| Concurrency | `references\u002Fasync-concurrency.md` | async\u002Fawait, actors, structured concurrency |\n| Protocols | `references\u002Fprotocol-oriented.md` | Protocol design, generics, type erasure |\n| Memory | `references\u002Fmemory-performance.md` | ARC, weak\u002Funowned, performance optimization |\n| Testing | `references\u002Ftesting-patterns.md` | XCTest, async tests, mocking strategies |\n\n## Code Patterns\n\n### async\u002Fawait — Correct vs. Incorrect\n\n```swift\n\u002F\u002F ✅ DO: async\u002Fawait with structured error handling\nfunc fetchUser(id: String) async throws -> User {\n    let url = URL(string: \"https:\u002F\u002Fapi.example.com\u002Fusers\u002F\\(id)\")!\n    let (data, _) = try await URLSession.shared.data(from: url)\n    return try JSONDecoder().decode(User.self, from: data)\n}\n\n\u002F\u002F ❌ DON'T: mixing completion handlers with async context\nfunc fetchUser(id: String) async throws -> User {\n    return try await withCheckedThrowingContinuation { continuation in\n        \u002F\u002F Avoid wrapping existing async APIs this way when a native async version exists\n        legacyFetch(id: id) { result in\n            continuation.resume(with: result)\n        }\n    }\n}\n```\n\n### SwiftUI State Management\n\n```swift\n\u002F\u002F ✅ DO: use @Observable (Swift 5.9+) for view models\n@Observable\nfinal class CounterViewModel {\n    var count = 0\n    func increment() { count += 1 }\n}\n\nstruct CounterView: View {\n    @State private var vm = CounterViewModel()\n\n    var body: some View {\n        VStack {\n            Text(\"\\(vm.count)\")\n            Button(\"Increment\", action: vm.increment)\n        }\n    }\n}\n\n\u002F\u002F ❌ DON'T: reach for ObservableObject\u002FPublished when @Observable suffices\nclass LegacyViewModel: ObservableObject {\n    @Published var count = 0  \u002F\u002F Unnecessary boilerplate in Swift 5.9+\n}\n```\n\n### Protocol-Oriented Architecture\n\n```swift\n\u002F\u002F ✅ DO: define capability protocols with associated types\nprotocol Repository\u003CEntity> {\n    associatedtype Entity: Identifiable\n    func fetch(id: Entity.ID) async throws -> Entity\n    func save(_ entity: Entity) async throws\n}\n\nstruct UserRepository: Repository {\n    typealias Entity = User\n    func fetch(id: UUID) async throws -> User { \u002F* … *\u002F }\n    func save(_ user: User) async throws { \u002F* … *\u002F }\n}\n\n\u002F\u002F ❌ DON'T: use classes as base types when a protocol fits\nclass BaseRepository {  \u002F\u002F Avoid class inheritance for shared behavior\n    func fetch(id: UUID) async throws -> Any { fatalError(\"Override required\") }\n}\n```\n\n### Actor for Thread Safety\n\n```swift\n\u002F\u002F ✅ DO: isolate mutable shared state in an actor\nactor ImageCache {\n    private var cache: [URL: UIImage] = [:]\n\n    func image(for url: URL) -> UIImage? { cache[url] }\n    func store(_ image: UIImage, for url: URL) { cache[url] = image }\n}\n\n\u002F\u002F ❌ DON'T: use a class with manual locking\nclass UnsafeImageCache {\n    private var cache: [URL: UIImage] = [:]\n    private let lock = NSLock()  \u002F\u002F Error-prone; prefer actor isolation\n    func image(for url: URL) -> UIImage? {\n        lock.lock(); defer { lock.unlock() }\n        return cache[url]\n    }\n}\n```\n\n## Constraints\n\n### MUST DO\n- Use type hints and inference appropriately\n- Follow Swift API Design Guidelines\n- Use `async\u002Fawait` for asynchronous operations (see pattern above)\n- Ensure `Sendable` compliance for concurrency\n- Use value types (`struct`\u002F`enum`) by default\n- Document APIs with markup comments (`\u002F\u002F\u002F …`)\n- Use property wrappers for cross-cutting concerns\n- Profile with Instruments before optimizing\n\n### MUST NOT DO\n- Use force unwrapping (`!`) without justification\n- Create retain cycles in closures\n- Mix synchronous and asynchronous code improperly\n- Ignore actor isolation warnings\n- Use implicitly unwrapped optionals unnecessarily\n- Skip error handling\n- Use Objective-C patterns when Swift alternatives exist\n- Hardcode platform-specific values\n\n## Output Templates\n\nWhen implementing Swift features, provide:\n1. Protocol definitions and type aliases\n2. Model types (structs\u002Fclasses with value semantics)\n3. View implementations (SwiftUI) or view controllers\n4. Tests demonstrating usage\n5. Brief explanation of architectural decisions\n\n[Documentation](https:\u002F\u002Fjeffallan.github.io\u002Fclaude-skills\u002Fskills\u002Flanguage\u002Fswift-expert\u002F)\n",{"name":5,"license":15,"metadata":24,"description":7},{"role":25,"scope":26,"author":27,"domain":28,"version":29,"triggers":30,"output-format":31,"related-skills":6},"specialist","implementation","https:\u002F\u002Fgithub.com\u002FJeffallan","language","1.1.0","Swift, SwiftUI, iOS development, macOS development, async\u002Fawait Swift, Combine, UIKit, Vapor","code","main","c475fc64e94e803b50d14a791dfee8853fbb2c5c","integrations\u002Fclaude-skills-jeffallan\u002Fskills\u002Fswift-expert","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory","https:\u002F\u002Fgithub.com\u002FElogic360","2026-11-08 22:21:22",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add Elogic360\u002Fsoftware-factory --skill swift-expert",{"tool":44,"command":45},"bunx","bunx skills add Elogic360\u002Fsoftware-factory --skill swift-expert",{"tool":47,"command":48},"pnpm","pnpm dlx skills add Elogic360\u002Fsoftware-factory --skill swift-expert","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-jeffallan\u002Fskills\u002Fswift-expert\u002FSKILL.md",true,[52,58,62,66,70],{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fasync-concurrency.md","REFERENCE","参考文档",8467,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-jeffallan\u002Fskills\u002Fswift-expert\u002Freferences\u002Fasync-concurrency.md",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fmemory-performance.md",8256,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-jeffallan\u002Fskills\u002Fswift-expert\u002Freferences\u002Fmemory-performance.md",{"path":63,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":64,"sourceHtmlUrl":65},"references\u002Fprotocol-oriented.md",7360,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-jeffallan\u002Fskills\u002Fswift-expert\u002Freferences\u002Fprotocol-oriented.md",{"path":67,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":68,"sourceHtmlUrl":69},"references\u002Fswiftui-patterns.md",6806,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-jeffallan\u002Fskills\u002Fswift-expert\u002Freferences\u002Fswiftui-patterns.md",{"path":71,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":72,"sourceHtmlUrl":73},"references\u002Ftesting-patterns.md",9056,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-jeffallan\u002Fskills\u002Fswift-expert\u002Freferences\u002Ftesting-patterns.md",[75,83,90,97,104,111],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M79G206MT3J6S0GY3C45P2KV","vss-summarize-video","Use to summarize a recorded video via the LVS summarization microservice (HITL-gated) with a VLM fallback. Not for report generation or live RTSP captioning.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-summarize-video\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M79G1WN63PGRE8CKD47WEBQ5","vss-setup-video-analytics-api","Use to deploy the vss-video-analytics-api REST service standalone (config-source, data-log bind, Elasticsearch, optional Kafka). Not for full warehouse deploy.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-setup-video-analytics-api\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M79G1S9F7VY3EF6H53PRP5AN","vss-setup-behavior-analytics","Use to deploy the vss-behavior-analytics service standalone (entrypoint, config-source, optional calibration). Not for the full warehouse deploy.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-setup-behavior-analytics\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M79G1N1S1Y27PFZPYMNK1MTQ","vss-search-archive","Use this skill to run top-level VSS fusion search on archived video, or to ingest video files \u002F RTSP streams for search. Do NOT use for ad-hoc visual Q&A (use vss-ask-video), live captioning (use vss-deploy-dense-captioning), or video summarization and reports (use vss-summarize-video).","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-search-archive\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":19},"01M79G1H6WN0Q6C0VCAXCZX6B7","vss-query-analytics","Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-query-analytics\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":19},"01M79G1DYPNXQS7QHZ0AAF5FX5","vss-manage-video-io-storage","Use to call the VIOS REST API (sensor list, timelines, clip extraction, snapshots, add\u002Fdelete sensors and streams). Not for VLM inference or search.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-manage-video-io-storage\u002FSKILL.md",[],[]]