Your AI agent skills, finally organized. A macOS app to browse, edit, and manage skills across Claude Code, Cursor, Codex, Windsurf, and Amp.
feat: detect Claude Desktop and CLI plugin skills (#46) (#48)
Josh Pigforde11a1e9daea4
diff --git a/Chops/App/ContentView.swift b/Chops/App/ContentView.swiftindex 6d78c57..7276277 100644--- a/Chops/App/ContentView.swift+++ b/Chops/App/ContentView.swift@@ -73,6 +73,19 @@ struct ContentView: View {for tool in ToolSource.allCases {allPaths.append(contentsOf: tool.globalPaths)}+ let fm = FileManager.default+ let home = fm.homeDirectoryForCurrentUser.path+ let claudePlugins = "\(home)/.claude/plugins"+ let claudePluginCache = "\(claudePlugins)/cache"+ let claudePluginManifest = "\(claudePlugins)/installed_plugins.json"+ for path in [claudePlugins, claudePluginCache, claudePluginManifest] where fm.fileExists(atPath: path) {+ allPaths.append(path)+ }+ let claudeDesktopSessions = "\(home)/Library/Application Support/Claude/local-agent-mode-sessions"+ if fm.fileExists(atPath: claudeDesktopSessions) {+ allPaths.append(claudeDesktopSessions)+ }+ allPaths = Array(Set(allPaths)).sorted()let watcher = FileWatcher { _ inscanner.scanAll()diff --git a/Chops/Models/ToolSource.swift b/Chops/Models/ToolSource.swiftindex 5e2d7f5..0682cbb 100644--- a/Chops/Models/ToolSource.swift+++ b/Chops/Models/ToolSource.swift@@ -13,6 +13,7 @@ enum ToolSource: String, Codable, CaseIterable, Identifiable {case opencodecase picase antigravity+ case claudeDesktopcase customvar id: String { rawValue }@@ -31,6 +32,7 @@ enum ToolSource: String, Codable, CaseIterable, Identifiable {case .pi: "Pi"case .agents: "Global Agents"case .antigravity: "Antigravity"+ case .claudeDesktop: "Claude Desktop"case .custom: "Custom"}}@@ -50,6 +52,7 @@ enum ToolSource: String, Codable, CaseIterable, Identifiable {case .pi: "sparkles"case .agents: "globe"case .antigravity: "arrow.up.circle"+ case .claudeDesktop: "desktopcomputer"case .custom: "folder"}}@@ -64,6 +67,7 @@ enum ToolSource: String, Codable, CaseIterable, Identifiable {case .copilot: "tool-copilot"case .amp: "tool-amp"case .antigravity: "tool-antigravity"+ case .claudeDesktop: "tool-claude"case .opencode: "tool-opencode"default: nil}@@ -83,6 +87,7 @@ enum ToolSource: String, Codable, CaseIterable, Identifiable {case .pi: .cyancase .agents: .mintcase .antigravity: .red+ case .claudeDesktop: .orangecase .custom: .gray}}@@ -108,6 +113,7 @@ enum ToolSource: String, Codable, CaseIterable, Identifiable {case .pi: return ["\(home)/.pi/agent/skills"]case .agents: return ["\(home)/.agents/skills"]case .antigravity: return ["\(home)/.gemini/antigravity/skills"]+ case .claudeDesktop: return []case .custom: return []}}@@ -123,6 +129,7 @@ enum ToolSource: String, Codable, CaseIterable, Identifiable {case .claude:return fm.fileExists(atPath: "\(home)/.claude/settings.json")|| fm.fileExists(atPath: "\(home)/.claude/CLAUDE.md")+ || fm.fileExists(atPath: "\(home)/.claude/plugins/installed_plugins.json")|| Self.cliBinaryExists("claude")case .cursor:return fm.fileExists(atPath: "/Applications/Cursor.app")@@ -160,6 +167,8 @@ enum ToolSource: String, Codable, CaseIterable, Identifiable {|| fm.fileExists(atPath: "\(configHome)/opencode/opencode.jsonc")|| fm.fileExists(atPath: "\(home)/.local/share/opencode")|| Self.cliBinaryExists("opencode")+ case .claudeDesktop:+ return Self.appBundleExists("Claude")case .aider, .openclaw, .custom:return true}diff --git a/Chops/Services/SkillParser.swift b/Chops/Services/SkillParser.swiftindex 2bdaf75..fe10a28 100644--- a/Chops/Services/SkillParser.swift+++ b/Chops/Services/SkillParser.swift@@ -7,7 +7,7 @@ enum SkillParser {}switch toolSource {- case .claude, .cursor:+ case .claude, .claudeDesktop, .cursor:if fileURL.pathExtension == "mdc" {return MDCParser.parse(content)}diff --git a/Chops/Services/SkillScanner.swift b/Chops/Services/SkillScanner.swiftindex 9aa7de9..a65df69 100644--- a/Chops/Services/SkillScanner.swift+++ b/Chops/Services/SkillScanner.swift@@ -96,6 +96,16 @@ final class SkillScanner {}}+ // CLI plugins (installed_plugins.json)+ if ToolSource.claude.isInstalled {+ collectFromCLIPlugins(into: &results)+ }++ // Claude Desktop/Cowork plugin skills+ if ToolSource.claudeDesktop.isInstalled {+ collectClaudeDesktopSkills(into: &results)+ }+for path in customPaths {guard !Task.isCancelled else { return results }collectFromCustomDirectory(URL(fileURLWithPath: path), into: &results)@@ -177,17 +187,62 @@ final class SkillScanner {}}+ /// For Claude Desktop plugin paths, produce a canonical identity that strips volatile+ /// components (session IDs, version numbers). For all other tools, returns the normal+ /// symlink-resolved path. Same pattern as remote skills using `remote://` prefixes.+ private static func canonicalResolvedPath(for fileURL: URL, toolSource: ToolSource) -> String {+ let resolved = fileURL.resolvingSymlinksInPath().path+ let path = fileURL.path++ // CLI plugins: .../.claude/plugins/cache/<publisher>/<plugin>/<version>/skills/<skill>/SKILL.md+ if toolSource == .claude, let range = path.range(of: ".claude/plugins/cache/") {+ let after = String(path[range.upperBound...])+ let parts = after.components(separatedBy: "/")+ // parts: [publisher, plugin, version, "skills", skill, "SKILL.md"]+ guard parts.count >= 6, parts[3] == "skills" else { return resolved }+ return "claude-plugin:\(parts[0])/\(parts[1])/\(parts[4])"+ }++ guard toolSource == .claudeDesktop else { return resolved }++ // Local plugins: .../cowork_plugins/cache/<marketplace>/<plugin>/<version>/skills/<skill>/SKILL.md+ if let range = path.range(of: "cowork_plugins/cache/") {+ let after = String(path[range.upperBound...])+ let parts = after.components(separatedBy: "/")+ // parts: [marketplace, plugin, version, "skills", skill, "SKILL.md"]+ guard parts.count >= 6, parts[3] == "skills" else { return resolved }+ return "claude-desktop:cowork_plugins/\(parts[0])/\(parts[1])/\(parts[4])"+ }++ // Remote plugins: .../remote_cowork_plugins/<plugin-id>/skills/<skill>/SKILL.md+ if let range = path.range(of: "remote_cowork_plugins/") {+ let after = String(path[range.upperBound...])+ let parts = after.components(separatedBy: "/")+ // parts: [plugin-id, "skills", skill, "SKILL.md"]+ guard parts.count >= 4, parts[1] == "skills" else { return resolved }+ return "claude-desktop:remote_cowork_plugins/\(parts[0])/\(parts[2])"+ }++ return resolved+ }++ private static func isSyntheticLocalResolvedPath(_ resolvedPath: String) -> Bool {+ resolvedPath.hasPrefix("claude-plugin:") || resolvedPath.hasPrefix("claude-desktop:")+ }+/// Read and parse a single skill file. Pure I/O, no SwiftData.private static func collectSkillData(at fileURL: URL, toolSource: ToolSource, isDirectory: Bool, isGlobal: Bool) -> ScannedSkillData? {let fm = FileManager.default- let resolved = fileURL.resolvingSymlinksInPath().path+ let resolved = canonicalResolvedPath(for: fileURL, toolSource: toolSource)guard let parsed = SkillParser.parse(fileURL: fileURL, toolSource: toolSource) else {AppLogger.scanning.warning("Failed to parse: \(fileURL.path)")return nil}- let attrs = try? fm.attributesOfItem(atPath: resolved)+ // Use the actual filesystem path for attributes (resolved may be a canonical identifier)+ let attrPath = fileURL.resolvingSymlinksInPath().path+ let attrs = try? fm.attributesOfItem(atPath: attrPath)let modDate = (attrs?[.modificationDate] as? Date) ?? .nowlet fileSize = (attrs?[.size] as? Int) ?? 0@@ -215,6 +270,88 @@ final class SkillScanner {)}+ // MARK: - Claude Plugin Scanning++ /// Scan CLI plugins from ~/.claude/plugins/installed_plugins.json+ private static func collectFromCLIPlugins(into results: inout [ScannedSkillData]) {+ let fm = FileManager.default+ let home = fm.homeDirectoryForCurrentUser.path+ let jsonPath = "\(home)/.claude/plugins/installed_plugins.json"++ guard let data = fm.contents(atPath: jsonPath),+ let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],+ let plugins = json["plugins"] as? [String: [[String: Any]]] else { return }++ for (_, installations) in plugins {+ guard !Task.isCancelled else { return }+ for installation in installations {+ guard let installPath = installation["installPath"] as? String else { continue }+ let skillsDir = URL(fileURLWithPath: installPath).appendingPathComponent("skills")+ collectFromDirectory(skillsDir, toolSource: .claude, isGlobal: true, into: &results)+ }+ }+ }++ /// Scan Claude Desktop/Cowork plugin skills using manifests as source of truth.+ /// Only scans explicitly installed plugins — skips built-in Anthropic skills (skills-plugin/).+ private static func collectClaudeDesktopSkills(into results: inout [ScannedSkillData]) {+ let fm = FileManager.default+ let home = fm.homeDirectoryForCurrentUser.path+ let sessionsRoot = "\(home)/Library/Application Support/Claude/local-agent-mode-sessions"++ guard fm.fileExists(atPath: sessionsRoot) else { return }+ guard let sessionDirs = try? fm.contentsOfDirectory(atPath: sessionsRoot) else { return }++ for sessionDir in sessionDirs {+ guard !Task.isCancelled else { return }+ // Skip skills-plugin (Anthropic built-in skills, not user-installed)+ if sessionDir == "skills-plugin" { continue }++ let sessionPath = "\(sessionsRoot)/\(sessionDir)"+ guard let subDirs = try? fm.contentsOfDirectory(atPath: sessionPath) else { continue }++ for subDir in subDirs {+ guard !Task.isCancelled else { return }+ let subPath = "\(sessionPath)/\(subDir)"++ // Local cowork plugins: use installed_plugins.json as source of truth+ let installedJson = "\(subPath)/cowork_plugins/installed_plugins.json"+ if let data = fm.contents(atPath: installedJson),+ let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],+ let plugins = json["plugins"] as? [String: [[String: Any]]] {+ for (_, installations) in plugins {+ guard !Task.isCancelled else { return }+ for installation in installations {+ guard let installPath = installation["installPath"] as? String else { continue }+ let skillsDir = URL(fileURLWithPath: installPath).appendingPathComponent("skills")+ collectFromDirectory(skillsDir, toolSource: .claudeDesktop, isGlobal: true, into: &results)+ }+ }+ }++ // Remote cowork plugins: use manifest.json as source of truth+ let remoteDir = "\(subPath)/remote_cowork_plugins"+ let manifestPath = "\(remoteDir)/manifest.json"+ if let data = fm.contents(atPath: manifestPath),+ let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],+ let plugins = json["plugins"] as? [[String: Any]] {+ for plugin in plugins {+ guard !Task.isCancelled else { return }+ guard let pluginId = plugin["id"] as? String else { continue }+ let skillsDir = "\(remoteDir)/\(pluginId)/skills"+ guard fm.fileExists(atPath: skillsDir) else { continue }+ collectFromDirectory(+ URL(fileURLWithPath: skillsDir),+ toolSource: .claudeDesktop,+ isGlobal: true,+ into: &results+ )+ }+ }+ }+ }+ }+/// Apply collected results to SwiftData. Must be called on main thread.@MainActorprivate func applyResults(_ results: [ScannedSkillData]) {@@ -368,6 +505,10 @@ final class SkillScanner {// Remote skills are managed by scanRemoteServer(), skip hereif skill.isRemote { continue }+ // Plugin skills use canonical IDs, not filesystem paths. Let applyResults()+ // handle their lifecycle so updates don't delete and recreate user metadata.+ if Self.isSyntheticLocalResolvedPath(skill.resolvedPath) { continue }+// Remove previously-scanned loose markdown files that are now filtered out.let fileName = URL(fileURLWithPath: skill.filePath).lastPathComponentif !skill.isDirectory, Self.shouldIgnoreLooseMarkdownFile(named: fileName) {diff --git a/Chops/Views/Shared/ToolBadge.swift b/Chops/Views/Shared/ToolBadge.swiftindex f251ecd..bdbcfc1 100644--- a/Chops/Views/Shared/ToolBadge.swift+++ b/Chops/Views/Shared/ToolBadge.swift@@ -48,6 +48,7 @@ extension ToolSource {case .pi: "PI"case .agents: "AG"case .antigravity: "AV"+ case .claudeDesktop: "CD"case .custom: "?"}}