opencodekit 0.16.15 → 0.16.17

package/dist/template/.opencode/skill/augment-context-engine/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: augment-context-engine
+description: Semantic codebase search via Augment Context Engine MCP. Use when you need to understand code relationships, find relevant implementations, or explore unfamiliar codebases beyond keyword matching.
+---
+
+# Augment Context Engine (MCP)
+
+Semantic code search powered by Augment's Context Engine. Unlike grep (text matching), this understands code meaning, relationships, and cross-file dependencies.
+
+## Available Tools
+
+- `augment_code_search` - Semantic search across indexed GitHub repositories
+
+**Parameters:**
+
+- `repo_owner` (string, required) - GitHub org or username (e.g. `"augmentcode"`)
+- `repo_name` (string, required) - Repository name (e.g. `"test-repo"`)
+- `query` (string, required) - Natural language description of what you're looking for
+- `branch` (string, optional) - Branch to search (defaults to `"main"`)
+- `max_results` (integer, optional) - Max code snippets to return (defaults to 5)
+
+## Quick Start
+
+```
+# Search a GitHub repo for authentication code
+skill_mcp(skill_name="augment-context-engine", tool_name="augment_code_search", arguments='{"repo_owner": "myorg", "repo_name": "myapp", "query": "authentication middleware that validates JWT tokens"}')
+
+# Search a specific branch with more results
+skill_mcp(skill_name="augment-context-engine", tool_name="augment_code_search", arguments='{"repo_owner": "myorg", "repo_name": "myapp", "query": "error handling patterns", "branch": "develop", "max_results": 10}')
+```
+
+> **Tip:** Get `repo_owner` and `repo_name` from git: `git remote get-url origin`
+
+## Setup
+
+### 1. Install the Augment GitHub App
+
+Install at [github.com/apps/augmentcode](https://github.com/apps/augmentcode/installations/new) and grant access to the repos you want to index.
+
+### 2. Add the remote server
+
+The skill's `mcp.json` uses `mcp-remote` to bridge the remote API via stdio.
+
+For global access, add to `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "auggie": {
+      "type": "remote",
+      "url": "https://api.augmentcode.com/mcp",
+      "enabled": true
+    }
+  }
+}
+```
+
+### 3. Authenticate
+
+Sign in at [app.augmentcode.com](https://app.augmentcode.com) when prompted by `mcp-remote` on first use.
+
+## Query Tips
+
+Good queries (natural language, conceptual):
+
+- `"function that handles user authentication"`
+- `"database connection setup code"`
+- `"tests for the payment processing module"`
+
+Bad queries (use grep instead):
+
+- `"foo_bar"` — exact symbol search
+- `"TODO"` — keyword search
+- `"code that deals with everything"` — too vague
+
+## When to Use
+
+| Scenario                 | Use This              | Instead Of                 |
+| ------------------------ | --------------------- | -------------------------- |
+| Find code by meaning     | `augment_code_search` | `grep` (text only)         |
+| Understand relationships | `augment_code_search` | `@explore` agent (heavier) |
+| Unfamiliar codebase      | `augment_code_search` | Manual file exploration    |
+| Cross-repo dependencies  | `augment_code_search` | LSP references (narrower)  |
+
+## When NOT to Use
+
+- **Exact string matching** — Use `grep` instead (faster, free)
+- **Known file paths** — Use `read` directly
+- **Symbol definitions** — Use LSP `goToDefinition` (precise)
+- **Local-only work** — This searches GitHub-indexed repos, not local files
+
+## Tool Priority Integration
+
+```
+grep (text) → semantic search (meaning) → read (full file) → LSP (symbols) → edit
+```
+
+Use grep first for exact matches. Escalate to semantic search when grep results are noisy or you need conceptual understanding.
+
+## Cost
+
+- ~40-70 credits per query
+- Not free — use judiciously
+- Prefer grep for simple lookups
+
+## Resources
+
+- Docs: https://docs.augmentcode.com/context-services/mcp/overview
+- OpenCode Quickstart: https://docs.augmentcode.com/context-services/mcp/quickstart-open-code
+- GitHub App: https://github.com/apps/augmentcode/installations/new
+- Product: https://www.augmentcode.com/product/context-engine-mcp

package/dist/template/.opencode/skill/augment-context-engine/mcp.json

@@ -0,0 +1,6 @@
+{
+	"augment-context-engine": {
+		"command": "npx",
+		"args": ["-y", "mcp-remote", "https://api.augmentcode.com/mcp"]
+	}
+}

package/dist/template/.opencode/skill/core-data-expert/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: core-data-expert
+description: 'Expert Core Data guidance (iOS/macOS): stack setup, fetch requests & NSFetchedResultsController, saving/merge conflicts, threading & Swift Concurrency, batch operations & persistent history, migrations, performance, and NSPersistentCloudKitContainer/CloudKit sync.'
+---
+# Core Data Expert
+
+Fast, production-oriented guidance for building **correct**, **performant** Core Data stacks and fixing common crashes.
+
+## Agent behavior contract (follow these rules)
+
+1. Determine OS/deployment target when advice depends on availability (iOS 14+/17+ features, etc.).
+2. Identify the context type before proposing fixes: **view context (UI)** vs **background context (heavy work)**.
+3. Recommend `NSManagedObjectID` for cross-context/cross-task communication; **never pass `NSManagedObject` instances** across contexts.
+4. Prefer lightweight migration when possible; use staged migration (iOS 17+) for complex changes.
+5. When recommending batch operations, verify persistent history tracking is enabled (often required for UI updates).
+6. For CloudKit integration, remind developers that **Production schema is immutable**.
+7. Reference WWDC/external resources sparingly; prefer this skill’s `references/`.
+
+## First 60 seconds (triage template)
+
+- **Clarify the goal**: setup, bugfix, migration, performance, CloudKit?
+- **Collect minimal facts**:
+  - platform + deployment target
+  - store type (SQLite / in-memory) and whether CloudKit is enabled
+  - context involved (view vs background) and whether Swift Concurrency is in use
+  - exact error message + stack trace/logs
+- **Branch immediately**:
+  - threading/crash → focus on context confinement + `NSManagedObjectID` handoff
+  - migration error → identify model versions + migration strategy
+  - batch ops not updating UI → persistent history tracking + merge pipeline
+
+## Routing map (pick the right reference fast)
+
+- **Stack setup / merge policies / contexts** → `references/stack-setup.md`
+- **Saving patterns** → `references/saving.md`
+- **Fetch requests / list updates / aggregates** → `references/fetch-requests.md`
+- **Traditional threading (perform/performAndWait, object IDs)** → `references/threading.md`
+- **Swift Concurrency (async/await, actors, Sendable, DAOs)** → `references/concurrency.md`
+- **Batch insert/delete/update** → `references/batch-operations.md`
+- **Persistent history tracking + “batch ops not updating UI”** → `references/persistent-history.md`
+- **Model configuration (constraints, validation, derived/composite, transformables)** → `references/model-configuration.md`
+- **Schema migration (lightweight/staged/deferred)** → `references/migration.md`
+- **CloudKit integration & debugging** → `references/cloudkit-integration.md`
+- **Performance profiling & memory** → `references/performance.md`
+- **Testing patterns** → `references/testing.md`
+- **Terminology** → `references/glossary.md`
+
+## Common errors → next best move
+
+- **“Failed to find a unique match for an NSEntityDescription”** → `references/testing.md` (shared `NSManagedObjectModel`)
+- **`NSPersistentStoreIncompatibleVersionHashError`** → `references/migration.md` (versioning + migration)
+- **Cross-context/threading exceptions** (e.g. delete/update from wrong context) → `references/threading.md` and/or `references/concurrency.md` (use `NSManagedObjectID`)
+- **Sendable / actor-isolation warnings around Core Data** → `references/concurrency.md` (don’t “paper over” with `@unchecked Sendable`)
+- **`NSMergeConflict` / constraint violations** → `references/model-configuration.md` + `references/stack-setup.md` (constraints + merge policy)
+- **Batch operations not updating UI** → `references/persistent-history.md` + `references/batch-operations.md`
+- **CloudKit schema/sync issues** → `references/cloudkit-integration.md`
+- **Memory grows during fetch** → `references/performance.md` + `references/fetch-requests.md`
+
+## Verification checklist (when changing Core Data code)
+
+- Confirm the context matches the work (UI vs background).
+- Ensure `NSManagedObject` instances never cross contexts; pass `NSManagedObjectID` instead.
+- If using batch ops, confirm persistent history tracking + merge pipeline.
+- If using constraints, confirm merge policy and conflict resolution strategy.
+- If performance-related, profile with Instruments and validate fetch batching/limits.
+
+## Reference files
+
+- `references/_index.md` (navigation)
+- `references/stack-setup.md`
+- `references/saving.md`
+- `references/fetch-requests.md`
+- `references/threading.md`
+- `references/concurrency.md`
+- `references/batch-operations.md`
+- `references/persistent-history.md`
+- `references/model-configuration.md`
+- `references/migration.md`
+- `references/cloudkit-integration.md`
+- `references/performance.md`
+- `references/testing.md`
+- `references/glossary.md`