create-agent

Create Forge agent files with YAML frontmatter in .forge/agents.

7.5k|1.4k|Updated Dec 8, 2024
One-click install
npx skills add https://github.com/antinomyhq/forge --skill create-agent-antinomyhq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-agent
Source: https://github.com/antinomyhq/forge/tree/main/.forge/skills/create-agent
Command: npx skills add https://github.com/antinomyhq/forge --skill create-agent-antinomyhq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Create Agent skill standardizes how new agents are added to a Forge project, enabling consistent discovery, loading, and lifecycle management of agent files.

Core Features & Use Cases

  • Create new agent documents in the <cwd>/.forge/agents directory, ensuring a consistent frontmatter structure and body.
  • Validate and guide the organization of agent metadata (id, title, description, reasoning, tools, user_prompt) to streamline agent loading and usage.
  • Provide templates and examples to help users quickly scaffold, modify, or understand agent files and their lifecycle.

Quick Start

  • Provide the necessary agent id, title, description, reasoning, and tools, and this skill will generate a starter file at <cwd>/.forge/agents/{agent-id}.md with the required frontmatter and a guiding body.

Frequently Asked Questions about create-agent

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

FAQPage Schema
How do I create a Forge agent file in my codebase?

To create a Forge agent, generate a Markdown file named {agent-id}.md in the .forge/agents directory. This file must include YAML frontmatter with id, title, description, reasoning, tools, and user_prompt, followed by a Markdown body.

What frontmatter is required for a Forge agent?

Required Forge agent frontmatter fields are id, title, description, reasoning, tools, and user_prompt. Validating these metadata fields ensures consistent agent discovery, loading, and lifecycle management in your project.

Does my Forge agent need a specific file structure?

Yes, Forge agents require a specific file structure: a {agent-id}.md file located in the .forge/agents directory. The file must contain YAML frontmatter and a Markdown body describing identity, principles, capabilities, and boundaries.

Can I use templates to scaffold a new Forge agent?

Yes, you can use templates to scaffold a new Forge agent. Providing the necessary agent id, title, description, reasoning, and tools generates a starter file with the required frontmatter and a guiding body.

What should the Markdown body of a Forge agent include?

The Markdown body of a Forge agent should describe the agent's identity, principles, capabilities, and boundaries. This structural guidance helps standardize how new agents are added and understood within the project.

Why does my Forge agent fail to load?

A Forge agent may fail to load if its file is not named {agent-id}.md, is missing the required YAML frontmatter fields, or lacks the proper directory structure. Validation guidance ensures consistent agent loading and usage.