search-macos26-docs

Search and inspect local macOS 26 SDK documentation and Swift interfaces, especially SwiftUI, SwiftUICore, and AppKit. Use when Codex needs current macOS 26 APIs, Liquid Glass components, window, scene, menu, toolbar, AppKit bridging, availability, signatures, deprecations, symbol docs, or SDK-only facts and should not rely on memory or public web docs being available.

Aller à l'installation

Dépôt: pproenca/dot-skills
Dernière activité de la source: 5 juillet 2026 à 07:23
Langue détectée de SKILL.md: anglais
Étoiles: 194
Forks: 17

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/pproenca/dot-skills --skill search-macos26-docs

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Explorateur de fichiers

7 fichiers

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’installation

drizzle-nextjs-postgres

Drizzle ORM against PostgreSQL inside a Next.js App Router app. Covers client construction (globalThis singleton across HMR, serverless pool sizing, `prepare:false` behind PgBouncer/Supavisor, driver choice when you need interactive transactions, `server-only`), reads in Server Components under Next.js 16 Cache Components (`use cache` superseding `unstable_cache` and the `revalidate`/`dynamic` segment configs, Suspense boundaries, React `cache()` dedupe), Server Actions (authorization inside the action, `updateTag` vs `revalidateTag`, `after()`), Postgres schema types (timestamptz, identity vs serial, jsonb, numeric-as-string, bigint modes), drizzle-kit migrations (generate vs push, CONCURRENTLY outside the migrator, NOT VALID constraints, rename prompts), transactions and pooled connections, and Postgres query traps (keyset pagination, count cost, driver-dependent `db.execute()` shape, NOT IN nulls, prepared statements). Use when writing or reviewing Drizzle + Postgres code in Next.js.

2026-07-24

relational-data-modeling

Corrects the wrong defaults a model has when designing a relational schema — the DDL decisions an experienced engineer makes differently. Use when creating or reviewing tables, migrations, ER models, or ORM schema definitions. Covers identity and keys (surrogate vs natural, identity vs serial, uuidv7, composite keys that make cross-tenant references impossible), relationships (polymorphic foreign keys the database cannot enforce, referential actions, unindexed FK columns, disjoint subtypes), invariants the engine can prove instead of application code (EXCLUDE, partial unique indexes, CHECK limits, deferrable cycles, NOT VALID), types (timestamptz, exact money, range types, enum vs lookup table), derived and encoded data (generated columns, JSONB as an escape hatch), and time (events vs in-place updates, soft-delete flags that silently disable constraints, temporal keys). NOT for query tuning, index selection for read paths, or connection pooling.

2026-07-23

relational-database-design

Distills a logical relational-database design methodology into rules an agent applies while designing or reviewing a schema. Covers the design sequence (mission → tables → fields → keys → relationships → business rules → views → integrity review), one-subject-per-table decomposition, atomic single-valued fields, candidate/primary/foreign keys, relationship types with deletion rules and participation, the four levels of data integrity, database-vs-application business rules, validation tables, views for derived data, and the flat-file / spreadsheet / RDBMS-driven antipatterns to avoid. The structure is logical and RDBMS-agnostic, and normalized by construction. Use when designing a new relational schema, reviewing or refactoring an existing one, resolving redundant or repeating data, choosing keys, modeling relationships, or deciding where a constraint belongs.

2026-07-23

Tout voir dans ce dépôt

name	search-macos26-docs
description	Search and inspect local macOS 26 SDK documentation and Swift interfaces, especially SwiftUI, SwiftUICore, and AppKit. Use when Codex needs current macOS 26 APIs, Liquid Glass components, window, scene, menu, toolbar, AppKit bridging, availability, signatures, deprecations, symbol docs, or SDK-only facts and should not rely on memory or public web docs being available.

Search macOS 26 Docs

Use the local Xcode macOS SDK as the source of truth for macOS 26 APIs. Prefer this skill before web search when the task asks what is available in the current SDK, how a SwiftUI/AppKit symbol is declared, what availability it has, or whether a macOS 26 API exists.

Quick Start

Build or refresh the cached symbol graphs:

python3 "$HOME/.codex/skills/search-macos26-docs/scripts/build_cache.py"

Search SwiftUI, SwiftUICore, and AppKit symbol docs:

python3 "$HOME/.codex/skills/search-macos26-docs/scripts/search_symbols.py glass button style
python3 "$HOME/.codex/skills/search-macos26-docs/scripts/search_symbols.py window toolbar --macos26
python3 "$HOME/.codex/skills/search-macos26-docs/scripts/search_symbols.py NSHostingScene --module SwiftUI --module AppKit --limit 12

Probe a symbol or concept with exact SDK source snippets attached:

python3 "$HOME/.codex/skills/search-macos26-docs/scripts/probe_symbol.py" ZoomNavigationTransition --module SwiftUI
python3 "$HOME/.codex/skills/search-macos26-docs/scripts/search_symbols.py" MTKView --module MetalKit --verify-interfaces --limit 12

Discover SDK modules before deciding where to search:

