package-collection

Ship one or more iOS/macOS App Store apps from a single repo through development → main → TestFlight, then promote to the App Store by tagging a release candidate (v<version>-rc.<k>) on main and merging that tag into a release branch. Handles repos that ship several apps at once (e.g. an iOS app + a macOS app, each its own App Store Connect record/scheme). Orchestrates the development→main PR cycle (which auto-ships to TestFlight via Xcode Cloud), then the RC-tag → release promotion that uploads to App Store Connect, then submission. Xcode Cloud only builds/archives/uploads; GitHub CI owns all test gating. Use when asked to ship, release, cut a release candidate, promote to the App Store, run release QA, or push iOS/macOS apps to TestFlight or the App Store.

Ship and release Swift library versions by bumping the version on development, merging the PR once CI passes, then tagging and creating a GitHub release from main. Accepts an optional version-bump argument (`patch`/`minor`/`major`) or explicit semver (`1.2.3`) to run unattended.

Audit a Swift test suite across five dimensions and produce a single markdown findings report with concrete recommendations. Run multiple passes that each look at the test suite from a different angle — repetition, superfluity, coverage gaps (using real xccov data), flaky-in-CI risk, and CI gating of performance tests. Use this skill whenever the user asks to audit, analyze, review, critique, or clean up their tests, including phrases like "test analysis", "audit my tests", "review the test suite", "are there redundant tests", "find flaky tests", "test coverage gaps", "which tests can I delete", "are my tests good", or whenever they want a holistic read on Swift test-suite health. Triggers on Swift Package Manager / Xcode projects with XCTest or swift-testing test targets. Defer to Makefile targets when present; never run `swift test` or `swift build`.

Generate or refresh a graphify knowledge-graph codemap of the current repo, gitignore the machine-specific/regenerable pieces, and commit only the portable map artifacts. Use whenever the user wants to build, update, refresh, regenerate, sync, or commit the codemap / graphify map / code graph for a project — phrases like 'update the codemap', 'refresh the graphify map', 'rebuild the code graph', 'commit the codemap', 'regenerate graphify-out', 'sync the codemap before I push', or any variation of keeping a checked-in graphify-out/ map current. Handles first-time generation and incremental updates, enforces the correct .gitignore split (absolute-path markers + cache + manifest.json stay out; graph.json/html/report stay in), untracks anything now-ignored, ensures AGENTS.md references the codemap, and makes one clean commit. Optionally pushes.

Finalize the pull request for the current branch — find the existing (usually draft) PR, regenerate its title and body from the branch's commits, fix the base branch if it's wrong, and mark it ready for review. Falls back to creating a new PR only when none exists. Use this skill whenever the user asks to "create a PR", "open a PR", "make a pull request", "PR this", "send it up", "mark it ready", "ready for review", "finalize the PR", or any variation that implies promoting the current branch into review — including casual phrasings like "now PR it" or "go ahead and ship the PR". The skill picks the base branch using the project's tiered convention (mission/* → development, development → main, everything else → development), enforces standard safety checks (clean working tree, not on main, push first), and writes a Summary + Test plan body from the commits on the branch. Prefer this skill over running `gh pr create` / `gh pr ready` directly so the routing and safety rules apply consistently.

Plan and execute sorties with sergeant precision. Give each agent ONE clear, measurable goal. Pre-execution commands (breakdown, refine + 4 subcommands) create and refine an EXECUTION_PLAN.md from requirements. Refine performs 4 passes: atomicity/testability, prioritization, parallelism (up to 4 sub-agents, builds only by supervisor), and open questions. Execution commands (start, resume, status, stop, killall) orchestrate sortie agents with lean context and crystal-clear objectives. THE RITUAL (name-feature) generates humorous military operation names. Post-mission flow runs automatically after the last sortie completes: (test-cleanup) prunes tests added during the mission that cannot run reliably in CI, then (brief) harvests lessons and renders an explicit ROLLBACK | KEEP | PARTIAL_SALVAGE verdict, then auto-triggers (clean) → /organize-agent-docs to archive every mission artifact in the project root into docs/<complete|incomplete>/<mission name>/.

