opencodekit 0.20.6 → 0.20.8

package/dist/template/.opencode/skill/obsidian/SKILL.md

@@ -1,192 +0,0 @@
----
-name: obsidian
-description: Use when working with Obsidian vault via MCP - read/write notes, search, tag management, and vault operations
-version: 1.0.0
-tags: [integration, documentation]
-dependencies: []
-mcp:
-  server: @mauricio.wolff/mcp-obsidian
-  args: ["{env:OBSIDIAN_VAULT_PATH}"]
----
-
-# Obsidian Vault (MCP)
-
-## When to Use
-
-- When you need MCP-based read/write/search operations in an Obsidian vault.
-
-## When NOT to Use
-
-- When the task does not involve an Obsidian vault or MCP access.
-
-
-## Available Tools
-
-### Read Operations
-
-| Tool                  | Purpose                           | Arguments                                         |
-| --------------------- | --------------------------------- | ------------------------------------------------- |
-| `read_note`           | Read note with parsed frontmatter | `path`, `prettyPrint`                             |
-| `read_multiple_notes` | Batch read (max 10)               | `paths[]`, `includeContent`, `includeFrontmatter` |
-| `get_frontmatter`     | Extract only frontmatter          | `path`                                            |
-| `get_notes_info`      | Get metadata without content      | `paths[]`                                         |
-| `list_directory`      | List files and directories        | `path`                                            |
-
-### Write Operations
-
-| Tool                 | Purpose                               | Arguments                                |
-| -------------------- | ------------------------------------- | ---------------------------------------- |
-| `write_note`         | Write note (overwrite/append/prepend) | `path`, `content`, `frontmatter`, `mode` |
-| `update_frontmatter` | Update frontmatter only               | `path`, `frontmatter`, `merge`           |
-| `delete_note`        | Delete note (requires confirmation)   | `path`, `confirmPath`                    |
-| `move_note`          | Move/rename note                      | `oldPath`, `newPath`, `overwrite`        |
-
-### Search & Tags
-
-| Tool           | Purpose                       | Arguments                                              |
-| -------------- | ----------------------------- | ------------------------------------------------------ |
-| `search_notes` | Search by content/frontmatter | `query`, `limit`, `searchContent`, `searchFrontmatter` |
-| `manage_tags`  | Add/remove/list tags          | `path`, `operation`, `tags[]`                          |
-
-## Write Modes
-
-| Mode        | Description                           |
-| ----------- | ------------------------------------- |
-| `overwrite` | Replace entire file content (default) |
-| `append`    | Add content to end of file            |
-| `prepend`   | Add content to beginning of file      |
-
-## Usage Examples
-
-### Read Notes
-
-```typescript
-// Read a single note
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "read_note",
-  arguments: '{"path": "projects/project-ideas.md"}',
-});
-
-// Read multiple notes
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "read_multiple_notes",
-  arguments: '{"paths": ["note1.md", "note2.md"], "includeContent": true}',
-});
-
-// List directory
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "list_directory",
-  arguments: '{"path": "Projects"}',
-});
-```
-
-### Write Notes
-
-```typescript
-// Create new note (overwrite)
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "write_note",
-  arguments: `{
-    "path": "meeting-notes.md",
-    "content": "# Team Meeting\\n\\n## Agenda\\n- Project updates",
-    "frontmatter": {"title": "Team Meeting", "date": "2025-02-13", "tags": ["meetings", "team"]},
-    "mode": "overwrite"
-  }`,
-});
-
-// Append to existing note
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "write_note",
-  arguments:
-    '{"path": "daily-log.md", "content": "\\n\\n## 3:00 PM\\n- Completed review", "mode": "append"}',
-});
-```
-
-### Search & Tags
-
-```typescript
-// Search notes
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "search_notes",
-  arguments: '{"query": "machine learning", "limit": 5, "searchContent": true}',
-});
-
-// Add tags
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "manage_tags",
-  arguments: '{"path": "research-notes.md", "operation": "add", "tags": ["important", "ai"]}',
-});
-
-// List tags
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "manage_tags",
-  arguments: '{"path": "research-notes.md", "operation": "list"}',
-});
-```
-
-### Delete (Safe)
-
-```typescript
-// Delete requires confirmation (both paths must match)
-skill_mcp({
-  skill_name: "obsidian",
-  tool_name: "delete_note",
-  arguments: '{"path": "old-draft.md", "confirmPath": "old-draft.md"}',
-});
-```
-
-## Configuration
-
-### Environment Variable
-
-Set your vault path:
-
-```bash
-export OBSIDIAN_VAULT_PATH="/path/to/your/obsidian/vault"
-```
-
-Or configure in opencode.json:
-
-```json
-{
-  "mcp": {
-    "obsidian": {
-      "command": "npx",
-      "args": ["@mauricio.wolff/mcp-obsidian", "/path/to/vault"]
-    }
-  }
-}
-```
-
-## Security
-
-- Path traversal protection: prevents access outside vault
-- Auto-excludes: `.obsidian`, `.git`, `node_modules`
-- Frontmatter validation: blocks dangerous objects
-- Confirmation required for deletions
-
-## Common Use Cases
-
-| Task                 | Tool             | Example                                                                       |
-| -------------------- | ---------------- | ----------------------------------------------------------------------------- |
-| List vault files     | `list_directory` | `list_directory({ path: "" })`                                                |
-| Read specific note   | `read_note`      | `read_note({ path: "tasks/project.md" })`                                     |
-| Create/update note   | `write_note`     | `write_note({ path: "new.md", content: "...", mode: "overwrite" })`           |
-| Search notes         | `search_notes`   | `search_notes({ query: "API", limit: 10 })`                                   |
-| Add tags             | `manage_tags`    | `manage_tags({ path: "note.md", operation: "add", tags: ["urgent"] })`        |
-| Append to daily note | `write_note`     | `write_note({ path: "daily/2025-02-13.md", content: "...", mode: "append" })` |
-
-## Tips
-
-- Use `prettyPrint: true` for debugging, `false` (default) for production
-- Batch reads with `read_multiple_notes` (max 10)
-- Search supports content and frontmatter filtering
-- Frontmatter is auto-parsed on read

