my personal configuration and agent setup for opencode. This repository contains agent definitions, modular skills, MCP configurations, and custom commands—all managed with GNU Stow for easy deployment.
| Agent | Type | Mode | Description | Credit |
|---|---|---|---|---|
| ask | all | Quick questions and research assistant. | me | |
| build | primary | Implementation and debugging expert. | modified by me | |
| explore | subagent | Codebase research and context gathering expert. | me | |
| iterate | all | Code review and refinement expert. | me | |
| opencode-configurator | primary | OpenCode Meta-Config Expert | IgorWarzocha | |
| plan | primary | Architecture and system design expert. | modified by me | |
| react-ui-auditor | all | React UI auditor. Use for React component styling audits, Tailwind token compliance checks, and responsive/mobile-desktop compatibility reviews. | me | |
| security-reviewer | subagent | Security auditor for vibecoding vulnerabilities. Use for auditing codebases for common AI-assisted coding security flaws. Use proactively when user says "security review", "check for secrets", or "find vulnerabilities". | IgorWarzocha | |
| ship | primary | Git operations and version control expert. | me | |
| test | primary | Testing and validation expert. | me |
| Skill | Description | Credit |
|---|---|---|
agent-browser |
Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages. | |
agent-navigation-sop |
Generate AGENTS.md for AI agent navigation. Covers build/test commands, coding conventions, task routing, and codebase structure. Use for /init workflow or when creating agent-readable repository documentation. | |
component-engineering |
Apply the formal standard for React component engineering focusing on accessibility, composition, and styling. Use for building professional, composable React artifacts. Use proactively when creating or reviewing React components. | |
create-opencode-plugin |
Create OpenCode plugins using the @opencode-ai/plugin SDK. Use for building custom tools, event hooks, auth providers, or tool execution interception. Use proactively when developing new plugins in .opencode/plugin/ or ~/.config/opencode/plugin/. | |
find-skills |
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill. | |
git |
Git and GitHub CLI mastery for version control operations. Use proactively for commits, branches, | |
ink-tui |
Build terminal UIs with Ink (React for CLIs). Use for interactive CLI apps, | |
mcp-installer |
Find, install, and configure MCP servers. Use proactively for MCP discovery, OAuth setup, env vars, stdio vs SSE transport, or troubleshooting MCP connections. | |
model-researcher |
Add new/custom AI models to opencode.json. Use proactively for bleeding-edge releases, non-standard providers, self-hosted models, or custom endpoints. | |
opencode-agents |
Define and configure OpenCode agents with proper permissions, tools, and behaviors. Use for agent creation, tool access control, permission patterns, and mode selection. | |
opencode-commands |
Create and manage OpenCode slash commands. Use for defining /command shortcuts, template syntax, argument interpolation, and workflow composition. | |
opencode-config |
Edit opencode.json, AGENTS.md, and config files. Use proactively for provider setup, permission changes, model config, formatter rules, or environment variables. | |
opencode-improved |
Analyze external resources (GitHub repos, documentation, articles) and suggest improvements to OpenCode configuration. Use for discovering new patterns, comparing implementations, and enhancing existing skills, commands, and agents. | |
opencode-skills |
Create and manage OpenCode skills with proper SKILL.md format, frontmatter, and organization. Use for skill creation, naming conventions, permission configuration, and reference management. | |
opentui |
Comprehensive OpenTUI skill for building terminal user interfaces. Covers the core imperative API, React reconciler, and Solid reconciler. Use for any TUI development task including components, layout, keyboard handling, animations, and testing. | |
plugin-installer |
Find, install, and configure OpenCode plugins from the catalog or community. Use proactively when user asks about plugins, requests new capabilities, or mentions extending OpenCode functionality. | |
security-* |
a bunch of AI security skills for various frameworks and environments. | IgorWarzocha |
seo-audit |
When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," or "SEO health check." For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema-markup. | |
shadcn |
shadcn/ui component library patterns and usage. Use proactively when working with shadcn, | |
skill-creator |
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations. | anthropics/skills |
user-onboarding-sop |
Generate AGENTS.md for end-user assistance. Covers setup, installation, running, and troubleshooting. This is for END-USER help, NOT developer/contributor docs. Use for /init user workflow. | |
vercel-react-best-practices |
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements. | |
vite-shadcn-tailwind4 |
Initialize shadcn/ui + Tailwind CSS v4 in Vite projects (Vite-specific, not Next.js/Remix). Use proactively for Vite project setup, shadcn component installation, or Tailwind v4 configuration. |
21 slash commands available. Key commands:
| Command | Description | Credit |
|---|---|---|
| /commit | Create conventional commits with automatic security review | |
| /component-create | Generates a new React component. | IgorWarzocha |
| /component-review | Performs an audit of a React component. | |
| /cr-readme | Generate a professional README for the project | |
| /create-agent | Create a new OpenCode agent with guided Q&A | |
| /create-command | Create a new OpenCode slash command | |
| /create-pack | Create Opencode pack components | IgorWarzocha |
| /create-skill | Create a new OpenCode skill with proper structure | IgorWarzocha |
| /docs | Generate and update code documentation with file headers | me |
| /improve | Analyze a resource and suggest OpenCode improvements | |
| /init | Initialize repository documentation | me |
| /install-skill-stow | Install a skills.sh skill via temp dir, move into stowable skills path, update README, and suggest agent permission updates. | me |
| /opencode-help | Get help with OpenCode configuration | me |
| /optimize | Analyze code for performance and security improvements | |
| /permissions-update | Modernize OpenCode configuration and agents to the latest schema | IgorWarzocha |
| /pipeline | Bootstrap complete CI/CD pipeline with Git hooks, linting, and best practices | me |
| /pr | Create a pull request with professional description | |
| /refactor-rfc-xml | Refactor all markdown files in a folder into RFC 2119 + XML tag structure | |
| /resolve-gh-issue-minimal | Plan to resolve a GH issue (minimal) | Ariane Emory |
| /rmslop | Remove AI code slop from recent changes | IgorWarzocha |
| /sync-readme | Update README.md tables (agents, skills, commands, snippets) from config files |
| Provider | Models | Notes | Credit |
|---|---|---|---|
| OpenAI | gpt-5.3-codex | OAuth auth | |
| Anthropic | claude-opus-4-6 | OAuth auth | |
| Local Proxy | gemini-3-flash, gemini-3-pro, claude-opus-4-5 | Via Antigravity | Mirrowel |
| Server | Purpose |
|---|---|
| Context7 | Library documentation lookup |
| Exa | Web search and research |
| Grep.app | GitHub code search |
| Plugin | Purpose |
|---|---|
opencode-antigravity-auth |
Auth for Antigravity proxy |
@tarquinen/opencode-dcp |
Workflow utilities |
@howaboua/opencode-glm-gemini-prompt-enhancer |
Prompt enhancement |
opencode-snippets |
Snippet management |
Located in .config/opencode/snippets/ - reusable snippets for common patterns, security practices, component templates, etc.`
| Snippet | Purpose |
|---|---|
careful |
Think step by step. Double-check your work before making changes. |
# Clone the repository
git clone https://github.com/justinlevinedotme/jalco-opencode.git
cd jalco-opencode
# Use GNU Stow to symlink configurations
stow opencode # Config to ~/.config/opencode- opencode - The underlying tool that makes this all possible
- IgorWarzocha - A huge inspiration and source of many configurations.
- ArianeEmory - For her excellent agent and command designs that influenced several parts of this setup.