Claude skills: Setapp Framework & Setapp AI+

We maintain a Claude skill that walks an AI coding assistant through integrating the Setapp Framework and Setapp AI+ features into your Xcode project. It's been tested by app developers for several months, and we keep it updated as the SDK and review process change.

If you use Claude Code or another AI coding assistant that reads SKILL.md files, such as Cursor or Codex, this skill can carry most of the integration for you — from adding the SPM dependency to configuring sandbox entitlements and flagging patterns that fail Setapp's review before you submit.


What's in the repository

The repository README is the source of truth for what the skill does and how to install it — we won't duplicate it here. In short, you'll find:

  • Two skills, used in order: setapp-framework for the base integration (Xcode target, entitlements, submission prep), and setapp-ai for Setapp AI+ (OAuth, model discovery, streaming, image/audio/video generation, credit balances).
  • Install instructions for Claude Code (as a plugin or manual copy) and for other assistants that read SKILL.md files directly.
  • A longer walkthrough in docs/setapp-framework-guide.md, and a full list of what the skill can't do for you (steps that require a human in an external system, like registering your bundle ID).

What to expect

A few things worth knowing before you run it, based on feedback from app developers who've integrated with it:

  • It assumes a standard Swift/Xcode project. If your app is built with a different toolchain — for example, a cross-platform app packaged with something other than Xcode — most of the framework steps won't apply, since they target Xcode targets, Info.plist, and Swift APIs directly. In that case, follow the Setapp AI Swift SDK guide manually instead.
  • It catches real, easy-to-miss mistakes like the wrong Mach service name in your sandbox entitlement, or code that silently fails because SetappManager.shared was never referenced anywhere and got dead-stripped by the linker. These are exactly the kind of issues that otherwise surface only after a rejected submission.
  • Sandbox detection isn't guaranteed to catch every case. It's a strong first pass, but double-check your entitlements and sandboxing setup yourself before submitting, especially for less common project structures.
  • The skill evolves with the SDK and review guidelines. If you hit a step that's out of date or doesn't match current docs, that's a useful signal for us — see below.

Give feedback

The repository is public, and changes go through a pull request that we review before merging. If you find a step that's outdated, missing, or doesn't apply to your setup, open a PR or issue against the repository rather than working around it silently — it helps us keep the skill accurate for the next app developer who uses it.


Reference


Did this page help you?