Agent skill

Swiftdata Architecture

by KartikLabhshetwar in KartikLabhshetwar/better-shot

Deep dive into SwiftData design patterns and best practices.

Custom licenceAuto-check passedDevelopment

Install Swiftdata Architecture

skills CLI
$ npx skills add KartikLabhshetwar/better-shot --skill swiftdata-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install KartikLabhshetwar/better-shot swiftdata-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/KartikLabhshetwar/better-shot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/macos-development/swiftdata-architecture .claude/skills/swiftdata-architecture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
swiftdata-architecture
GitHub stars
2.4k
Used in
2 other repos
Token cost
~1.2k tokens
SKILL.md length
397 words
Files
5
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

Deep dive into SwiftData design patterns and best practices.

  • Works in 6 steps: Missing Unique Constraints → Fetching Too Much Data → Modifying Models on Wrong Context → …
  • Designing data models
  • SKILL.md covers Your Role, Core Focus Areas, When This Skill Activates and Quick Decision Guide, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Swiftdata Architecture is an agent skill from KartikLabhshetwar/better-shot. Deep dive into SwiftData design patterns and best practices. Covers schema design, query patterns, repository pattern, and performance optimization. Use when designing data models or improving SwiftData usage.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `performance.md`, `query-patterns.md` and `repository-pattern.md`).

It sits in Development, covering Design patterns, Database schema design and Performance optimization. It works with macOS and SwiftUI. The repository describes itself as: Screenshot, screen recording, and video editor for macOS. Native SwiftUI app with capture deck, 75+ customizable shortcuts, URL scheme automation, and self-hosted cloud sharing…

When your agent uses it

  • Designing data models
  • Improving SwiftData usage

Example prompts

  • “/swiftdata-architecture”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Missing Unique Constraints
  2. Fetching Too Much Data
  3. Modifying Models on Wrong Context
  4. Understand the Data Model
  5. Review Against Module Guidelines
  6. Provide Structured Feedback

What it can do on your machine

Read from SKILL.md and the folder at commit 7242211. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are swift).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Swiftdata Architecture loads about 1.2k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 397 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 397 words (~1,195 tokens).

“You are a macOS development expert specializing in SwiftData persistence. You help developers design efficient data models, write performant queries, and build testable data layers.”

— opening of SKILL.md by KartikLabhshetwar, Custom licence
name
swiftdata-architecture
allowed-tools
Read, Glob, Grep
last_verified
2026-07-16
review_by
2027-06-22
os_version
iOS 27 / macOS 27

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files in .agents/skills/macos-development/swiftdata-architecture of KartikLabhshetwar/better-shot.

  • SKILL.md
  • performance.md
  • query-patterns.md
  • repository-pattern.md
  • schema-design.md

Open the folder on GitHubat commit 7242211

Used in 2 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in KartikLabhshetwar/better-shot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Swiftdata Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Swiftdata Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Swiftdata Architecture this skillKartikLabhshetwar/better-shot2.4k2 repos~1.2kAutomated safety check: PassCustom licence
Swift ExpertJeffallan/claude-skills12k—~1.5kAutomated safety check: PassMIT
Cmux Debugging Guidemanaflow-ai/cmux28k1 repos~1.1kAutomated safety check: PassCustom licence
Pulse Releasequnqin24/Pulse517—~1.3kAutomated safety check: PassApache-2.0
Prepare PRchattymin/PokeTokenBar508—~1.8kAutomated safety check: PassMIT
Releasef-is-h/Usage4Claude407—~1.9kAutomated safety check: PassMIT

Similar skills

  • Swift Expert

    Jeffallan/claude-skills

    Builds Swift apps for Apple platforms with SwiftUI, protocol-oriented design, async/await, actors and Sendable checks, verified with swift build and swift test.

    12k GitHub stars~1.5k tokensUpdated 5 days ago
    MobileAuto-check passed
  • Cmux Debugging Guide

    manaflow-ai/cmux

    Covers debug logging, the Debug menu, profiling rules and runtime pitfalls for working on the cmux macOS terminal app.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Pulse Release

    qunqin24/Pulse

    Release a new Pulse version end to end — checks, bilingual CHANGELOG entry, VERSION, tag, the release workflow, syncing main, and the issue replies that go with it.

    517 GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Prepare PR

    chattymin/PokeTokenBar

    Prepare, create, or update a PokeTokenBar pull request with an English Conventional Commits title, the repository PR template, and mandatory images for visible UI changes.

    508 GitHub stars~1.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release

    f-is-h/Usage4Claude

    发布 Usage4Claude 新版本时使用。当用户说“发布新版本 / 发版 / 出新版 / release / 打 tag 发布 / 准备发版材料”等,用本 skill 引导完成从收集变更、编写 CHANGELOG 与 RELEASENOTES、更新版本号、编译验证,到发版 commit、CI 自动发布的完整流程。

    407 GitHub stars~1.9k tokensUpdated 10 days ago
    DevelopmentAuto-check passed
  • Native App Performance

    harperreed/dotfiles

    Native macOS/iOS app performance profiling via xctrace/Time Profiler and CLI-only analysis of Instruments traces.

    334 GitHub starsUsed in 4 repos~538 tokens
    DevelopmentAuto-check passed

