mirror of
https://github.com/Dimillian/Skills.git
synced 2026-04-26 14:47:48 +00:00
26e23c058d
Replaces hardcoded skills in docs/app.js with dynamic loading from a generated docs/skills.json. Adds scripts/build_docs_index.py to generate the index from SKILL.md files, and a pre-commit hook to keep the index in sync. Updates README with setup instructions for the pre-commit hook.
143 lines
5.8 KiB
Markdown
143 lines
5.8 KiB
Markdown
[](https://dimillian.github.io/Skills/)
|
|
|
|
# Skills Public
|
|
|
|
A collection of specialized skills for iOS and Swift development workflows.
|
|
|
|
## Overview
|
|
|
|
This repository contains a set of focused skills designed to assist with common iOS development tasks, from generating release notes to debugging apps and maintaining code quality.
|
|
|
|
Install: place these skill folders under `$CODEX_HOME/skills/public` (or symlink this repo there).
|
|
|
|
Optional: enable the pre-commit hook to keep `docs/skills.json` in sync:
|
|
`git config core.hooksPath scripts/git-hooks`
|
|
|
|
## Skills
|
|
|
|
### 📝 App Store Changelog
|
|
|
|
**Purpose**: Generate user-facing App Store release notes from git history.
|
|
|
|
Automatically collects commits and changes since the last git tag (or a specified ref) and transforms them into clear, benefit-focused release notes suitable for the App Store. Filters out internal-only changes and groups user-visible improvements by theme.
|
|
|
|
**Key Features**:
|
|
- Collects commits and touched files since the last tag
|
|
- Identifies user-visible changes vs internal work
|
|
- Generates concise, benefit-focused bullet points
|
|
- Validates changes map back to actual commits
|
|
|
|
**Use When**: You need to create App Store "What's New" text or release notes based on git history.
|
|
|
|
---
|
|
|
|
### 🐛 iOS Debugger Agent
|
|
|
|
**Purpose**: Build, run, and debug iOS projects on simulators using XcodeBuildMCP.
|
|
|
|
Provides a comprehensive workflow for building iOS apps, launching them on simulators, interacting with the UI, and capturing logs. Handles simulator discovery, session setup, and runtime debugging.
|
|
|
|
**Key Features**:
|
|
- Discovers and manages booted simulators
|
|
- Builds and runs apps on simulators
|
|
- Interacts with UI (tap, type, swipe, gestures)
|
|
- Captures and analyzes app logs
|
|
- Screenshots and UI inspection
|
|
|
|
**Use When**: You need to run an iOS app, interact with the simulator UI, inspect on-screen state, or diagnose runtime behavior.
|
|
|
|
---
|
|
|
|
### 🧭 GH Issue Fix Flow
|
|
|
|
**Purpose**: Resolve GitHub issues end-to-end using `gh`, local edits, builds/tests, and git push.
|
|
|
|
Provides a structured flow for reading issues, implementing fixes, validating with XcodeBuildMCP, and shipping changes with a closing commit.
|
|
|
|
**Key Features**:
|
|
- Fetches full issue context with `gh issue view`
|
|
- Guides code discovery and focused edits
|
|
- Runs targeted builds/tests via XcodeBuildMCP
|
|
- Commits with closing message and pushes
|
|
|
|
**Use When**: You need to take an issue number, inspect it with `gh`, implement a fix, run tests, and push.
|
|
|
|
---
|
|
|
|
### ⚡ Swift Concurrency Expert
|
|
|
|
**Purpose**: Review and fix Swift Concurrency issues for Swift 6.2+ codebases.
|
|
|
|
Applies actor isolation, Sendable safety, and modern concurrency patterns to resolve compiler errors and improve concurrency compliance. Focuses on minimal behavior changes while ensuring data-race safety.
|
|
|
|
**Key Features**:
|
|
- Identifies actor context and isolation issues
|
|
- Applies safe fixes preserving existing behavior
|
|
- Handles UI-bound types, protocols, and background work
|
|
- Ensures Sendable compliance
|
|
|
|
**Use When**: You need to review Swift Concurrency usage, improve concurrency compliance, or fix Swift concurrency compiler errors.
|
|
|
|
---
|
|
|
|
### 💎 SwiftUI Liquid Glass
|
|
|
|
**Purpose**: Implement and review SwiftUI features using iOS 26+ Liquid Glass API.
|
|
|
|
Helps adopt the native Liquid Glass API in SwiftUI interfaces, ensuring correct usage, performance, and design alignment. Supports both new implementations and refactoring existing features.
|
|
|
|
**Key Features**:
|
|
- Uses native `glassEffect` and `GlassEffectContainer` APIs
|
|
- Ensures proper modifier ordering and composition
|
|
- Handles iOS 26+ availability with fallbacks
|
|
- Implements interactive glass for tappable elements
|
|
- Supports morphing transitions
|
|
|
|
**Use When**: You need to adopt Liquid Glass in new SwiftUI UI, refactor existing features to Liquid Glass, or review Liquid Glass usage for correctness.
|
|
|
|
---
|
|
|
|
### 🔧 SwiftUI View Refactor
|
|
|
|
**Purpose**: Refactor SwiftUI view files for consistent structure and dependency patterns.
|
|
|
|
Applies standardized ordering, Model-View (MV) patterns, and correct Observation usage to SwiftUI views. Focuses on making views lightweight, composable, and maintainable.
|
|
|
|
**Key Features**:
|
|
- Enforces consistent view ordering (Environment → State → init → body → helpers)
|
|
- Promotes MV patterns over view models when possible
|
|
- Handles view models safely (non-optional when possible)
|
|
- Ensures correct `@Observable` and `@State` usage
|
|
- Supports dependency injection via `@Environment`
|
|
|
|
**Use When**: You need to clean up a SwiftUI view's structure, handle view models safely, or standardize dependency injection and Observation usage.
|
|
|
|
---
|
|
|
|
### 🚀 SwiftUI Performance Audit
|
|
|
|
**Purpose**: Audit and improve SwiftUI runtime performance from code review and architecture.
|
|
|
|
Focuses on identifying common SwiftUI performance pitfalls in view code and data flow, recommending targeted refactors, and guiding user-run Instruments profiling when code review is not enough.
|
|
|
|
**Key Features**:
|
|
- Code-first review for slow rendering, janky scrolling, and excessive updates
|
|
- Targets common SwiftUI pitfalls (unstable identity, heavy `body`, layout thrash)
|
|
- Provides remediation guidance and refactor suggestions
|
|
- Offers a user-run Instruments workflow when needed
|
|
|
|
**Use When**: You need to diagnose SwiftUI performance issues, improve view/update efficiency, or get guidance on profiling with Instruments.
|
|
|
|
---
|
|
|
|
## Usage
|
|
|
|
Each skill is self-contained with its own documentation. Refer to the `SKILL.md` file in each skill's directory for detailed workflows, guidelines, and examples.
|
|
|
|
## Contributing
|
|
|
|
Skills are designed to be focused and reusable. When adding new skills, ensure they:
|
|
- Have a clear, single purpose
|
|
- Include comprehensive documentation
|
|
- Follow consistent patterns with existing skills
|
|
- Include reference materials when applicable
|