Dotfiles iOS com Skills para Claude Code
cassiewallace/dotfiles
Dotfiles iOS prontos para agentes de IA com skills de Swift e acessibilidade
Ver no GitHubConfiguração reproduzível de ambiente macOS para desenvolvimento iOS com agentes de IA, incluindo instruções globais para Claude Code, hooks FlowDeck para ferramentas Apple, e um manifest de agent skills especializadas em Swift, SwiftUI, UIKit e acessibilidade.
Instalação
npx convez-ai cassiewallace/dotfiles1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Configurar ambiente de dev iOS automatizado com Claude Code
- Auditar acessibilidade em apps iOS, UIKit e SwiftUI
- Padronizar código Swift segundo guia Airbnb com agentes
Veredito

Solução madura e bem-estruturada para iOS engineers que trabalham com agentes de IA. Destaca-se pela ênfase em acessibilidade, integração com FlowDeck, e manifest de skills reutilizável; exige experiência com Shell, zsh e ecossistema Anthropic para máximo proveito.
README
A tradução para o português deste README ainda está na fila.
iOS dotfiles
My macOS dotfiles as an iOS engineer working with AI coding agents: shell config, Claude Code setup, and a manifest of agent skills for Swift, SwiftUI, UIKit, and accessibility work.
This repo is the source of truth for my AI-era dev environment: global Claude Code instructions, hooks that keep agents on the rails of Apple-platform tooling (FlowDeck instead of raw xcodebuild/xcrun simctl), and a reproducible list of agent skills covering Swift concurrency, Swift Testing, SwiftUI patterns, iOS/UIKit/AppKit accessibility audits, and the Airbnb Swift style guide.
zsh/:.zshrcand.aliases.claude/.claude/: global config for Claude Code.CLAUDE.md: global instructions covering Swift style, verification rules, PR/commit conventions, and pointers to every agent skill.settings.json: theme, enabled plugins, and the FlowDeck PreToolUse hook.hooks/flowdeck/flowdeck-guard.sh: blocksxcodebuild,xcrun simctl,xcrun devicectl, and friends in favor of FlowDeck, the agent-friendly replacement for Apple's CLI tools.
skills.manifest: every external agent skill I use, with thenpx skills addcommand to re-install it.Brewfile: Homebrew packages (scaffold; add as you go).
Agent skills
These are installed via the npx skills CLI, which is the package manager for the open agent skills ecosystem. skills.sh is the browse/search surface for it; npx skills add owner/repo@skill is the install command. Every entry in skills.manifest resolves through it.
| Skill | What it does | Source |
|---|---|---|
airbnb-swift-style (mine) | enforces the Airbnb Swift style guide | cassiewallace/Airbnb-Swift-Style-Agent-Skill |
swift-concurrency | async/await, actors, Sendable, Swift 6 strict-concurrency migration | avdlee/swift-concurrency-agent-skill |
swift-testing-expert | Swift Testing (@Test, #expect, traits, parameterization), XCTest migration | avdlee/swift-testing-agent-skill |
swiftui-expert-skill | SwiftUI state, layout, animation, Instruments trace analysis | avdlee/swiftui-agent-skill |
ios-accessibility | VoiceOver, Dynamic Type, traits, focus order; iOS-wide audit | dadederk/iOS-Accessibility-Agent-Skill |
uikit-accessibility-auditor | UIKit-specific accessibility audits | rgmez/apple-accessibility-skills |
swiftui-accessibility-auditor | SwiftUI-specific accessibility audits | rgmez/apple-accessibility-skills |
appkit-accessibility-auditor | macOS / AppKit accessibility audits | rgmez/apple-accessibility-skills |
find-skills | discover and install new skills from skills.sh | vercel-labs/skills |
Two CLI tools that I use alongside the skills above are installed separately. Both ship their own Claude Code skill as part of the install:
- FlowDeck: agent-friendly replacement for
xcodebuild,xcrun simctl,xcrun devicectl,instruments, and the rest of Apple's CLI tooling. Returns structured JSON, handles build/run/test/launch/log/screenshot, and drives UI automation on iOS and macOS. The FlowDeck install bundles its own Claude Code skill (at~/.claude/skills/flowdeck/), andclaude/.claude/hooks/flowdeck/flowdeck-guard.shin this repo blocks agents from falling back to the raw Apple CLIs. - RocketSim: iOS Simulator companion app whose
rocketsimCLI exposes accessibility-element snapshots and gesture/keyboard input to agents. Also ships its own Claude Code skill.
Install
git clone git@github.com:<you>/dotfiles.git ~/Developer/personal/dotfiles
cd ~/Developer/personal/dotfiles
./install.sh --dry-run # preview first
./install.sh # symlink files + restore agent skills
./install.sh --brew # also run `brew bundle`
Re-running install.sh on the same machine is a no-op. If it finds an existing real file where a symlink should go, it moves the original to <file>.dotfiles-backup-<timestamp> before linking.
Requirements: macOS, Bash, git. npx (from Node) is required for skill restore; skip it with --skip-skills if Node isn't installed yet.
Adding a new tracked file
Put it at the same relative path inside a package. The tree mirrors $HOME:
zsh/.zshrc -> ~/.zshrc
claude/.claude/settings.json -> ~/.claude/settings.json
claude/.claude/hooks/foo/foo.sh -> ~/.claude/hooks/foo/foo.sh
Then re-run ./install.sh. The installer walks each package as files (not directories), so existing unrelated content in ~/.claude (sessions, plans, etc.) is left alone.
Adding a new agent skill
Append a line to skills.manifest:
<skill-name> | npx skills add <owner>/<repo>@<skill> -g -y
install.sh skips any skill whose ~/.agents/skills/<skill-name>/ directory already exists, so it's safe to re-run after adding a line.