moai-adk 0.25.4__py3-none-any.whl → 0.41.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-tool-opencode/modules/configure/skills.md

@@ -0,0 +1,192 @@
+---
+source: https://opencode.ai/docs/skills/
+fetched: 2026-01-08
+title: Agent Skills
+---
+
+# Agent Skills Documentation
+
+## Overview
+
+Agent Skills enables OpenCode to discover reusable instructions from repositories or home directories. These skills are loaded on-demand through a native `skill` tool, allowing agents to access available skills and retrieve full content when needed.
+
+## File Organization
+
+Skills are placed in dedicated folders with a `SKILL.md` file inside.
+
+### Search Locations
+
+OpenCode searches multiple locations for skills:
+
+| Location | Scope |
+|----------|-------|
+| `.opencode/skill/<name>/SKILL.md` | Project |
+| `~/.config/opencode/skill/<name>/SKILL.md` | Global |
+| `.claude/skills/<name>/SKILL.md` | Claude Code compatible |
+| `~/.claude/skills/<name>/SKILL.md` | Claude Code global |
+
+## Required Frontmatter
+
+Each `SKILL.md` must include YAML frontmatter:
+
+```markdown
+---
+name: my-skill-name
+description: A brief description of what this skill does
+license: MIT
+compatibility: opencode>=1.0.0
+metadata:
+  author: Your Name
+  version: 1.0.0
+---
+
+# Skill Content
+
+Instructions and knowledge go here...
+```
+
+### Frontmatter Fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Unique skill identifier |
+| `description` | Yes | Brief description |
+| `license` | No | License type |
+| `compatibility` | No | Version requirements |
+| `metadata` | No | Additional metadata |
+
+## Name Validation Rules
+
+Skill names must follow strict patterns:
+
+- Be 1-64 characters
+- Lowercase alphanumeric with single hyphens
+- Not starting/ending with `-`
+- No consecutive `--`
+
+**Regex:** `^[a-z0-9]+(-[a-z0-9]+)*$`
+
+**Important:** Names must match their containing directory.
+
+### Valid Examples
+
+- `my-skill`
+- `code-review`
+- `python-testing`
+- `api-documentation`
+
+### Invalid Examples
+
+- `My-Skill` (uppercase)
+- `-my-skill` (starts with hyphen)
+- `my--skill` (consecutive hyphens)
+- `my_skill` (underscore)
+
+## Permission Control
+
+Admins can restrict skill access in `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "dangerous-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+### Permission Levels
+
+| Permission | Behavior |
+|------------|----------|
+| `allow` | Immediate access |
+| `deny` | Hidden from agents |
+| `ask` | User approval required |
+
+Supports wildcards for pattern matching.
+
+## Disabling Skills
+
+### Per-Agent Disabling
+
+Disable skills for specific agents:
+
+```json
+{
+  "agent": {
+    "simple-agent": {
+      "skill": false
+    }
+  }
+}
+```
+
+Or in agent markdown frontmatter:
+
+```markdown
+---
+description: Agent without skills
+skill: false
+---
+```
+
+This completely removes the `<available_skills>` section.
+
+## Creating Skills
+
+### Directory Structure
+
+```
+.opencode/skill/my-skill/
+├── SKILL.md
+├── examples/
+│   └── example.md
+└── templates/
+    └── template.md
+```
+
+### Example SKILL.md
+
+```markdown
+---
+name: code-review
+description: Comprehensive code review guidelines and checklists
+---
+
+# Code Review Skill
+
+## Quick Start
+
+When reviewing code, focus on:
+1. Correctness
+2. Security
+3. Performance
+4. Maintainability
+
+## Detailed Guidelines
+
+### Security Checklist
+- [ ] Input validation
+- [ ] Authentication checks
+- [ ] Authorization verification
+- [ ] SQL injection prevention
+- [ ] XSS prevention
+
+### Performance Checklist
+- [ ] Efficient algorithms
+- [ ] Proper caching
+- [ ] Database query optimization
+- [ ] Memory management
+```
+
+## Best Practices
+
+1. **Clear naming**: Use descriptive, hyphenated names
+2. **Good descriptions**: Help agents understand when to use skills
+3. **Modular content**: Break complex skills into sections
+4. **Version control**: Track skills in your repository
+5. **Test skills**: Verify agents use skills correctly

moai_adk/templates/.claude/skills/moai-tool-opencode/modules/configure/themes.md

@@ -0,0 +1,200 @@
+---
+source: https://opencode.ai/docs/themes/
+fetched: 2026-01-08
+title: Themes Configuration
+---
+
+# OpenCode Themes Documentation
+
+## Overview
+
+OpenCode allows users to select and customize themes. Users can choose from built-in themes, use a system-adaptive theme, or create custom ones.
+
+## Terminal Requirements
+
+Your terminal must support **truecolor** (24-bit color) for proper theme display.
+
+### Verify Support
+
+```bash
+echo $COLORTERM
+```
+
+Should output `truecolor` or `24bit`.
+
+### Enable Truecolor
+
+Add to your shell profile:
+
+```bash
+export COLORTERM=truecolor
+```
+
+### Supported Terminals
+
+Modern terminals with truecolor support:
+- iTerm2
+- Alacritty
+- Kitty
+- Windows Terminal
+- WezTerm
+- Ghostty
+
+## Built-in Themes
+
+| Theme | Description |
+|-------|-------------|
+| `system` | Adapts to terminal background |
+| `tokyonight` | Based on popular editor theme |
+| `everforest` | Nature-inspired color palette |
+| `ayu` | Clean and modern design |
+| `catppuccin` | Soothing pastel theme |
+| `catppuccin-macchiato` | Catppuccin variant |
+| `gruvbox` | Retro groove color scheme |
+| `kanagawa` | Japanese-inspired palette |
+| `nord` | Arctic, north-bluish palette |
+| `matrix` | Green-on-black hacker style |
+| `one-dark` | Atom-inspired theme |
+
+## System Theme
+
+The system theme automatically adapts to your terminal's color scheme:
+- Generates custom gray scales
+- Uses ANSI colors (0-15)
+- Preserves terminal defaults using `none` values
+
+## Configuration
+
+### Using /theme Command
+
+```bash
+/themes
+```
+
+Select from available themes interactively.
+
+### Config File
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "theme": "tokyonight"
+}
+```
+
+## Custom Theme Creation
+
+### Directory Hierarchy (Priority Order)
+
+1. Built-in themes (highest priority)
+2. `~/.config/opencode/themes/*.json` (global)
+3. `./.opencode/themes/*.json` (project root)
+4. `./.opencode/themes/*.json` (current directory)
+
+### JSON Format
+
+Custom themes support:
+- Hex colors: `#ffffff`
+- ANSI values: `0-255`
+- Color references: Reference defined colors
+- Dark/light variants
+- `"none"`: Terminal defaults
+
+### Example Theme Structure
+
+```json
+{
+  "$schema": "https://opencode.ai/theme.json",
+  "defs": {
+    "nord0": "#2E3440",
+    "nord1": "#3B4252",
+    "nord2": "#434C5E",
+    "nord3": "#4C566A",
+    "nord4": "#D8DEE9",
+    "nord5": "#E5E9F0",
+    "nord6": "#ECEFF4",
+    "nord7": "#8FBCBB",
+    "nord8": "#88C0D0",
+    "nord9": "#81A1C1",
+    "nord10": "#5E81AC",
+    "nord11": "#BF616A",
+    "nord12": "#D08770",
+    "nord13": "#EBCB8B",
+    "nord14": "#A3BE8C",
+    "nord15": "#B48EAD"
+  },
+  "theme": {
+    "primary": {
+      "dark": "nord8",
+      "light": "nord10"
+    },
+    "secondary": {
+      "dark": "nord9",
+      "light": "nord9"
+    },
+    "accent": {
+      "dark": "nord7",
+      "light": "nord7"
+    },
+    "error": {
+      "dark": "nord11",
+      "light": "nord11"
+    },
+    "warning": {
+      "dark": "nord13",
+      "light": "nord13"
+    },
+    "success": {
+      "dark": "nord14",
+      "light": "nord14"
+    },
+    "text": {
+      "dark": "nord4",
+      "light": "nord0"
+    },
+    "background": {
+      "dark": "nord0",
+      "light": "nord6"
+    },
+    "border": {
+      "dark": "nord3",
+      "light": "nord4"
+    },
+    "diff": {
+      "add": {
+        "dark": "nord14",
+        "light": "nord14"
+      },
+      "remove": {
+        "dark": "nord11",
+        "light": "nord11"
+      }
+    },
+    "syntax": {
+      "keyword": "nord9",
+      "string": "nord14",
+      "number": "nord15",
+      "comment": "nord3",
+      "function": "nord8",
+      "variable": "nord4"
+    }
+  }
+}
+```
+
+### Theme Properties
+
+| Property | Description |
+|----------|-------------|
+| `primary` | Main accent color |
+| `secondary` | Secondary accent |
+| `accent` | Highlight color |
+| `error` | Error messages |
+| `warning` | Warning messages |
+| `success` | Success messages |
+| `text` | Default text |
+| `background` | Background color |
+| `border` | Border color |
+| `diff.add` | Added lines in diffs |
+| `diff.remove` | Removed lines in diffs |
+| `syntax.*` | Syntax highlighting colors |