More from KartikLabhshetwar/better-shot

All 12 skills in this repo
  • Appkit Swiftui Bridge

    KartikLabhshetwar/better-shot

    Expert guidance for hybrid AppKit-SwiftUI development. An agent skill from KartikLabhshetwar/better-shot.

    2.4k GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • Ip As Logo

    KartikLabhshetwar/better-shot

    Generate extremely simple, cute, personified square character images with rounded heavy forms, two purposeful character colors, one solid background color, and a dominant lower-corner composition.

    2.4k GitHub starsUsed in 1 repo~4.3k tokens
    Auto-check passed
  • Architecture Patterns

    KartikLabhshetwar/better-shot

    Deep dive into software architecture for macOS. An agent skill from KartikLabhshetwar/better-shot.

    2.4k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • Coding Best Practices

    KartikLabhshetwar/better-shot

    Reviews macOS Swift 6+ code for modern idioms, SOLID principles, SwiftData patterns, and concurrency best practices.

    2.4k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • macOS Capabilities

    KartikLabhshetwar/better-shot

    Expert guidance on macOS platform capabilities. An agent skill from KartikLabhshetwar/better-shot.

    2.4k GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • macOS Development

    KartikLabhshetwar/better-shot

    Comprehensive macOS development guidance including Swift 6+, SwiftUI, SwiftData, architecture patterns, AppKit bridging, and macOS 26 Tahoe APIs.

    2.4k GitHub starsUsed in 2 repos~735 tokens
    Auto-check passed

Works with

Questions about Swiftdata Architecture

What does Swiftdata Architecture do?

Deep dive into SwiftData design patterns and best practices. Swiftdata Architecture is an agent skill from KartikLabhshetwar/better-shot. Deep dive into SwiftData design patterns and best practices.

When should I use Swiftdata Architecture?

Swiftdata Architecture fits situations like: designing data models; improving SwiftData usage.

How do I install Swiftdata Architecture in Claude Code?

Run `npx skills add KartikLabhshetwar/better-shot --skill swiftdata-architecture -a claude-code`. Or copy the skill folder (.agents/skills/macos-development/swiftdata-architecture in KartikLabhshetwar/better-shot) into .claude/skills/swiftdata-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Swiftdata Architecture in Codex?

Run `npx skills add KartikLabhshetwar/better-shot --skill swiftdata-architecture -a codex`. Or copy the skill folder (.agents/skills/macos-development/swiftdata-architecture in KartikLabhshetwar/better-shot) into .agents/skills/swiftdata-architecture in your project. Codex loads it when a task matches its description.

Can I use Swiftdata Architecture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add KartikLabhshetwar/better-shot --skill swiftdata-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/swiftdata-architecture, .gemini/skills/swiftdata-architecture, .github/skills/swiftdata-architecture and .opencode/skills/swiftdata-architecture in your project.

What does Swiftdata Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Swiftdata Architecture is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Glob, Grep.

Does Swiftdata Architecture access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Swiftdata Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Swiftdata Architecture use?

Swiftdata Architecture has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Swiftdata Architecture use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Swiftdata Architecture?

Skills that share tags, products or a category with Swiftdata Architecture: Swift Expert (Jeffallan/claude-skills, 12k stars), Cmux Debugging Guide (manaflow-ai/cmux, 28k stars), Pulse Release (qunqin24/Pulse, 517 stars) and Prepare PR (chattymin/PokeTokenBar, 508 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Swiftdata Architecture?

KartikLabhshetwar (a GitHub user) maintains it in KartikLabhshetwar/better-shot, which has 2,370 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

Source: KartikLabhshetwar/better-shot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.