agent-authoring

Create, edit, and review agent files in .claude/agents/ with standardized frontmatter.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/anicdh/agstack --skill agent-authoring-anicdh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-authoring
Source: https://github.com/anicdh/agstack/tree/main/.claude/skills/agent-authoring
Command: npx skills add https://github.com/anicdh/agstack --skill agent-authoring-anicdh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Agent Authoring Guide standardizes how Claude agents are defined, edited, and reviewed, ensuring consistency, safety, and clarity across agent files stored under .claude/agents/.

Core Features & Use Cases

  • Standard Agent File Structure: enforces a consistent frontmatter, required reading order, and a reusable template for agent metadata.
  • Governance & Quality: provides a quality checklist, anti-pattern guidance, branch strategy, and live state sections to track progress.
  • Reuse & Collaboration: promotes shared guidelines and design principles to reduce duplication and improve collaboration.

Quick Start

Create or update an agent file under .claude/agents/ using the Agent File Structure and Required Reading guidelines.

Frequently Asked Questions about agent-authoring

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

FAQPage Schema
How do I create a standardized Claude agent file structure for my team?

Agent governance prevents unsafe or unclear agent behavior by applying a quality checklist, anti-pattern guidance, and live state documentation to track progress. These governance rules ensure safety and clarity across all agent definitions stored under .claude/agents/.

What should be included in agent file metadata to ensure quality and consistency?

Agent file metadata should include a standardized frontmatter with name and description, a required reading order, quality checklists, anti-patterns, and live state sections. Including these elements ensures consistency, safety, and clarity across all defined agents.

How do I review and edit existing Claude agents to avoid anti-patterns?

To review and edit Claude agents, apply the provided quality checklist and anti-pattern guidance to evaluate agent files in .claude/agents/. Use the live state sections to track progress and ensure dependencies and structure meet standardized governance rules.

Can I use a shared template to reduce duplication when authoring multiple agents?

Yes, you can use a reusable template for agent metadata to promote shared guidelines and design principles. This reduces duplication and improves collaboration across teams building and maintaining multiple agents within .claude/agents/.

When should I establish a required reading order for my Claude agents?

You should establish a required reading order whenever your team is building multiple agents that depend on shared guidelines. Setting a reading order ensures consistent structure, safe execution, and clear dependencies across all agent definitions.