skills.rest
EmmittJ
EmmittJCOMMUNITY
Explore all skills by this author →
GitHub

train-agent

Scaffold .agent.md files with proper frontmatter for new roles.

1|1|Updated Mar 9, 2026
Search Tags:#github#agent#agents#scaffold#frontmatter#train
One-click install
npx skills add https://github.com/EmmittJ/guild --skill train-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: train-agent
Source: https://github.com/EmmittJ/guild/tree/main/plugin/skills/train-agent
Command: npx skills add https://github.com/EmmittJ/guild --skill train-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffold a ready-to-use .agent.md file for a new role or team member in the repo, ensuring proper frontmatter and structure.

Core Features & Use Cases

  • Generates .agent.md frontmatter with name, description, and required sections.
  • Provides templates or guidance for common agent categories (Orchestrator, Builder, Advisor, Scribe) and ensures compatibility with VS Code, Copilot CLI, Claude Code, and other tools.
  • Use case: rapidly onboard a new role by creating a fully formed agent draft ready for refinement.

Quick Start

Create a new agent file for the desired role in the repo's .github/agents/ directory.

Frequently Asked Questions about train-agent

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

FAQPage Schema
How do I scaffold a ready-to-use agent file for a new role in my repository?▼

Scaffolding an agent file generates a structured .agent.md template with frontmatter and required sections, placing it in your .github/agents/ directory to rapidly onboard a new role.

What is the .agent.md file format for GitHub Copilot and Claude Code agents?▼

The .agent.md format uses frontmatter containing the agent's name and description, followed by required sections, ensuring compatibility across VS Code, Copilot CLI, and Claude Code tools.

Does the agent scaffold template support common categories like Orchestrator or Builder?▼

Yes, the agent scaffold provides templates and guidance for common categories including Orchestrator, Builder, Advisor, and Scribe, ensuring structured role drafts ready for refinement.

Can I use this agent scaffold for projects maintaining a formal roster in .claude/agents/?▼

Yes, the agent scaffold applies to projects maintaining formal rosters in either .github/agents/ or .claude/agents/ directories, ensuring consistent templates for new team members.

What's the best way to ensure proper frontmatter when creating a new agent file?▼

Using an agent scaffold tool ensures proper frontmatter generation by automatically applying the Agent File Format guidelines, structuring name, description, and required sections consistently.

Why does my manually created .agent.md file fail to work with VS Code or Copilot CLI?▼

Manually created .agent.md files often fail due to missing frontmatter or incorrect structure; scaffolding from a template ensures compliance with Agent File Format guidelines for tool compatibility.

Related Skills

Explore More Software Engineering Skills→
blueif16blueif16

create-agent

Create subagents and initialize plugin structure in .claude/agents/.

Community
Basic
AI-Driven-Highspeed-DevelopmentAI-Driven-Highspeed-Development

writing-agents

Define YAML frontmatter and sections for ADHD Framework .agent.md files.

Official
Intermediate
outfitter-devoutfitter-dev
28

claude-plugin-authoring

Automate creation of Claude Code plugins with metadata, commands, agents, hooks, and MCP configurations.

Official
Intermediate
dotnetdotnet
5.1k

create-custom-agent

Generates VS Code custom agent files (.agent.md) with structured definitions.

Official
Basic