python3 "$HOME/.codex/skills/search-macos26-docs/scripts/search_symbols.py" --find-module metal
python3 "$HOME/.codex/skills/search-macos26-docs/scripts/search_symbols.py" --list-modules

The search script auto-builds the default cache on first use. Use --force on build_cache.py when Xcode changes or search results look stale.

Workflow

Resolve the active SDK with xcrun --sdk macosx --show-sdk-path.
Use scripts/search_symbols.py for prose docs, symbol names, declarations, and availability. This reads cached swift-symbolgraph-extract output from the local SDK.
Add --verify-interfaces or use scripts/probe_symbol.py when exact compiler declarations, overloads, underscored symbols, generated attributes, or platform availability matter. Verification searches .swiftinterface, headers, and apinotes and reports source snippets plus diagnostics.
Use --find-module PATTERN or --list-modules to discover candidate SDK modules, then rerun with explicit --module values.
Cite findings as local SDK facts. If a symbol is not found in symbol graphs, check sourceOnlyMatches from --verify-interfaces before concluding it does not exist.

Interface Inspection

Swift interfaces are API surfaces, not full documentation. They are still the best fallback for exact signatures and attributes:

SDK_PATH=$(xcrun --sdk macosx --show-sdk-path)
SWIFTUI="$SDK_PATH/System/Library/Frameworks/SwiftUI.framework/Modules/SwiftUI.swiftmodule/arm64e-apple-macos.swiftinterface"
SWIFTUICORE="$SDK_PATH/System/Library/Frameworks/SwiftUICore.framework/Modules/SwiftUICore.swiftmodule/arm64e-apple-macos.swiftinterface"
APPKIT="$SDK_PATH/System/Library/Frameworks/AppKit.framework/Modules/AppKit.swiftmodule/arm64e-apple-macos.swiftinterface"

rg -n "GlassButtonStyle|WindowResizability|NSHostingScene|toolbar" "$SWIFTUI" "$SWIFTUICORE" "$APPKIT"
sed -n '1200,1235p' "$SWIFTUI"

Use interface grep for:

overload sets and generic constraints
@available, deprecation, and rename messages
internal-adjacent underscored declarations visible in the SDK
declarations missing prose docs in symbol graphs
AppKit declarations that are easier to confirm by exact interface text

Symbol Graph Cache

The cache defaults to:

${CODEX_MACOS26_DOCS_CACHE:-$HOME/.cache/codex/search-macos26-docs}/<sdk-name>/<target>/<module>/

Default modules are SwiftUI, SwiftUICore, and AppKit. Add more modules when needed:

python3 "$HOME/.codex/skills/search-macos26-docs/scripts/build_cache.py --module UniformTypeIdentifiers
python3 "$HOME/.codex/skills/search-macos26-docs/scripts/search_symbols.py pasteboard --module AppKit

Useful options:

build_cache.py --list prints cache location and SDK details without extracting.
build_cache.py --force deletes and rebuilds selected module caches.
search_symbols.py --json emits machine-readable results.
search_symbols.py --verify-interfaces attaches matching .swiftinterface, header, or apinotes snippets and diagnostics to shown results.
probe_symbol.py QUERY ... is shorthand for a verified, non-deduped symbol probe with full docs.
search_symbols.py --find-module PATTERN lists SDK modules with names matching a substring.
search_symbols.py --list-modules lists SDK framework modules visible to the helper.
search_symbols.py --kind "Instance Method" narrows result kind.
search_symbols.py --macos26 filters to symbols introduced in macOS 26 or later.
search_symbols.py --introduced macOS:26 filters by an explicit availability domain and major version.
search_symbols.py --no-doc hides doc snippets for compact output.
search_symbols.py --no-dedupe keeps repeated extension results when every concrete receiver matters.
search_symbols.py --source-limit 8 --source-context-lines 6 adjusts verified source snippets.

Test

Run the end-to-end tests after changing the helper scripts. They use the actual installed SDK and validate symbol graph search, source-only verification, module discovery, and explicit module drill-down:

python3 "$HOME/.codex/skills/search-macos26-docs/tests/test_search_symbols_e2e.py"

Interpretation Rules

Treat symbol graph docs as extracted local Apple SDK metadata, not generated guesses.
Treat .swiftinterface as the compiler-facing declaration source.
Treat headers and apinotes as first-class fallback sources for Objective-C-backed frameworks.
When symbol graphs and verified SDK source disagree, prefer the verified SDK source and report the mismatch.
Do not assume public Apple Developer web pages are complete or current for macOS 26 beta/new SDK APIs.
If symbol graph extraction fails for a module, fall back to rg over framework interfaces under $SDK_PATH/System/Library/Frameworks and $SDK_PATH/System/Library/PrivateFrameworks.
Report the active SDK basename, target triple, and module when precision matters.

search-macos26-docs

Informations de source

Options d'installation

Vérifiez les fichiers source

Plus depuis ce dépôt

Search macOS 26 Docs

Quick Start

Workflow

Interface Inspection

Symbol Graph Cache

Test

Interpretation Rules

Search macOS 26 Docs

Quick Start

Workflow

Interface Inspection

Symbol Graph Cache

Test

Interpretation Rules

Plus depuis ce dépôt