moai_adk/templates/.claude/skills/moai-tool-opencode/modules/configure/tools.md

@@ -0,0 +1,169 @@
+---
+source: https://opencode.ai/docs/tools/
+fetched: 2026-01-08
+title: Tools Configuration
+---
+
+# OpenCode Tools Documentation
+
+## Overview
+
+OpenCode provides a comprehensive tools system enabling LLMs to interact with your codebase. The platform includes built-in tools and supports extensibility through custom tools and MCP servers.
+
+## Configuration Options
+
+### Global Setup
+
+Tools are enabled by default. Disable specific tools via the config:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "tools": {
+    "write": false,
+    "bash": false,
+    "webfetch": true
+  }
+}
+```
+
+Wildcard patterns control multiple tools:
+
+```json
+{
+  "tools": {
+    "mymcp_*": false
+  }
+}
+```
+
+This disables all tools from that MCP server.
+
+### Per-Agent Override
+
+Agent-specific configurations supersede global settings:
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "write": false,
+        "bash": false
+      }
+    }
+  }
+}
+```
+
+## Built-in Tools
+
+| Tool | Purpose |
+|------|---------|
+| `bash` | Execute shell commands in your project environment |
+| `edit` | Precise file modifications through exact string replacement |
+| `write` | Create new or overwrite existing files |
+| `read` | Retrieve file contents with line-range support |
+| `grep` | Search file contents using regular expressions |
+| `glob` | Pattern-based file discovery, sorted by modification time |
+| `list` | Directory enumeration with glob pattern filtering |
+| `lsp` | Code intelligence (experimental; requires flag) |
+| `patch` | Apply patch files to codebases |
+| `skill` | Load skill files (SKILL.md) into conversations |
+| `todowrite` | Track multi-step task progress |
+| `todoread` | Retrieve current task list state |
+| `webfetch` | Retrieve web content for documentation lookup |
+
+## Tool Descriptions
+
+### bash
+
+Execute shell commands in your project environment. Useful for running tests, build commands, and system operations.
+
+### edit
+
+Precise file modifications through exact string replacement. Matches and replaces specific text patterns.
+
+### write
+
+Create new files or overwrite existing files with specified content.
+
+### read
+
+Retrieve file contents with optional line-range support for large files.
+
+### grep
+
+Search file contents using regular expressions. Supports pattern matching across multiple files.
+
+### glob
+
+Pattern-based file discovery. Returns files matching glob patterns, sorted by modification time.
+
+### list
+
+Directory enumeration with optional glob pattern filtering.
+
+### lsp
+
+Code intelligence features including:
+- Go to definition
+- Find references
+- Symbol search
+
+**Note:** Experimental feature requiring `--experimental-lsp` flag.
+
+### patch
+
+Apply unified diff patch files to codebases.
+
+### skill
+
+Load skill files (SKILL.md) into conversations for specialized knowledge.
+
+### todowrite / todoread
+
+Track and retrieve multi-step task progress.
+
+### webfetch
+
+Retrieve web content for documentation lookup and research.
+
+## Advanced Configuration
+
+### Ignore Patterns
+
+The system uses ripgrep, respecting `.gitignore` by default. Override with `.ignore`:
+
+```
+!node_modules/
+!dist/
+!build/
+```
+
+### Extensibility
+
+**Custom Tools:**
+User-defined functions in config files. See Custom Tools documentation.
+
+**MCP Servers:**
+External services and database integrations. See MCP Servers documentation.
+
+## Permissions
+
+Permissions can be configured separately to require approval before tool execution:
+
+```json
+{
+  "permission": {
+    "edit": "ask",
+    "bash": "ask",
+    "write": "allow"
+  }
+}
+```
+
+Options:
+- `"ask"`: Require user approval
+- `"allow"`: Auto-approve
+- `"deny"`: Block tool usage