This is the default template for OpenAgent configuration libraries. Fork this repository to create your own library with custom skills, commands, tools, rules, and agents.

Structure

library/
├── skill/              # Reusable skills (SKILL.md + reference files)
├── command/            # Slash commands (markdown with YAML frontmatter)
├── tool/               # Custom TypeScript tools (@opencode-ai/plugin)
├── rule/               # Reusable instruction sets
├── agent/              # Custom agent configurations
├── mcp/                # MCP server configurations (servers.json)
├── opencode/           # OpenCode plugin configs (oh-my-opencode.json)
└── workspace-template/ # Workspace templates (distro/skills/env/init script)

Built-in Library Tools

This template includes tools for managing library content programmatically:

`library-skills.ts`

list_skills - List all skills in the library
get_skill - Get full skill content by name
save_skill - Create or update a skill
delete_skill - Delete a skill

`library-commands.ts`

list_commands - List all slash commands
get_command - Get command content
save_command - Create or update a command
delete_command - Delete a command
list_tools - List custom tools
get_tool - Get tool source code
save_tool - Create or update a tool
delete_tool - Delete a tool
list_rules - List rules
get_rule - Get rule content
save_rule - Create or update a rule
delete_rule - Delete a rule

`library-git.ts`

status - Get library git status
sync - Pull latest changes from remote
commit - Commit changes with a message
push - Push to remote
get_mcps - Get MCP server configurations
save_mcps - Save MCP configurations

Usage

Fork this repository
Configure your OpenAgent instance with LIBRARY_REMOTE=git@github.com:your-username/your-library.git
Add skills, commands, and tools via the dashboard or using the library tools

Creating Skills

Skills are directories containing a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: Description of what this skill does
---

Instructions for the agent on how to use this skill...

Creating Commands

Commands are markdown files with YAML frontmatter:

---
description: What this command does
model: claude-sonnet-4-20250514
---

Prompt template for the command...

Creating Tools

Tools are TypeScript files using @opencode-ai/plugin:

import { tool } from "@opencode-ai/plugin"

export const my_tool = tool({
  description: "What this tool does",
  args: {
    param: tool.schema.string().describe("Parameter description"),
  },
  async execute(args) {
    // Tool implementation
    return "Result"
  },
})