setup
starsforks
How to install setup?
shpigford/chops/setup
$npx -y skills add Shpigford/chops --skill setupGet a new developer up and running with the Chops codebase — prerequisites, build, architecture, and common tasks.
SKILL.md
| 1 | Set up the Chops development environment and orient a new contributor to the codebase. |
| 2 | |
| 3 | ## Instructions |
| 4 | |
| 5 | ### Step 1: Check prerequisites |
| 6 | |
| 7 | Verify these are installed. If any are missing, tell the user what to install and stop. |
| 8 | |
| 9 | 1. **macOS 15+** — `sw_vers -productVersion` (must be ≥ 15.0) |
| 10 | 2. **Xcode CLI tools** — `xcode-select -p` (if missing: `xcode-select --install`) |
| 11 | 3. **Homebrew** — `which brew` (if missing: direct them to https://brew.sh) |
| 12 | 4. **xcodegen** — `which xcodegen` (if missing: `brew install xcodegen`) |
| 13 | |
| 14 | ### Step 2: Generate Xcode project |
| 15 | |
| 16 | ```bash |
| 17 | xcodegen generate |
| 18 | ``` |
| 19 | |
| 20 | This reads `project.yml` (the source of truth for all Xcode project settings) and generates `Chops.xcodeproj`. Re-run this anytime `project.yml` changes. Never edit the `.xcodeproj` directly. |
| 21 | |
| 22 | ### Step 3: Build and run |
| 23 | |
| 24 | ```bash |
| 25 | xcodebuild -scheme Chops -configuration Debug build |
| 26 | ``` |
| 27 | |
| 28 | Or open in Xcode and hit Cmd+R: |
| 29 | |
| 30 | ```bash |
| 31 | open Chops.xcodeproj |
| 32 | ``` |
| 33 | |
| 34 | ### Step 4: Orient the developer |
| 35 | |
| 36 | Share this architecture overview: |
| 37 | |
| 38 | **Entry point:** `Chops/App/ChopsApp.swift` — sets up SwiftData ModelContainer (Skill + SkillCollection), starts Sparkle updater, injects AppState into environment. |
| 39 | |
| 40 | **State:** `Chops/App/AppState.swift` — `@Observable` singleton holding UI state (selected tool, selected skill, search text, sidebar filter). |
| 41 | |
| 42 | **Models (SwiftData):** |
| 43 | - `Chops/Models/Skill.swift` — a discovered skill file, uniquely identified by resolved symlink path |
| 44 | - `Chops/Models/Collection.swift` — user-created groupings of skills |
| 45 | - `Chops/Models/ToolSource.swift` — enum of supported tools with display names, icons, colors, and filesystem paths |
| 46 | |
| 47 | **Services:** |
| 48 | - `Chops/Services/SkillScanner.swift` — probes tool directories, parses frontmatter, upserts into SwiftData. Deduplicates via resolved symlink paths. |
| 49 | - `Chops/Services/FileWatcher.swift` — FSEvents via DispatchSource, triggers re-scan on file changes |
| 50 | - `Chops/Services/SkillParser.swift` — dispatches to FrontmatterParser (.md) or MDCParser (.mdc) |
| 51 | - `Chops/Services/SearchService.swift` — in-memory full-text search |
| 52 | |
| 53 | **Views:** Three-column NavigationSplitView (Sidebar → List → Detail). Editor wraps NSTextView for native text editing. Cmd+S save via FocusedValues. |
| 54 | |
| 55 | **Key design decisions:** |
| 56 | - No sandbox — the app needs unrestricted filesystem access to read dotfiles across ~/ |
| 57 | - Symlink dedup — same file in multiple tool dirs shows as one skill with multiple tool badges |
| 58 | - No test suite — validate manually by building, running, and observing |
| 59 | |
| 60 | **Scanned tool paths:** |
| 61 | |
| 62 | | Tool | Paths | |
| 63 | |------|-------| |
| 64 | | Claude Code | `~/.claude/skills/`, `~/.agents/skills` | |
| 65 | | Cursor | `~/.cursor/skills/`, `~/.cursor/rules` | |
| 66 | | Windsurf | `~/.codeium/windsurf/memories/`, `~/.windsurf/rules` | |
| 67 | | Codex | `~/.codex` | |
| 68 | | Amp | `~/.config/amp` | |
| 69 | |
| 70 | Copilot and Aider detect project-level skills only (no global paths). |
| 71 | |
| 72 | ## Common tasks to be aware of |
| 73 | |
| 74 | **Add a new tool:** Add a case to `ToolSource` enum in `Chops/Models/ToolSource.swift`. Fill in `displayName`, `iconName`, `color`, `globalPaths`. Update `SkillScanner` if the tool uses a non-standard file layout. |
| 75 | |
| 76 | **Modify parsing:** Frontmatter → `Chops/Utilities/FrontmatterParser.swift`. Cursor .mdc → `Chops/Utilities/MDCParser.swift`. Dispatch logic → `Chops/Services/SkillParser.swift`. |
| 77 | |
| 78 | **Change UI:** Views are in `Chops/Views/` (Sidebar/, Detail/, Settings/, Shared/). Main layout is `Chops/App/ContentView.swift`. |
| 79 | |
| 80 | ## Important Rules |
| 81 | |
| 82 | - `project.yml` is the source of truth for Xcode settings — never edit `.xcodeproj` directly |
| 83 | - Sparkle (auto-updates) is the only external dependency — pulled automatically via SPM |
| 84 | - There is no test suite — always validate changes by building and running the app manually |
| 85 | - The app runs without sandbox — this is intentional and required |
People who liked this also viewed
6 picksType
- lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sSkillsJul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handlingSkillsJul 2026
- lark-whiteboard飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。SkillsJul 2026
- lark-task飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。SkillsJul 2026
- lark-attendance飞书考勤打卡：查询自己的考勤打卡记录SkillsJul 2026
- lark-apps妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要SkillsJul 2026