package/dist/template/.opencode/skill/obsidian/mcp.json

@@ -1,22 +0,0 @@
-{
-	"obsidian": {
-		"command": "npx",
-		"args": ["-y", "@mauricio.wolff/mcp-obsidian", "{env:OBSIDIAN_VAULT_PATH}"],
-		"env": {
-			"OBSIDIAN_VAULT_PATH": "{env:OBSIDIAN_VAULT_PATH}"
-		},
-		"includeTools": [
-			"read_note",
-			"read_multiple_notes",
-			"get_frontmatter",
-			"get_notes_info",
-			"list_directory",
-			"write_note",
-			"update_frontmatter",
-			"delete_note",
-			"move_note",
-			"search_notes",
-			"manage_tags"
-		]
-	}
-}

package/dist/template/.opencode/skill/pencil/SKILL.md

@@ -1,72 +0,0 @@
----
-name: pencil
-description: Use when working with OpenPencil .op design files — creating, editing, or exporting code from designs. MUST load before any OpenPencil workflow. Requires desktop app (npm CLI does not provide openpencil-mcp).
-version: 1.0.0
-tags: [design, openpencil, mcp, cli]
-mcp:
-  pencil:
-    command: openpencil-mcp
----
-
-# OpenPencil Skill
-
-Legacy skill name: `pencil`.
-
-## When to Use
-
-- Create or modify UI designs as code using `.op` files.
-- Export production code or visuals from the terminal.
-- Use OpenPencil's desktop-bundled MCP server after installing the app.
-
-## Prerequisites
-
-### Install CLI
-
-```bash
-npm install -g @zseven-w/openpencil
-op status
-```
-
-### Install Desktop App for MCP
-
-- Install the OpenPencil desktop app from the ZSeven-W/openpencil releases page.
-- Open **Agent Settings** inside OpenPencil and use the one-click MCP install for OpenCode/Claude Code/Codex/etc.
-- The npm CLI install does **not** provide `openpencil-mcp`; that binary is bundled with the desktop app.
-
-### MCP Server
-
-- OpenPencil ships a built-in MCP server for agent tooling.
-- The server command is `openpencil-mcp` once the desktop app has installed/exposed it.
-- Keep MCP disabled in template config until OpenPencil desktop is installed locally.
-
-## Quick Start
-
-```bash
-# Create new design
-op design @landing.txt
-
-# Start the desktop app
-op start
-
-# Export code
-op export react --out .
-
-# Import a Figma file
-op import:figma design.fig
-```
-
-## Core CLI Commands
-
-- `op design @brief.txt`
-- `op design:skeleton`
-- `op design:content`
-- `op design:refine --root-id <id>`
-- `op export react --out .`
-- `op import:figma design.fig`
-
-## Notes
-
-- OpenPencil uses `.op` files as the source of truth.
-- CLI install is published on npm as `@zseven-w/openpencil` and exposes the `op` binary.
-- MCP is a desktop-app-bundled feature, not a standalone npm package.
-- Use taste-skill for design quality, OpenPencil for execution.

