agent-authoring

Validate Copilot agent frontmatter schemas under .github/agents.

27|9|Updated Aug 8, 2025
One-click install
npx skills add https://github.com/taurgis/sfcc-dev-mcp --skill agent-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-authoring
Source: https://github.com/taurgis/sfcc-dev-mcp/tree/main/.github/skills/agent-authoring
Command: npx skills add https://github.com/taurgis/sfcc-dev-mcp --skill agent-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured approach to designing, organizing, and validating Copilot agents within this repository, ensuring consistent agent quality and reuse across projects.

Core Features & Use Cases

  • Guidelines for creating agents under .github/agents with a minimal, consistent frontmatter schema.
  • Frontmatter fields supported: name, description, tools, target, infer, mcp-servers, handoffs.
  • Clear playbooks, guardrails, and validation steps to accelerate safe agent development across workspaces.

Quick Start

Create .github/agents/<agent-name>.agent.md and define its frontmatter using the supported fields to begin building your Copilot agent.

Frequently Asked Questions about agent-authoring

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

FAQPage Schema
How do I create and validate Copilot agents in my repository?

To create Copilot agents, you add Markdown files under the .github/agents directory and define YAML frontmatter. This skill provides playbooks and validation steps to enforce a consistent schema for safe agent development.

What frontmatter fields are required for workspace-level Copilot agents?

Workspace-level Copilot agents require YAML frontmatter fields including name, description, tools, target, infer, mcp-servers, and handoffs. This schema ensures consistent agent quality and reuse across projects.

How do I structure a Copilot agent markdown file correctly?

Structuring a Copilot agent involves creating a .agent.md file with YAML frontmatter and a concise, actionable body. The skill enforces guardrails to ensure the agent's body is clear and safely structured.

Can I use MCP servers and handoffs when designing Copilot agents?

Yes, designing Copilot agents supports specifying mcp-servers and handoffs within the frontmatter schema. This allows you to define external server connections and agent routing behaviors.

What is the best way to organize multiple Copilot agents across projects?

Organizing multiple Copilot agents is best handled by placing them under the .github/agents directory with a minimal, consistent frontmatter schema. This approach accelerates safe agent development and reuse.

Why do my Copilot agents fail validation in the workspace?

Copilot agents fail validation if they lack required frontmatter fields or contain an overly verbose body. This skill enforces specific YAML fields and guardrails to ensure agents pass validation.