@thiennc/ios-skills 1.1.0

package/LICENSE

@@ -0,0 +1,133 @@
+Required Notice: Copyright (c) 2026 Thien Ngo (https://github.com/thiennc-tesoglobal)
+Required Notice: Copyright (c) 2025 dpearson2699 (https://github.com/dpearson2699)
+Required Notice: Copyright 2025 Existential Birds, LLC (https://github.com/existential-birds/beagle) — applies to adapted swift-code-review material.
+
+# PolyForm Perimeter License 1.0.0
+
+<https://polyformproject.org/licenses/perimeter/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncompete
+
+Any purpose is a permitted purpose, except for providing to
+others any product that competes with the software.
+
+## Competition
+
+If you use this software to market a product as a substitute
+for the functionality or value of the software, it competes
+with the software. A product may compete regardless how it is
+designed or deployed. For example, a product may compete even
+if it provides its functionality via any kind of interface
+(including services, libraries or plug-ins), even if it is
+ported to a different platforms or programming languages,
+and even if it is provided free of charge.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+A **product** can be a good or service, or a combination
+of them.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

package/README.md

@@ -0,0 +1,160 @@
+# Swift iOS Skills Community
+
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-89-2ea44f)](skills/)
+[![Swift](https://img.shields.io/badge/Swift-6.3-F05138?logo=swift&logoColor=white)](https://swift.org)
+[![Apple platforms](https://img.shields.io/badge/Apple%20Platforms-iOS%20%7C%20iPadOS%20%7C%20macOS-black?logo=apple)](https://developer.apple.com)
+[![Validation](https://github.com/thiennc-tesoglobal/ios-skills/actions/workflows/validate-repository.yml/badge.svg)](https://github.com/thiennc-tesoglobal/ios-skills/actions/workflows/validate-repository.yml)
+[![License](https://img.shields.io/badge/License-PolyForm%20Perimeter-blue)](LICENSE)
+
+A practical collection of **89 Agent Skills** for building complete Swift and Apple-platform applications with AI coding agents.
+
+The collection helps an agent choose the right specialist guidance, organize maintainable source code, implement features, and verify the result with builds, tests, and Simulator evidence. It is a knowledge and delivery layer—not an app template or framework dependency.
+
+> **Tiếng Việt:** Bộ skill giúp AI coding agent phát triển ứng dụng Swift và SwiftUI theo quy trình thực tế, từ tổ chức source code đến build, test và kiểm tra trên Simulator.
+
+## Why this collection
+
+- **Complete delivery:** architecture, implementation, testing, performance, accessibility, security, and App Store readiness.
+- **Focused context:** load one workflow skill and only the specialists required by the task.
+- **Modern Apple development:** current Swift, SwiftUI, concurrency, privacy, SDK, and deployment-target guidance.
+- **Evidence-based results:** prefer real build, test, runtime, and Simulator verification over assumptions.
+
+For an entire app or substantial multi-file feature, start with [`ios-app-workflow`](skills/ios-app-workflow/). For a narrow task, select the matching specialist directly.
+
+```text
+Product request → ios-app-workflow → relevant specialists → implementation → verification
+```
+
+## Install
+
+### Codex and Agent Skills-compatible tools
+
+Choose skills interactively:
+
+```sh
+npx @thiennc/ios-skills
+```
+
+Install the end-to-end workflow:
+
+```sh
+npx @thiennc/ios-skills --skill ios-app-workflow
+```
+
+Install the complete collection only when broad framework coverage is required:
+
+```sh
+npx @thiennc/ios-skills --all
+```
+
+The direct GitHub installer remains available as a fallback:
+
+```sh
+npx skills add thiennc-tesoglobal/ios-skills
+```
+
+Smaller installations provide agents with a cheaper and more precise discovery surface. The repository follows the open [Agent Skills specification](https://agentskills.io).
+
+### Claude Code
+
+Add the marketplace and install a bundle:
+
+```sh
+/plugin marketplace add thiennc-tesoglobal/ios-skills
+/plugin install all-ios-skills@ios-skills
+```
+
+Focused bundles are also available:
+
+```sh
+/plugin install swiftui-skills@ios-skills
+/plugin install swift-core-skills@ios-skills
+/plugin install ios-engineering-skills@ios-skills
+```
+
+### Manual installation
+
+Clone the repository and copy the required folders from [`skills/`](skills/) into the skills directory supported by your agent. Keep each folder intact so its instructions, references, scripts, and evaluations remain together.
+
+## Use
+
+Ask the agent to use a skill explicitly when deterministic routing matters:
+
+```text
+Use $ios-app-workflow to build a polished SwiftUI todo app with SwiftData,
+accessible interactions, tests, and verified Simulator behavior.
+```
+
+Examples of focused routing:
+
+- `swift-concurrency` — actor isolation, `Sendable`, and async code
+- `swiftdata` — models, queries, relationships, and migrations
+- `swiftui-animation` — transitions, springs, and Reduce Motion behavior
+- `swiftui-responsive-layout` — clipping, overlap, safe areas, keyboard, and cross-size adaptation
+- `swift-code-review` — evidence-backed Swift/SwiftUI diff review with concurrency, ownership, errors, and state checks
+- `ios-accessibility` — VoiceOver, Dynamic Type, and accessible interactions
+- `storekit` — purchases and subscriptions
+- `ios-simulator` — build, install, launch, and runtime verification
+
+Installing every skill does not mean every skill should be loaded for every request.
+
+## Bundles
+
+| Bundle | Skills | Coverage |
+|---|---:|---|
+| `all-ios-skills` | 89 | Complete collection |
+| `swiftui-skills` | 11 | SwiftUI UI, responsive layout, navigation, animation, performance, and interop |
+| `swift-core-skills` | 10 | Swift language, architecture, concurrency, data, and testing |
+| `ios-app-framework-skills` | 15 | Widgets, StoreKit, App Intents, maps, media, PDFs, and CarPlay |
+| `ios-data-framework-skills` | 8 | CloudKit, HealthKit, EventKit, Contacts, Wallet, and weather |
+| `ios-ai-ml-skills` | 5 | Foundation Models, Core ML, Vision, language, and speech |
+| `ios-engineering-skills` | 18 | Delivery, code review, networking, accessibility, security, diagnostics, and App Store readiness |
+| `ios-hardware-skills` | 8 | Bluetooth, NFC, motion, PencilKit, RealityKit, and accessories |
+| `ios-platform-skills` | 10 | HomeKit, SharePlay, CallKit, and specialized integrations |
+| `ios-gaming-skills` | 4 | GameKit, SpriteKit, SceneKit, and TabletopKit |
+| `apple-kit-skills` | 39 | Framework-focused Apple Kit subset |
+
+Browse the full catalog in [`skills/`](skills/).
+
+## Repository layout
+
+```text
+ios-skills/
+├── skills/          # Skill instructions, references, scripts, and local evals
+├── evals/           # Published behavior scenarios and assertions
+├── tests/           # Repository and diagnostic-helper tests
+├── .claude-plugin/  # Claude Code marketplace bundles
+├── .tessl-plugin/   # Tessl package metadata
+└── tessl.json
+```
+
+## Quality
+
+Pull requests validate skill metadata, references, evaluation coverage, plugin bundles, repository tests, and clean Agent Skills discovery.
+
+```sh
+python3 .github/scripts/validate_repository.py
+python3 -m unittest discover -s tests -v
+npm ci
+npm test
+npm run pack:check
+npx --yes skills@1.5.23 add . --list
+```
+
+The complete collection currently includes **89 skills**, **284 local evaluation cases**, and **267 published evaluation scenarios**. See [`CHANGELOG.md`](CHANGELOG.md) for notable changes.
+
+## Contributing
+
+Issues and pull requests are welcome. Read [`CONTRIBUTING.md`](CONTRIBUTING.md) for skill structure, evaluation requirements, local checks, and the pull-request checklist.
+
+Use [Issues](https://github.com/thiennc-tesoglobal/ios-skills/issues) for bugs and focused proposals, or [Discussions](https://github.com/thiennc-tesoglobal/ios-skills/discussions) for broader ideas.
+
+## License
+
+This source-available project is distributed under the [PolyForm Perimeter License 1.0.0](LICENSE), which includes a noncompete restriction. Review its terms before redistribution or offering a competing product.
+
+The adapted [`swift-code-review`](skills/swift-code-review/) skill is distributed
+under Apache-2.0 with its upstream attribution and license files; the repository
+license applies to the remaining collection.
+
+Apple frameworks, APIs, documentation, session content, and trademarks belong to Apple Inc. This independent project is not affiliated with, endorsed by, or sponsored by Apple.

package/bin/ios-skills.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { run } from "../lib/cli.mjs";
+
+process.exitCode = run(process.argv.slice(2));

package/lib/cli.mjs

@@ -0,0 +1,69 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const packageMetadata = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+);
+
+export const packageVersion = packageMetadata.version;
+export const repository = "thiennc-tesoglobal/ios-skills";
+export const skillsSource = `https://github.com/${repository}#v${packageVersion}`;
+
+export function installerArguments(args) {
+  return ["add", skillsSource, ...args];
+}
+
+export function helpText() {
+  return `Swift iOS Skills Community ${packageVersion}
+
+Usage:
+  npx @thiennc/ios-skills [options]
+
+Options:
+  -s, --skill <skills>   Install selected skills
+  -a, --agent <agents>   Install for selected agents
+  -g, --global           Install at user level
+  -l, --list             List available skills
+  -y, --yes              Skip confirmation prompts
+      --all              Install every skill for every agent
+  -h, --help             Show this help
+  -v, --version          Show the wrapper version
+
+All installation options are forwarded to skills@${packageMetadata.dependencies.skills}.
+Source: ${skillsSource}`;
+}
+
+export function resolveSkillsCli() {
+  const packagePath = require.resolve("skills/package.json");
+  return join(dirname(packagePath), "bin", "cli.mjs");
+}
+
+export function run(args, options = {}) {
+  const stdout = options.stdout ?? process.stdout;
+  const stderr = options.stderr ?? process.stderr;
+
+  if (args.includes("--help") || args.includes("-h")) {
+    stdout.write(`${helpText()}\n`);
+    return 0;
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    stdout.write(`${packageVersion}\n`);
+    return 0;
+  }
+
+  const spawn = options.spawn ?? spawnSync;
+  const cliPath = options.cliPath ?? resolveSkillsCli();
+  const nodePath = options.nodePath ?? process.execPath;
+  const result = spawn(nodePath, [cliPath, ...installerArguments(args)], {
+    stdio: "inherit",
+  });
+
+  if (result.error) {
+    stderr.write(`Unable to start the skills installer: ${result.error.message}\n`);
+    return 1;
+  }
+  return Number.isInteger(result.status) ? result.status : 1;
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@thiennc/ios-skills",
+  "version": "1.1.0",
+  "description": "Install the Swift iOS Skills Community collection with one command.",
+  "type": "module",
+  "bin": {
+    "ios-skills": "bin/ios-skills.mjs"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test tests/test_npm_cli.mjs",
+    "pack:check": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=22.20.0"
+  },
+  "dependencies": {
+    "skills": "1.5.23"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thiennc-tesoglobal/ios-skills.git"
+  },
+  "homepage": "https://github.com/thiennc-tesoglobal/ios-skills#readme",
+  "bugs": {
+    "url": "https://github.com/thiennc-tesoglobal/ios-skills/issues"
+  },
+  "keywords": [
+    "agent-skills",
+    "apple",
+    "codex",
+    "ios",
+    "swift",
+    "swiftui"
+  ],
+  "license": "SEE LICENSE IN LICENSE"
+}