skills.rest
tailcallhq
tailcallhqOFFICIAL
Explore all skills by this author →
Website𝕏@tailcallhqGitHub

create-agent

Generate standardized Forge agent files with YAML frontmatter and markdown bodies.

7.5k|1.4k|Updated Dec 8, 2024
Search Tags:#templates#markdown#scaffolding#yaml-frontmatter#forge#agent-files#create-agent
One-click install
npx skills add https://github.com/tailcallhq/forgecode --skill create-agent-tailcallhq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-agent
Source: https://github.com/tailcallhq/forgecode/tree/main/.forge/skills/create-agent
Command: npx skills add https://github.com/tailcallhq/forgecode --skill create-agent-tailcallhq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a standardized blueprint for creating Forge agent files, ensuring consistent frontmatter schema and body templates across projects.

Core Features & Use Cases

  • Frontmatter-driven agent definitions that enforce required fields (id, title, description, reasoning, tools, user_prompt) for discoverability.
  • Structured agent bodies guiding identity, core principles, capabilities, methodology, and limitations to ensure consistent behavior.
  • Quick-start-friendly templates and placement guidance for adding agents to <cwd>/.forge/agents.

Quick Start

Create a new agent file under <cwd>/.forge/agents using the provided frontmatter and body template.

Frequently Asked Questions about create-agent

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

FAQPage Schema
How do I scaffold a Forge agent file with the correct frontmatter schema?▼

To scaffold a Forge agent file, generate a markdown file with YAML frontmatter containing required fields like id, title, description, reasoning, tools, and user_prompt. Place the file under the .forge/agents directory to ensure discoverability by Forge.

What fields are required in a Forge agent template for discoverability?▼

Required fields in a Forge agent template include id, title, description, reasoning, tools, and user_prompt. Enforcing this specific YAML frontmatter schema guarantees that the agent files are properly parsed and discoverable by the Forge system.

How do I structure the markdown body when creating a new Forge agent?▼

Structure the markdown body by defining sections for identity, core principles, capabilities, methodology, and limitations. This structured agent body template ensures consistent behavior across all agents added to your project.

Where do I place agent files so Forge can discover them?▼

Place agent files in the .forge/agents directory within your current working directory. Correct file placement, combined with standardized YAML frontmatter, is enforced to ensure agents are discoverable by Forge.

Is there a quick start template for generating standardized agent files?▼

Yes, you can use a quick-start-friendly template to generate standardized agent files. This template provides the required YAML frontmatter schema and structured markdown body, ensuring consistent agent definitions across projects.

Why are my Forge agents not being recognized despite having YAML frontmatter?▼

Forge agents may not be recognized if required frontmatter fields are missing or the file placement is incorrect. Ensure the agent files are located under the .forge/agents directory and include all mandatory fields like id and title.

Related Skills

Explore More Software Engineering Skills→
reliant-labsreliant-labs
4

getting-started

Scaffold a Forge CLI workspace with services, frontends, and workflow assets.

Official
Intermediate
vh2224vh2224
3

forge-help

Document Forge Agent commands, skills, and agents for Claude Code users.

Community
Intermediate
nicholasgriffintnnicholasgriffintn
2

add-skill

Create and validate SKILL.md files with YAML frontmatter for OpenCode or Claude.

Community
Basic
ivegamsftivegamsft

agent-design

Design and configure Copilot agents and skills with templates and conventions.

Community
Advanced