agent-creator

Create or update primary and subagents in the Opencode agentic system.

1|1|Updated Feb 28, 2024
One-click install
npx skills add https://github.com/jiyeol-lee/dotfiles --skill agent-creator-jiyeol-lee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-creator
Source: https://github.com/jiyeol-lee/dotfiles/tree/main/.opencode/skills/agent-creator
Command: npx skills add https://github.com/jiyeol-lee/dotfiles --skill agent-creator-jiyeol-lee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Creates or updates primary and sub-agents in the Opencode agentic system, enabling users to define roles, permissions, and prompts without manual configuration.

Core Features & Use Cases

  • Determine agent type (primary vs subagent) and gather configuration (name, description, type, hidden).
  • Draft the agent prompt at .opencode/prompts/agent/{type}/{name}.md and register the agent in .opencode/opencode.json.
  • Validate the configuration to ensure unique keys, correct prompt paths, and safe permission mapping.

Quick Start

Provide the agent’s name, type (primary or subagent), and a description, then create the corresponding prompt file and update opencode.json.

Frequently Asked Questions about agent-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create and register an agent in Opencode without manual configuration?

To create an Opencode agent, provide the name, type, and description. The system drafts the agent prompt at .opencode/prompts/agent/{type}/{name}.md and automatically registers the configuration in .opencode/opencode.json.

How do I configure permissions and roles for Opencode subagents?

Configuring permissions for Opencode subagents involves defining roles and access levels during the setup workflow. The agent creator applies safe permission mapping and updates the opencode.json configuration file automatically.

What is the difference between primary and subagents in the Opencode agentic system?

In the Opencode agentic system, primary agents and subagents are distinguished by their type configuration. You must specify the agent type as either primary or subagent during setup to determine its hierarchical role and prompt path.

Can I update existing Opencode agent prompts and settings safely?

You can update existing Opencode agents by modifying their prompt files and settings. The system validates configurations to ensure unique agent keys, correct prompt paths, and safe permission mapping before applying updates to opencode.json.

Why does my agent registration fail due to duplicate keys in opencode.json?

Agent registration fails due to duplicate keys when opencode.json contains non-unique agent identifiers. The creation workflow enforces deterministic validation to prevent key collisions and ensure correct prompt path mapping.

Do I need to manually edit opencode.json to set up an Opencode agent?

You do not need to manually edit opencode.json to set up an Opencode agent. The agent creator handles drafting the prompt file and updating the configuration file automatically based on your provided name, type, and description.