Agent skill · software engineering · aradotso
capso-screenshot-macos
Expert skill for Capso, the open-source macOS screenshot and screen recording app built with Swift 6 and SwiftUI — covers architecture, building from source, package APIs, and contributing.
Why this skill is useful
Provides specific guidance on integrating Capso's modular packages into Swift projects, which the AI wouldn't reliably generate on its own.
What it needs
Requires brew, xcodegen installed locally. About 6k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Capso Screenshot & Screen Recording Skill Skill by ara.so — Daily 2026 Skills collection. Capso is a fully native, open-source macOS screenshot and screen recording app — a free alternative to CleanShot X. Built with Swift 6.0 and SwiftUI targeting macOS 15.0+. Its key strength for developers is a modular SPM architecture: 8 independent packages (CaptureKit, AnnotationKit, OCRKit, etc.) you can embed individually in your own app. --- Installation Download Pre-built App Or download the signed DMG from GitHub Releases. Build from Source Requirements: Xcode 16+, macOS 15.0+, XcodeGen CLI build: --- Project Architecture The app shell is intentionally thin — all logic lives in packages. This means you can pull individual packages into your own app via SPM. --- Using Capso Packages in Your Own App Add a package as a local or remote SPM dependency in your Package.swift: --- Package API Examples CaptureKit — Screen Capture CaptureKit wraps ScreenCaptureKit for area, fullscreen, and window capture. RecordingKit — Screen Recording CameraKit — Webcam PiP AnnotationKit — Drawing & Annotation Screenshot Beautification (AnnotationKit) OCRKit — Text Recognition ExportKit — Video & GIF Export SharedKit — Permissions & Settings --- SwiftUI Integration Pattern Embed a capture button in a SwiftUI view: --- Running Package Tests Each package is independently testable: --- Required Entitlements & Info.plist Your app using Capso packages needs these permissions: --- Common Patterns Pin Screenshot to Screen (Always-on-Top) Global Keyboard Shortcut (via SharedKit pattern) --- Troubleshooting xcodegen generate fails Ensure XcodeGen ≥ 2.40: brew upgrade xcodegen Check project.yml is not modified with invalid YAML syntax Run xcodegen generate --spec project.yml for explicit path "Screen Recording permission denied" at runtime Go to System Settings → Privacy & Security → Screen Recording and enable Capso For your own app using CaptureKit, you must trigger the permission prompt first via Permis …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/capso-screenshot-macos