agent-builder

Create Claude Code agent files with YAML frontmatter and tool permissions.

1|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/bsamiee/Parametric_Portal --skill agent-builder-bsamiee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-builder
Source: https://github.com/bsamiee/Parametric_Portal/tree/main/.claude/skills/agent-builder
Command: npx skills add https://github.com/bsamiee/Parametric_Portal --skill agent-builder-bsamiee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies and standardizes the creation of Claude Code agents, eliminating manual configuration and ensuring consistent, discoverable, and effective AI agents. It saves time by guiding you through best practices for agent design and deployment.

Core Features & Use Cases

  • Declarative Agent Definition: Create agents with YAML frontmatter for clear names, descriptions, scoped tool permissions, and model selection.
  • Optimized Discovery: Craft compelling descriptions with "Use when" clauses and proactive triggers to maximize agent discoverability and auto-invocation.
  • Structured System Prompts: Design effective system prompts with clear role lines, numbered sections, and constraint markers to guide agent behavior.
  • Workflow-Driven Creation: Follow a 5-phase workflow (Understand, Acquire, Research, Author, Validate) to ensure research-informed and compliant agent creation.
  • Use Case: When you need a specialized agent for code review, use this Skill to define its name, description, tools (e.g., Read, Glob), model (e.g., sonnet), and system prompt, ensuring it's ready for deployment.

Quick Start

Use the agent-builder skill to create a new code-reviewer agent with Read and Glob tools, using the sonnet model, and a system prompt focused on identifying security vulnerabilities.

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 Claude agent with custom tools and system prompts?

Agent-builder lets you define Claude agents by creating YAML frontmatter files that specify agent name, description, scoped tool permissions (like Read or Glob), model selection (e.g., sonnet), and system prompt structure. This ensures agents are configured consistently and ready for deployment.

What's the best way to design system prompts for specialized agents?

Structure system prompts with clear role lines, numbered sections, and constraint markers to guide agent behavior effectively. Agent-builder follows a standardized composition approach that ensures your agent responds predictably to its intended use cases.

How do I make my Claude agent discoverable and auto-invoke in workflows?

Write compelling agent descriptions with "Use when" clauses and proactive triggers in your agent definition. Agent-builder guides you through crafting discovery metadata that maximizes when your agent is automatically invoked.

Can I scope which tools a Claude agent can access?

Yes, agent-builder lets you specify exactly which tools your agent can use through declarative tool permissions in the agent's YAML frontmatter, ensuring security and focused behavior for each specialized agent.

What workflow should I follow when building a new Claude agent?

Agent-builder provides a 5-phase workflow: Understand your agent's purpose, Acquire requirements, Research best practices, Author the agent configuration, and Validate against schema and trigger coverage. This ensures research-informed and compliant agent creation.

Do I need to manually validate my agent configuration files?

Agent-builder includes frontmatter schema validation as part of its workflow, checking that your agent configuration meets requirements for discovery triggers, tool scoping, and model alignment before deployment.