Skip to content
Back to search

chops

SkillWorks with Claude CodeGitHub

Your AI agent skills, finally organized. A macOS app to browse, edit, and manage skills across Claude Code, Cursor, Codex, Windsurf, and Amp.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shpigford-chops/badge.svg)](/listings/shpigford-chops)

HTML

<a href="/listings/shpigford-chops"><img src="/api/listings/shpigford-chops/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/Shpigford/chops.git
cd chops
brew install xcodegen    # skip if already installed
xcodegen generate        # generates Chops.xcodeproj from project.yml
open Chops.xcodeproj     # opens in Xcode

Then hit **Cmd+R** to build and run.

> **Note:** The Xcode project is generated from `project.yml`. If you change `project.yml`, re-run `xcodegen generate`. Don't edit the `.xcodeproj` directly.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 197 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="site/public/favicon.png" width="128" height="128" alt="Chops icon" />
  3. </p>
  4. <h1 align="center">Chops</h1>
  5. <p align="center">Your AI skills and agents, finally organized.</p>
  6. <p align="center">
  7. <a href="https://github.com/Shpigford/chops/releases/latest/download/Chops.dmg">Download</a> &middot;
  8. <a href="https://chops.md">Website</a> &middot;
  9. <a href="https://x.com/Shpigford">@Shpigford</a>
  10. </p>
  11. <p align="center">
  12. <img src="site/public/screenshot.png" width="720" alt="Chops screenshot" />
  13. </p>
  14. One macOS app to discover, organize, and edit coding agent skills and agents across Claude Code, Cursor, Codex, Windsurf, and Amp. Stop digging through dotfiles.
  15. ## Features
  16. - **Multi-tool support** — Claude Code, Cursor, Codex, Windsurf, Copilot, Aider, Amp
  17. - **Skills + Agents** — Discovers both skills and agents from each tool's directories
  18. - **Built-in editor** — Monospaced editor with Cmd+S save, frontmatter parsing
  19. - **Collections** — Organize skills and agents without modifying source files
  20. - **Real-time file watching** — FSEvents-based, instant updates on disk changes
  21. - **Full-text search** — Search across name, description, and content
  22. - **Create new skills & agents** — Generates correct boilerplate per tool
  23. - **Remote servers** — Connect to servers running [OpenClaw](https://openclaw.ai), [Hermes](https://github.com/NousResearch/hermes-agent), or other layouts to discover, browse, and install skills
  24. - **Skills Discovery** — Browse, search, and install skills directly from the [skills.sh registry](https://skills.sh)
  25. ## Supported Tools
  26. Chops scans these directories for skills and agents:
  27. | Tool | Skills | Agents |
  28. |------|--------|--------|
  29. | Global | `~/.agents/skills/` | — |
  30. | Claude Code | `~/.claude/skills/` | `~/.claude/agents/` |
  31. | Cursor | `~/.cursor/skills/`, `~/.cursor/rules` | `~/.cursor/agents/` |
  32. | Windsurf | `~/.codeium/windsurf/memories/`, `~/.windsurf/rules` | — |
  33. | Codex | `~/.codex/skills/` | `~/.codex/agents/` |
  34. | Amp | `~/.config/amp/skills/` | — |
  35. Copilot and Aider are also supported but only detect project-level skills and agents (no global paths). Custom scan paths can be added for any tool.
  36. Tool definitions live in `Chops/Models/ToolSource.swift` — each enum case knows its display name, icon, color, and filesystem paths.
  37. ---
  38. ## Running from source
  39. Build and run Chops locally with the steps below. End users can [download the latest release](https://github.com/Shpigford/chops/releases/latest/download/Chops.dmg) instead.
  40. ### Prerequisites
  41. - **macOS 15** (Sequoia) or later
  42. - **Xcode** with command-line tools (`xcode-select --install`)
  43. - **Homebrew** ([brew.sh](https://brew.sh))
  44. - **xcodegen** — `brew install xcodegen`
  45. Sparkle (auto-update framework) is the only external dependency and is pulled automatically by Xcode via Swift Package Manager. No manual setup needed.
  46. ### Quick Start
  47. ```bash
  48. git clone https://github.com/Shpigford/chops.git
  49. cd chops
  50. brew install xcodegen # skip if already installed
  51. xcodegen generate # generates Chops.xcodeproj from project.yml
  52. open Chops.xcodeproj # opens in Xcode
  53. ```
  54. Then hit **Cmd+R** to build and run.
  55. > **Note:** The Xcode project is generated from `project.yml`. If you change `project.yml`, re-run `xcodegen generate`. Don't edit the `.xcodeproj` directly.
  56. ### CLI build (no Xcode GUI)
  57. ```bash
  58. xcodebuild -scheme Chops -configuration Debug build
  59. ```
  60. ## Contributing
  61. Want to change the app? The sections below cover project layout, architecture, and common tasks.
  62. ### Project Structure
  63. ```
  64. Chops/
  65. ├── App/
  66. │ ├── ChopsApp.swift # @main entry — SwiftData ModelContainer + Sparkle
  67. │ ├── AppState.swift # @Observable singleton — filters, selection, search
  68. │ └── ContentView.swift # Three-column NavigationSplitView, kicks off scanning
  69. ├── Models/
  70. │ ├── Skill.swift # @Model — a discovered skill or agent file
  71. │ ├── Collection.swift # @Model — user-created skill groupings
  72. │ └── ToolSource.swift # Enum of supported tools, their paths and icons
  73. ├── Services/
  74. │ ├── SkillScanner.swift # Probes tool directories, upserts skills into SwiftData
  75. │ ├── SkillParser.swift # Dispatches to FrontmatterParser or MDCParser
  76. │ ├── FileWatcher.swift # FSEvents listener, triggers re-scan on changes
  77. │ └── SearchService.swift # In-memory full-text search
  78. ├── Utilities/
  79. │ ├── FrontmatterParser.swift # Extracts YAML frontmatter from .md files
  80. │ └── MDCParser.swift # Parses Cursor .mdc files
  81. ├── Views/
  82. │ ├── Sidebar/ # Tool filters, skills/agents lists, collections
  83. │ ├── Detail/ # Skill editor, metadata display
  84. │ ├── Settings/ # Preferences & update UI
  85. │ └── Shared/ # Reusable components (ToolBadge, NewSkillSheet)
  86. ├── Resources/ # Asset catalog (tool icons, colors)
  87. └── Chops.entitlements # Disables sandbox (intentional)
  88. project.yml # xcodegen config — source of truth for Xcode project settings
  89. scripts/ # Release pipeline (release.sh)
  90. site/ # Marketing website (Astro 6)
  91. ```
  92. ### Architecture
  93. **SwiftUI + SwiftData**, native macOS with zero web views.
  94. #### App lifecycle
  95. 1. `ChopsApp` initializes a SwiftData `ModelContainer` (persists `Skill` and `SkillCollection`)
  96. 2. Sparkle updater starts in the background
  97. 3. `AppState` is created and injected into the SwiftUI environment
  98. 4. `ContentView` renders and calls `startScanning()`
  99. 5. `SkillScanner` probes all tool directories and upserts discovered skills
  100. 6. `FileWatcher` attaches FSEvents listeners — on any change, the scanner re-runs automatically
  101. #### Key design decisions
  102. - **No sandbox.** The app needs unrestricted filesystem access to read dotfiles across `~/`. This is intentional and required for core functionality. The entitlements file explicitly disables the app sandbox.
  103. - **Dedup via symlinks.** Skills are uniquely identified by their resolved symlink path. If the same file is symlinked into multiple tool directories, it shows up as one skill with multiple tool badges.
  104. - **No test suite.** Validate changes manually — build, run, trigger the feature you changed, observe the result.
  105. #### State management
  106. `AppState` is an `@Observable` class that holds all UI state: selected tool filter, selected skill, search text, sidebar filter mode. It's injected via `@Environment` and accessible from any view.
  107. #### UI layout
  108. Three-column `NavigationSplitView`:
  109. - **Sidebar** — tool filters and collections
  110. - **List** — filtered/searched skill list
  111. - **Detail** — skill editor (wraps `NSTextView` for native text editing with Cmd+S save)
  112. ### Common Dev Tasks
  113. #### Add support for a new tool
  114. 1. Add a new case to the `ToolSource` enum in `Chops/Models/ToolSource.swift`
  115. 2. Fill in `displayName`, `iconName`, `color`, and `globalPaths`
  116. 3. Optionally add a logo to the asset catalog and return it from `logoAssetName`
  117. 4. Update `SkillScanner` if the new tool uses a non-standard file layout
  118. #### Modify skill parsing
  119. - **Frontmatter (`.md`)** — edit `Chops/Utilities/FrontmatterParser.swift`
  120. - **Cursor `.mdc` files** — edit `Chops/Utilities/MDCParser.swift`
  121. - **Dispatch logic** — edit `Chops/Services/SkillParser.swift` (decides which parser to use)
  122. #### Change the UI
  123. Views are in `Chops/Views/`, organized by column (Sidebar, Detail) and shared components. The main layout is in `Chops/App/ContentView.swift`.
  124. ### Testing
  125. No automated test suite. Validate manually:
  126. 1. Build and run the app (Cmd+R)
  127. 2. Trigger the exact feature you changed
  128. 3. Observe the result — check for correct behavior and error messages
  129. 4. Test edge cases (empty states, missing directories, malformed files)
  130. ### AI Agent Setup
  131. This repo includes a Claude Code skill at `.claude/skills/setup.md` that gives AI coding agents full context on the project — architecture, key files, and common tasks. If you're using Claude Code, it'll pick this up automatically.
  132. ## Website
  133. The marketing site lives in `site/` and is built with [Astro](https://astro.build/).
  134. ```bash
  135. cd site
  136. npm install # first time only
  137. npm run dev # local dev server
  138. npm run build # production build → site/dist/
  139. ```
  140. ## License
  141. FSL-1.1-MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.