agent-builder

Create and validate .agent.md files with scoped personas, minimal tools, and constraints.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/r-senchuk/agentskills --skill agent-builder-r-senchuk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-builder
Source: https://github.com/r-senchuk/agentskills/tree/main/.agents/skills/agent-builder
Command: npx skills add https://github.com/r-senchuk/agentskills --skill agent-builder-r-senchuk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Designing custom Copilot agents often produces vague descriptions, bloated tool lists, and missing constraints, which leads to agents that trigger incorrectly or underperform. This Skill provides a structured procedure for defining agent scope, selecting minimal tools, assigning skills, and validating the resulting .agent.md file. ## Core Features & Use Cases - Scoped Agent Design: Guides definition of a single role, explicit exclusions, delegation rules, and output format before writing any file. - Minimal Tool Selection: Provides decision tables for choosing only the tools (read, edit, search, execute, web, agent) the agent's role requires, with Swiss-army anti-pattern detection. - Validation & Sync: Includes shell-based validation of frontmatter fields, filename/name matching, skill path resolution, and a bootstrap step to symlink agents into ~/.copilot/ and VS Code prompt directories. - Use Case: You need a read-only research subagent for a multi-agent workflow. Use this Skill to define its persona, restrict tools to [read, search, web], write the .agent.md, validate it, and sync it into your active Copilot environment. ## Quick Start Ask the agent to create a new .agent.md for a specialized subagent, providing its name, purpose, required tools, and the skills it should load.

Frequently Asked Questions about agent-builder

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

FAQPage Schema
How do I create a custom Copilot agent file?▼

Define the agent's single role, exclusions, and output format first, then write a .agent.md file in .github/agents/ with frontmatter containing description, a minimal tools list, and user-invocable. The body needs an identity statement, core workflow, constraints, and output format sections.

What tools should I include in an agent.md tools list?▼

Include only tools the agent's role requires: read and search for research agents, add edit for file authoring, and execute only when shell validation is needed. If the list contains execute, web, and agent together, the agent is likely doing too much and should be split.

When should user-invocable be true or false?▼

Set user-invocable to false for specialist subagents invoked by a parent orchestrator, and true for picker agents the user selects intentionally as a workflow entry point. Combining false with disable-model-invocation makes the agent unreachable.

Why is my Copilot agent failing to load?▼

Loading fails when the .agent.md filename does not exactly match the name field in frontmatter, or when YAML delimiters are missing or indented. Verify the filename is kebab-case without extension and that --- delimiters appear at the expected lines.

How do I stop an agent from triggering on unrelated queries?▼

Tighten the description field with specific trigger keywords and add an explicit Do NOT use for clause listing exclusions. Also confirm user-invocable is false for subagents that should only be invoked by parent agents.