package/dist/template/.opencode/skill/ralph/SKILL.md

@@ -1,296 +0,0 @@
----
-name: ralph
-description: Use when running autonomous agent loops for extended task completion without human intervention - handles PRD-driven development, migration tasks, or batch operations
-version: 1.0.0
-tags: [workflow, automation]
-dependencies: []
----
-
-# Ralph Wiggum - Autonomous Agent Loop
-
-## When to Use
-
-- **PRD-driven development**: Work through a product requirements document task by task
-- **Migration tasks**: "Migrate all Jest tests to Vitest" - agent works until done
-- **Batch operations**: Process multiple files/components with the same pattern
-- **Away-from-keyboard work**: Let the agent work autonomously while you're away
-
-## When NOT to Use
-
-- Simple single-step tasks (just do them directly)
-- Tasks requiring frequent human decisions
-- Exploratory work where the goal isn't clear
-- Critical production changes (requires human oversight)
-
-
-## Quick Start
-
-Invoke the workflow with:
-
-```
-/ralph Migrate all Jest tests to Vitest --prd PRD.md
-```
-
-Or manually follow the loop pattern below.
-
-## The Loop Pattern
-
-```
-┌─────────────────────────────────────────────────┐
-│  1. Read PRD/task list + progress.txt           │
-│  2. Pick highest-priority incomplete task       │
-│  3. Implement ONE feature only                  │
-│  4. Run feedback: test → typecheck → lint       │
-│  5. If pass → commit + update progress.txt      │
-│  6. If all done → output <promise>COMPLETE      │
-│  7. Otherwise → repeat from step 1              │
-└─────────────────────────────────────────────────┘
-```
-
-## Using LSP Tools (Experimental)
-
-OpenCode provides LSP tools for code intelligence.
-
-### Available Operations
-
-```typescript
-// Understand file structure before editing
-lsp({
-  operation: "documentSymbol",
-  filePath: "src/auth.ts",
-  line: 1,
-  character: 1,
-});
-
-// Find where a symbol is defined
-lsp({
-  operation: "goToDefinition",
-  filePath: "src/auth.ts",
-  line: 42,
-  character: 10,
-});
-
-// Find all usages of a symbol (impact analysis)
-lsp({
-  operation: "findReferences",
-  filePath: "src/auth.ts",
-  line: 42,
-  character: 10,
-});
-
-// Get type info and documentation
-lsp({ operation: "hover", filePath: "src/auth.ts", line: 42, character: 10 });
-
-// Find implementations of interface/abstract
-lsp({
-  operation: "goToImplementation",
-  filePath: "src/types.ts",
-  line: 15,
-  character: 10,
-});
-
-// Search symbols across entire workspace
-lsp({
-  operation: "workspaceSymbol",
-  filePath: "src/index.ts",
-  line: 1,
-  character: 1,
-});
-
-// Call hierarchy analysis
-lsp({
-  operation: "prepareCallHierarchy",
-  filePath: "src/api.ts",
-  line: 20,
-  character: 5,
-});
-lsp({
-  operation: "incomingCalls",
-  filePath: "src/api.ts",
-  line: 20,
-  character: 5,
-});
-lsp({
-  operation: "outgoingCalls",
-  filePath: "src/api.ts",
-  line: 20,
-  character: 5,
-});
-```
-
-### LSP-First Workflow
-
-Before editing ANY file in the loop:
-
-```
-1. Read the file
-2. Use documentSymbol to understand structure
-3. Use findReferences to check impact
-4. Use hover for type info
-5. THEN make edits
-```
-
-This prevents breaking changes and ensures you understand the code before modifying it.
-
-## Smart Language Detection
-
-OpenCode auto-detects languages via LSP based on file extensions. Use this to determine the project type:
-
-### Primary Detection (File Extensions)
-
-| Language   | Extensions                    | LSP Server    |
-| ---------- | ----------------------------- | ------------- |
-| TypeScript | `.ts`, `.tsx`, `.mts`, `.cts` | typescript    |
-| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | typescript    |
-| Python     | `.py`, `.pyi`                 | pyright       |
-| Rust       | `.rs`                         | rust-analyzer |
-| Go         | `.go`                         | gopls         |
-| C/C++      | `.c`, `.cpp`, `.h`, `.hpp`    | clangd        |
-| Java       | `.java`                       | jdtls         |
-| C#         | `.cs`                         | csharp        |
-| Ruby       | `.rb`, `.rake`                | ruby-lsp      |
-| PHP        | `.php`                        | intelephense  |
-| Swift      | `.swift`                      | sourcekit-lsp |
-| Kotlin     | `.kt`, `.kts`                 | kotlin-ls     |
-| Elixir     | `.ex`, `.exs`                 | elixir-ls     |
-| Dart       | `.dart`                       | dart          |
-| Zig        | `.zig`                        | zls           |
-| Gleam      | `.gleam`                      | gleam         |
-| Lua        | `.lua`                        | lua-ls        |
-| Clojure    | `.clj`, `.cljs`, `.cljc`      | clojure-lsp   |
-| OCaml      | `.ml`, `.mli`                 | ocaml-lsp     |
-| Svelte     | `.svelte`                     | svelte        |
-| Vue        | `.vue`                        | vue           |
-| Astro      | `.astro`                      | astro         |
-
-### Secondary Detection (Lock Files → Package Manager)
-
-| Lock File           | Package Manager | Runtime |
-| ------------------- | --------------- | ------- |
-| `bun.lockb`         | Bun             | Bun     |
-| `yarn.lock`         | Yarn            | Node    |
-| `pnpm-lock.yaml`    | pnpm            | Node    |
-| `package-lock.json` | npm             | Node    |
-| `deno.json`         | Deno            | Deno    |
-| `Cargo.toml`        | Cargo           | Rust    |
-| `go.mod`            | Go Modules      | Go      |
-| `pyproject.toml`    | Poetry/pip      | Python  |
-| `Gemfile.lock`      | Bundler         | Ruby    |
-| `composer.lock`     | Composer        | PHP     |
-| `Package.swift`     | SwiftPM         | Swift   |
-| `mix.lock`          | Mix             | Elixir  |
-| `pubspec.lock`      | Pub             | Dart    |
-
-### Validation Commands by Language
-
-```bash
-# TypeScript/JavaScript (Bun)
-bun test && bun run typecheck && bun run lint
-
-# TypeScript/JavaScript (npm)
-npm test && npm run typecheck && npm run lint
-
-# TypeScript/JavaScript (Deno)
-deno test && deno check . && deno lint
-
-# Python
-pytest && ruff check . && mypy .
-
-# Rust
-cargo test && cargo check && cargo clippy --all-targets
-
-# Go
-go test ./... && go vet ./... && golangci-lint run
-
-# Ruby
-bundle exec rspec && bundle exec rubocop
-
-# PHP
-composer test && composer phpstan && composer phpcs
-
-# Swift
-swift test && swift build
-
-# Elixir
-mix test && mix credo && mix dialyzer
-
-# Dart
-dart test && dart analyze
-
-# Java (Maven)
-mvn test && mvn compile && mvn checkstyle:check
-
-# Java (Gradle)
-./gradlew test && ./gradlew check
-
-# C# (.NET)
-dotnet test && dotnet build && dotnet format --verify-no-changes
-```
-
-## Required Files
-
-### PRD File (Recommended)
-
-Create a `PRD.md` with clear task list:
-
-```markdown
-# Migration PRD
-
-## Tasks
-
-- [ ] Convert test-utils.test.js
-- [ ] Convert api.test.js
-- [ ] Update CI config
-- [ ] Remove Jest dependencies
-```
-
-### Progress File (Agent-maintained)
-
-Agent creates/updates `progress.txt`:
-
-```markdown
-# Progress Log
-
-## Session Started: 2026-01-10
-
-### Project: TypeScript with Bun
-
-### Commands: bun test | bun run typecheck | bun run lint
-
-### Completed Tasks
-
-- [x] test-utils.test.js - migrated, 12 tests passing
-- [x] api.test.js - migrated, 8 tests passing
-
-### Notes for Next Iteration
-
-- CI config needs Vitest runner update
-```
-
-## Completion Signal
-
-The loop ends when agent outputs:
-
-```
-<promise>COMPLETE</promise>
-```
-
-## Best Practices
-
-1. **Use LSP for detection**: Check file extensions, not just lock files
-2. **Small steps**: ONE feature per iteration (prevents context rot)
-3. **Quality gates**: Test, typecheck, lint MUST pass before commit
-4. **Prioritize risk**: Hard tasks first, easy wins last
-5. **Track progress**: Update progress.txt every iteration
-6. **Explicit scope**: Vague tasks loop forever
-7. **Graceful fallbacks**: If a command doesn't exist, skip and note it
-
-## Troubleshooting
-
-| Issue                | Solution                                    |
-| -------------------- | ------------------------------------------- |
-| Loop not progressing | Break task into smaller pieces              |
-| Tests failing        | Fix before continuing, don't skip           |
-| Context getting long | Summarize progress, restart session         |
-| Stuck on decision    | Note in progress.txt, ask user next session |
-| Unknown language     | Check file extensions against LSP table     |