Gold-standard markdown organization for any repository. Sorts every markdown file into one of three buckets — FOUNDATIONAL (AGENTS.md/CLAUDE.md/GEMINI.md/README.md/CHANGELOG.md/LICENSE at root), MISSION (mission-supervisor artifacts; lifecycle tracked via frontmatter `state:` and routed to root, docs/complete/, or docs/incomplete/), or EXTRANEOUS (everything else → docs/). Maintains links in FOUNDATIONAL files after moves and stamps an `updated:` date when content changes. Use when the user asks to "organize agent docs", "clean up markdown", "tidy the repo", "archive mission files", "separate agent instructions", "restructure AGENTS.md", "sort docs", or whenever a project's markdown files are mixed between root and docs/. This skill is the single owner of repo-level markdown moves; mission-supervisor delegates its `clean` step here.

Audits and automatically fixes Swift Package Manager library packages. Removes Package.resolved from git tracking, ensures the sibling dependency pattern is in place via /toggle-sibling-libraries, and bumps every intrusive-memory/* dep to its latest published release. Explicitly invoked only — does not auto-trigger.

Toggle a Swift Package.swift between the local-sibling-checkout development pattern and a clean remote-only release pattern. Use this skill whenever you need to flip Package.swift in or out of the `sibling(...)` helper-function pattern — for example, before tagging a release the dependencies must be pinned to remote-only, and on a fresh `-dev` development cycle they must go back to sibling-aware. Also trigger on phrases like "switch to remote deps", "remove the sibling helper", "restore sibling pattern", "make Package.swift release-ready", "flip to dev-mode deps", or any time the user references the `sibling()` helper or the `useLocalSiblings` constant. Only intrusive-memory/* dependencies participate in the sibling pattern; all other dependencies are left untouched.

Generate podcast episode audio from Fountain or Highland screenplays using Produciesta CLI, wrap with intro/outro, and open in QuickTime Player. Use this skill whenever the user asks to "generate audio", "make audio", "produce episode audio", "create the audio", "generate episode", "render the episode", or any variation of turning a screenplay file into playable podcast audio. Also trigger when the user says "let's hear it", "play the episode", or references audio generation for any podcast-* project. Works across all intrusive-memory.productions podcasts (confessions, mr-mr-charles, casting-software-spells, daily-dao, meditations, etc.).

Fan out any skill across every library in a JSON package collection file (or a named subset) in dependency order — low-level libraries first, siblings at the same dep level run in parallel. Scope is limited to JSON collection files like `collection.json`; other formats are not supported. Use this skill whenever the user asks to apply a per-library operation to multiple packages in the collection, including phrasings like "ship all the libraries", "run ship-swift-library on everything", "iterate /foo across the collection", "batch <skill> over all packages", "update every library", "for each package in the collection", "fan out X to the libraries", or "do X on all the libraries". Also trigger when the user names a skill and multiple libraries in the same sentence, or references "the collection" / "all packages" as the target of a per-library action.

Update collection.json with the latest published GitHub releases for tracked Swift packages. Use this skill whenever the user asks to refresh, update, sync, or regenerate the package collection, add or remove a package from the collection, check which packages are out of date, preview pending changes, refresh cross-package dependency information, or verify that every tracked repo has a valid release. Releases are the only source of truth — never falls back to tags. Sub-commands include update, update-deps, list, diff, verify, add-package, and remove-package.

Generate audio and transcripts for podcast episodes from Fountain screenplays using Produciesta CLI. When asked to "generate podcast audio", "create audio plan", "cast voices", "prepare transcripts", or working with podcast projects that have episodes/*.fountain files, this skill analyzes characters, assigns voices, writes PROJECT.md cast list, generates audio, and prepares transcripts for web deployment.