create-agent

Build agents from scratch by generating agent.yaml configuration files, defining agent personality in SOUL.md, and organizing skills, tools, and knowledge directories. Includes templates for model settings, runtime constraints, and sub-agent delegation.

create-agent sets up agent.yaml files, SOUL.md personality definitions, and directory structures for new agents.

AI-generated summary based on this skill's SKILL.md

★ 2,903 ⁮ 343 MIT updated 2026-07-02 by open-gitagent

Install

open-gitagent/opengap/create-agent · repository language: TypeScript

Manual (git clone) CLI (skillfed)coming soon

git clone https://github.com/open-gitagent/opengap
cp -r opengap/examples/gitagent-helper/skills/create-agent ~/.claude/skills/create-agent

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How do I create an agent yaml file with create-agent?

create-agent helps you generate an agent.yaml configuration file that defines your agent's core settings. The file specifies the agent's model, system prompt, available skills and tools, knowledge base paths, and runtime constraints. You structure your agent directory with agent.yaml at the root, then organize skills, tools, and knowledge subdirectories beneath it. The YAML file acts as the blueprint that the agent runtime reads to initialize and run your agent.

What should I include in SOUL.md to define agent identity?

create-agent uses SOUL.md to capture your agent's personality, values, and behavioral guidelines. This file defines how your agent thinks, communicates, and makes decisions. Include your agent's core identity, communication style, ethical principles, and any domain-specific expertise or constraints. SOUL.md works alongside agent.yaml—while YAML handles technical configuration, SOUL.md provides the narrative context that shapes your agent's responses and reasoning.

How should I set up agent directory structure?

create-agent organizes agents with a standard directory layout: place agent.yaml and SOUL.md at the root, then create subdirectories for skills, tools, and knowledge. Skills contain reusable agent capabilities, tools hold external integrations or utilities, and knowledge stores domain-specific data or documents. This structure keeps your agent modular and maintainable. The agent.yaml file references these directories so the runtime can load and execute them when needed.

What configuration fields and options does agent.yaml support?

create-agent's agent.yaml includes fields for model selection, system prompt, skill and tool declarations, knowledge base paths, and runtime constraints. You can specify which LLM to use, set token limits, define temperature and other sampling parameters, list available skills with their descriptions, declare external tools, and configure sub-agent delegation if needed. The reference documentation shows all available options so you can tailor the agent to your use case.

Can I add a knowledge base and runtime constraints to my agent?

Yes—create-agent supports adding knowledge base directories and runtime constraints to your agent configuration. In agent.yaml, you can point to knowledge directories containing documents, embeddings, or retrieval indexes. Runtime constraints let you set token budgets, timeout limits, and execution policies. These settings ensure your agent operates within defined boundaries while having access to the domain knowledge it needs to answer questions accurately.

How do I configure skills and tools in my agent?

create-agent lets you organize skills and tools in dedicated directories within your agent folder. In agent.yaml, declare each skill with its name, description, and input/output schema so the agent knows when and how to use it. Tools are external integrations—APIs, databases, or utilities—also declared in the YAML with their endpoints and capabilities. The agent runtime loads these definitions and can invoke them during execution based on user requests.

SKILL.md

rendered from the published skill — quoted content, verbatim

Create & Configure Agents

Quick Start

Create directory structure: mkdir -p my-agent/skills
Write agent.yaml with required fields (see below)
Create SOUL.md with agent identity
Add skills, tools, and knowledge as needed
Validate: opengap validate -d ./my-agent

agent.yaml Reference

Required Fields

spec_version: "0.1.0"
name: my-agent          # Unique identifier
version: 1.0.0          # Semantic version
description: What this agent does

Model Configuration

model:
  preferred: claude-sonnet-4-5-20250929
  fallback:
    - claude-haiku-4-5-20251001
  constraints:
    temperature: 0.2     # 0.0 - 1.0
    max_tokens: 4096
    top_p: 0.9

Skills & Tools

```yaml skills: - code-review # Must

(truncated - see the full file via the links below)

Read as markdown · JSON record · Browse the source repository

File tree — 1 file

examples/gitagent-helper/skills/create-agent/SKILL.md

All skills by open-gitagent → Best LLM wiki skills for AI agents - SkillFed →