Skills README

The project's README from github.com/Dimillian/Skills. As one markdown file: README.md.

GitHub Pages

Skills Public

A collection of reusable development skills for Apple platforms, GitHub workflows, refactoring, diff review swarms, bug investigation swarms, code review, React performance work, and skill curation.

Overview

This repository contains focused, self-contained skills that help with recurring engineering tasks such as generating App Store release notes, debugging iOS apps, improving SwiftUI and React code, packaging macOS apps, running multi-agent diff reviews and bug hunts, reviewing and simplifying code changes, orchestrating larger refactors, and auditing what new skills a project actually needs.

Install: place these skill folders under $CODEX_HOME/skills

Skills

This repo currently includes 16 skills:

Skill Folder Description
App Store Changelog app-store-changelog Creates user-facing App Store release notes from git history by collecting changes since the last tag, filtering for user-visible work, and rewriting it into concise "What's New" bullets.
GitHub github Uses the gh CLI to inspect and operate on GitHub issues, pull requests, workflow runs, and API data, including CI checks, run logs, and advanced queries.
iOS Debugger Agent ios-debugger-agent Uses XcodeBuildMCP to build, launch, and debug the current iOS app on a booted simulator, including UI inspection, interaction, screenshots, and log capture.
macOS Menubar Tuist App macos-menubar-tuist-app Builds, refactors, or reviews macOS menubar apps that use Tuist and SwiftUI, with emphasis on manifest ownership, store-layer architecture, and reliable local launch scripts.
macOS SwiftPM App Packaging (No Xcode) macos-spm-app-packaging Scaffolds, builds, packages, signs, and optionally notarizes SwiftPM-based macOS apps without requiring an Xcode project.
Orchestrate Batch Refactor orchestrate-batch-refactor Plans and executes larger refactor or rewrite efforts with dependency-aware parallel analysis and implementation using clearly scoped work packets.
Project Skill Audit project-skill-audit Analyzes a project's past Codex sessions, memory, existing local skills, and conventions to recommend the highest-value new skills or updates to existing ones.
React Component Performance react-component-performance Diagnoses slow React components by finding re-render churn, expensive render work, unstable props, and list bottlenecks, then suggests targeted optimizations and validation steps.
Bug Hunt Swarm bug-hunt-swarm Runs a read-only four-agent bug investigation focused on reproduction, code-path tracing, regressors, and the fastest proof step, then returns a ranked root-cause path.
Review and Simplify Changes review-and-simplify-changes Reviews a git diff or explicit file scope for reuse, code quality, efficiency, clarity, and standards issues, then optionally applies safe, behavior-preserving fixes.
Review Swarm review-swarm Runs a read-only four-agent diff review focused on behavioral regressions, security risks, performance or reliability issues, and contract or test coverage gaps, then returns a prioritized fix path.
Swift Concurrency Expert swift-concurrency-expert Reviews and fixes Swift 6.2+ concurrency issues such as actor isolation problems, Sendable violations, main-actor annotations, and data-race diagnostics.
SwiftUI Liquid Glass swiftui-liquid-glass Implements, reviews, or refactors SwiftUI features to use the iOS 26+ Liquid Glass APIs correctly, with proper modifier ordering, grouping, interactivity, and fallbacks.
SwiftUI Performance Audit swiftui-performance-audit Audits SwiftUI runtime performance from code and architecture, focusing on invalidation storms, identity churn, layout thrash, heavy render work, and profiling guidance.
SwiftUI UI Patterns swiftui-ui-patterns Provides best practices and example-driven guidance for building SwiftUI screens and components, including navigation, sheets, app wiring, async state, and reusable UI patterns.
SwiftUI View Refactor swiftui-view-refactor Refactors SwiftUI view files toward smaller subviews, MV-style data flow, stable view trees, explicit dependency injection, and correct Observation usage.

Usage

Each skill is self-contained. Refer to the SKILL.md file in each skill directory for triggers, workflow guidance, examples, and supporting references.

Contributing

Skills are designed to be focused and reusable. When adding new skills, ensure they:

Skills (Dimillian/Skills)

Searching Database…

4K ·GitHub
Skills
What is this?This is a collection of 16 reusable Codex Skills for Apple-platform engineering: SwiftUI/Xcode code review, refactoring, debugging, performance audits, GitHub workflow automation, and multi-agent review and bug-hunt swarms.
Is this an app, or something Codex reads?It is not something you run directly — each skill is a self-contained folder with a SKILL.md file that the Codex agent reads to know how to perform that specific task, like a plugin pack for an AI coding agent.
How do I add these skills to Codex?Copy or clone the skill folders you want into your $CODEXHOME/skills directory; Codex then picks them up automatically.
Do all the skills need the same tools?No, each skill has its own tooling requirement: the GitHub skill needs the gh CLI, the iOS Debugger Agent needs XcodeBuildMCP and a booted simulator, and the macOS Menubar app skill expects a Tuist-based project.
Will these skills work on any codebase?Most of them are built for Apple-platform projects specifically — SwiftUI, Xcode, Tuist, Swift 6.2+ concurrency — so they're of little use outside iOS/macOS development, with the GitHub and refactor-orchestration skills being more general-purpose.
Who is this aimed at?iOS/macOS developers using Codex who want ready-made skills for App Store release notes, SwiftUI performance, Xcode-free packaging, and automated code/diff review.
What do the Review Swarm and Bug Hunt Swarm skills actually do?They each spin up a four-agent, read-only investigation: Review Swarm checks a diff for behavioral regressions, security and performance risks, and test gaps; Bug Hunt Swarm traces a bug through reproduction and code paths to return a ranked root-cause path.
What does the Project Skill Audit skill do?It analyzes a project's past Codex sessions, memory, existing local skills, and conventions to recommend the highest-value new skills to add or existing ones to update.
Is there a skill for making macOS apps without Xcode?Yes, the macOS SwiftPM App Packaging skill scaffolds, builds, packages, signs, and optionally notarizes SwiftPM-based macOS apps without an Xcode project.
What are similar projects?SwiftUI-Agent-Skill, SwiftUI-Agent-Skill, superpowers-zh, Coding-Agent-Skills, reclaim-code-entropy, pstack-claude, pstack, open-swe
Which topics is it in?refactoring, xcode, concurrency, code-review, ai-coding, debugging, apple, github, skill, swift, shell, multi-agent
Creator
Dimillian
Size
0.2 MB
Stars
4K
Updated
CommitMar 29
Age
9mo
Commits · 90 Days