Library Management

Open Agent Library Management

The Open Agent Library is a Git-backed configuration repo that stores reusable skills, agents, commands, tools, rules, MCP servers, workspace templates, and config profiles. Use the library-* tools to read and update that repo.

Use when

• Creating or updating skills, agents, commands, tools, rules, or MCPs
• Managing workspace templates
• Editing config profiles (Claude Code settings, harness configs)
• Adding reference files to skills (examples, templates, supporting docs)
• Syncing library git state (status/sync/commit/push)

Don't use when

• Local file operations unrelated to the library
• Running missions or managing workspace lifecycle

Outputs

• Updated library files and git commits (store exports in artifacts/ if needed).

Templates or Examples

• Use the tool maps below as templates for calling library tools.

Tool Map (file name + export)

Tool names follow the pattern <filename>_<export>.

Skills (library-skills.ts)

• library-skills_list_skills
• library-skills_get_skill
• library-skills_save_skill
• library-skills_delete_skill
• library-skills_get_skill_file - Get a reference file within a skill folder
• library-skills_save_skill_file - Save a reference file within a skill folder
• library-skills_delete_skill_file - Delete a reference file from a skill folder

Agents (library-agents.ts)

• library-agents_list_agents
• library-agents_get_agent
• library-agents_save_agent
• library-agents_delete_agent

Commands / Tools / Rules (library-commands.ts)

• Commands: library-commands_list_commands, library-commands_get_command, library-commands_save_command, library-commands_delete_command
• Tools: library-commands_list_tools, library-commands_get_tool, library-commands_save_tool, library-commands_delete_tool
• Rules: library-commands_list_rules, library-commands_get_rule, library-commands_save_rule, library-commands_delete_rule

Workspace Templates (library-templates.ts)

• library-templates_list_templates
• library-templates_get_template
• library-templates_save_template
• library-templates_delete_template

Config Profiles (library-configs.ts)

• library-configs_list_profiles
• library-configs_get_profile
• library-configs_save_profile
• library-configs_delete_profile
• library-configs_get_file - Get a specific file within a profile
• library-configs_save_file - Save a specific file within a profile

MCPs + Git (library-git.ts)

• MCPs: library-git_get_mcps, library-git_save_mcps
• Git: library-git_status, library-git_sync, library-git_commit, library-git_push

Quick Reference

Procedure

1. List existing items to see what's there
2. Get current content before editing
3. Save the full updated content (frontmatter + body)
4. Commit with a clear message
5. Push to sync the library remote

Procedure References

For detailed guides on specific operations, see these reference files:

• references/config-editing.md - How to edit config profiles (Claude Code settings, etc.)
• references/schema-reference.md - JSON schemas for all library entity types

File Formats

Skill (skill/<name>/SKILL.md)

---
name: skill-name
description: What this skill does (include trigger terms)
---

## Use when
- ...

## Don't use when
- ...

## Outputs
- Expected files in `artifacts/` or required formats

## Instructions
...

## Templates or Examples
...

Skills can also contain reference files (examples, templates, supporting docs) in the same folder. Use library-skills_save_skill_file to add files like skill/<name>/example.md.

Agent (agent/<name>.md)

---
description: Agent description
mode: primary | subagent
model: provider/model-id
hidden: true | false
color: "#44BA81"
tools:
  "*": false
  "read": true
  "write": true
permission:
  edit: ask | allow | deny
  bash:
    "*": ask
rules:
  - rule-name
---
Agent system prompt...

Command (command/<name>.md)

---
description: Command description
model: provider/model-id
subtask: true | false
agent: agent-name
---
Command prompt template. Use $ARGUMENTS for user input.

Tool (tool/<name>.ts)

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

export const my_tool = tool({
  description: "What it does",
  args: { param: tool.schema.string().describe("Param description") },
  async execute(args) {
    return "result"
  },
})

Rule (rule/<name>.md)

---
description: Rule description
---
Rule instructions applied to agents referencing this rule.

Workspace Template (workspace-template/<name>.json)

{
  "name": "template-name",
  "description": "Template description",
  "distro": "ubuntu-noble",
  "skills": ["skill-name"],
  "env_vars": { "KEY": "value" },
  "encrypted_keys": ["SECRET_KEY"],
  "init_scripts": ["base", "ssh-keys"],
  "init_script": "# Custom bash",
  "shared_network": null,
  "tailscale_mode": null,
  "mcps": [],
  "config_profile": "default"
}

Note: Sensitive env_vars are automatically encrypted when saved via the API.

Config Profile (configs/<profile>/)

Config profiles contain harness-specific settings:

• .claudecode/settings.json - Claude Code settings
• .opencode/settings.json - OpenCode settings
• .ampcode/settings.json - Amp Code settings
• .sandboxed-sh/config.json - Sandboxed.sh settings

See references/config-editing.md for details on each config format.

MCPs (mcp/servers.json)

{
  "server-name": {
    "type": "local",
    "command": ["npx", "package-name"],
    "env": { "KEY": "value" },
    "enabled": true
  },
  "remote-server": {
    "type": "remote",
    "url": "https://mcp.example.com",
    "headers": { "Authorization": "Bearer token" },
    "enabled": true
  }
}

Guardrails

• Always read before updating to avoid overwrites
• Keep names lowercase (hyphens allowed) and within 1-64 chars
• Use descriptive commit messages
• Check library-git_status before pushing