convez.ai
SkillDevOps & InfraestruturaAvançado
cassiewallace

Dotfiles iOS com Skills para Claude Code

cassiewallace/dotfiles

Dotfiles iOS prontos para agentes de IA com skills de Swift e acessibilidade

Ver no GitHub
InicialPluginScore · de 0 a 100

Configuraçã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/dotfiles

1 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

Estrelas
1
Forks
0
Acompanhando
1
Saúde
28%
Último commit
há 1 dia
Versão
—
Issues abertas
0
Contribuidores
1

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/: .zshrc and .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: blocks xcodebuild, 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 the npx skills add command 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.

SkillWhat it doesSource
airbnb-swift-style (mine)enforces the Airbnb Swift style guidecassiewallace/Airbnb-Swift-Style-Agent-Skill
swift-concurrencyasync/await, actors, Sendable, Swift 6 strict-concurrency migrationavdlee/swift-concurrency-agent-skill
swift-testing-expertSwift Testing (@Test, #expect, traits, parameterization), XCTest migrationavdlee/swift-testing-agent-skill
swiftui-expert-skillSwiftUI state, layout, animation, Instruments trace analysisavdlee/swiftui-agent-skill
ios-accessibilityVoiceOver, Dynamic Type, traits, focus order; iOS-wide auditdadederk/iOS-Accessibility-Agent-Skill
uikit-accessibility-auditorUIKit-specific accessibility auditsrgmez/apple-accessibility-skills
swiftui-accessibility-auditorSwiftUI-specific accessibility auditsrgmez/apple-accessibility-skills
appkit-accessibility-auditormacOS / AppKit accessibility auditsrgmez/apple-accessibility-skills
find-skillsdiscover and install new skills from skills.shvercel-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/), and claude/.claude/hooks/flowdeck/flowdeck-guard.sh in this repo blocks agents from falling back to the raw Apple CLIs.
  • RocketSim: iOS Simulator companion app whose rocketsim CLI 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.

Ver o original no GitHub

Bom para

Relacionados