Agent skill

opencode

Expertise for using OpenCode (an open-source AI coding agent) and building client applications that interact with the OpenCode HTTP server. Use this skill when the user asks about OpenCode features, how to use it, or how to build tools/clients that integrate with the OpenCode server API.

View SKILL.md on GitHub Repository
Stars 6
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/titonio/opencode-jb/tree/main/.opencode/skill/opencode

SKILL.md

OpenCode

Overview

OpenCode is an open source AI coding agent that runs in your terminal, IDE, or desktop. It provides a server mode that exposes an OpenAPI specification, allowing developers to build custom clients and integrations.

Using OpenCode

For general information about OpenCode features, privacy, and ecosystem, see references/overview.md.

Building Client Applications

To build a client application that interacts with OpenCode, you should communicate with the OpenCode HTTP server.

Quick Start

See scripts/simple_client.py for a complete Python example of connecting, creating a session, and sending a message.

Client Development Guide

For detailed patterns on session management, messaging loops, and event streaming, see references/client_guide.md.

Server Connection

The server typically runs on http://127.0.0.1:4096. You can start it with opencode serve.

API Reference

For a complete list of available endpoints, see references/api.md.

The API covers:

  • Sessions: Create, manage, and interact with coding sessions.
  • Messages: Send prompts and receive responses.
  • Files: Read and search files in the workspace.
  • Projects: Manage projects.
  • TUI Control: Control the Terminal UI programmatically.

Common Workflows

1. Connecting to a Session

To interact with an existing session or create a new one:

  • List sessions: GET /session
  • Create session: POST /session

2. Sending a Message

To send a prompt to the agent:

  • POST /session/:id/message with the prompt content.

3. Reading Files

To read file content:

  • GET /file/content?path=<path>

Resources

scripts/

  • simple_client.py: A Python script demonstrating basic client interactions (connect, create session, send message).

references/

  • overview.md: General overview of OpenCode features and ecosystem.
  • api.md: Detailed API reference for the OpenCode HTTP server.
  • client_guide.md: Best practices and patterns for building OpenCode clients.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

titonio/opencode-jb

template-skill

Replace with description of the skill and when Claude should use it.

6 1
Explore
titonio/opencode-jb

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

6 1
Explore
titonio/opencode-jb

intellij-plugin-builder

Guide for creating IntelliJ Platform plugins using Gradle and Kotlin/Java. Use when users want to create, configure, or develop plugins for IntelliJ IDEA or other JetBrains IDEs.

6 1
Explore
titonio/opencode-jb

internal-comms

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

6 1
Explore
titonio/opencode-jb

mcp-builder

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

6 1
Explore
titonio/opencode-jb

canvas-design

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

6 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results