skills

WHEN scraping iOS/macOS App Store data (apps, reviews, ratings, search); NOT for installing or testing apps; retrieves structured JSON data using iTunes/App Store APIs with curl and jq formatting

Comprehensive guide for implementing on-device AI models on iOS using Foundation Models and MLX Swift frameworks. Use WHEN building iOS apps with (1) Local LLM inference, (2) Vision Language Models (VLMs), (3) Text embeddings, (4) Image generation, (5) Tool/function calling, (6) Multi-turn conversations, (7) Custom model integration, or (8) Structured generation.

WHEN building ChatGPT apps using the OpenAI Apps SDK and MCP; create conversational, composable experiences with proper UX, UI, state management, and server patterns.

WHEN building SwiftUI views, managing state, setting up shared services, or making architectural decisions; NOT for UIKit or legacy patterns; provides pure SwiftUI data flow without ViewModels using @State, @Binding, @Observable, and @Environment.

WHEN building design systems or component libraries with Tailwind CSS; covers design tokens, CVA patterns and dark mode.

WHEN building React components/pages/apps; enforces scalable architecture, state management, API layer, performance patterns.

Evidence-based goal achievement framework using Goal, Plan, and System methodology. Use when users want to set goals, create actionable plans, build execution systems, or diagnose why they're struggling to make progress on existing goals. Triggers include requests to "set a goal", "help me achieve", "create a plan", "why am I not making progress", or similar goal-setting and achievement queries.

WHEN users express issues with app behavior, visual appearance, or functionality in the iOS simulator collaborate on fixes with a structured feedback loop.

WHEN writing team updates, progress reports, or stakeholder comms; delivers scannable structure, honest framing, and warm recognition.

WHEN users express dissatisfaction with visual appearance or behavior; use Playwright MCP to capture screenshots and collaborate on UI fixes with a structured feedback loop.

WHEN designing features App Intent-first so Siri/Shortcuts, widgets, and SwiftUI share logic; NOT UI-first; reuse intents across app.

WHEN writing tests in Swift with the Swift Testing framework; NOT XCTest.

WHEN writing git/conventional commits; NOT for PR text; returns concise, why-first commit lines with proper type/scope.

WHEN setting working agreements/TDD rules for this codebase; clarifies boundaries and documentation expectations.

WHEN capturing learnings/gotchas/decisions into CLAUDE.md; NOT trivial changes; guides what to record, where it lives, and format.

WHEN drafting PR descriptions or sizing/splitting work; NOT for commit messages; provides reviewer-first templates and gh pr steps.

WHEN refining or structuring prompts; NOT executing tasks; outputs XML-tagged instructions with roles, tasks, constraints, and examples.

WHEN creating/editing developer docs/tutorials/proposals/reviews; delivers scannable structure, clear payoffs, and strong titles.

WHEN writing TypeScript, defining types/schemas, or building type-safe apps; outputs strict, schema-first, production-ready code.

WHEN authoring CSS/styles/layout for web UI; outputs production-ready, accessible, maintainable CSS.

WHEN testing any front-end UI with DOM Testing Library; behavior-first queries, userEvent flows, async patterns.

WHEN testing React components/hooks/context with React Testing Library; NOT e2e; covers renderHook, providers, forms, and anti-patterns.

WHEN tests are green and you need a refactor plan; NOT for new feature delivery; commit-first safety with prioritized improvements.

WHEN working in TDD Red-Green-Refactor; NOT ad-hoc coding; write tests first, add minimal code to green, then assess refactoring.

WHEN refining UI layout, typography, color, or polish; NOT code implementation; provides concise principles for intentional, legible design.