generic-agent-creator-structure

Standardizes agent file structure, naming, and placement in the `agents/` directory.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/Puzzle9900/puzzle9900-claude-plugin --skill generic-agent-creator-structure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generic-agent-creator-structure
Source: https://github.com/Puzzle9900/puzzle9900-claude-plugin/tree/main/skills/generic-agent-creator-structure
Command: npx skills add https://github.com/Puzzle9900/puzzle9900-claude-plugin --skill generic-agent-creator-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures consistency and adherence to project standards for all agent files, simplifying agent creation, review, and maintenance.

Core Features & Use Cases

  • Defines Agent File Structure: Provides a clear template for agent files, including frontmatter and content sections.
  • Enforces Naming Conventions: Outlines a strict naming pattern for agent files based on domain, platform, and concern.
  • Specifies Folder Structure: Dictates that all agents reside as flat files in the agents/ directory.
  • Use Case: When creating a new agent for reviewing API specifications, use this Skill to ensure the file is named correctly (e.g., generic-api-spec-reviewer.md), placed in the agents/ directory, and includes all required sections like Identity, Knowledge, and Instructions.

Quick Start

Ensure your new agent file follows the structure and naming conventions outlined in the generic-agent-creator-structure skill.

Frequently Asked Questions about generic-agent-creator-structure

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

FAQPage Schema
What is the standard file structure for agent definitions in a project?

The standard agent file structure enforces a flat directory layout within the `agents/` folder. It mandates specific naming conventions and requires mandatory content sections like Identity, Knowledge, and Instructions for each agent definition file.

How do I name agent files to follow strict naming conventions?

Agent files must follow a strict naming pattern based on domain, platform, and concern. For example, a generic API specification reviewer agent should be named `generic-api-spec-reviewer.md` to maintain project consistency.

How do I create a project-agnostic generic agent file?

To create a project-agnostic generic agent, place a flat markdown file in the `agents/` directory. Ensure the file includes mandatory frontmatter and content sections such as Identity, Knowledge, and Instructions as defined by the structure standard.

Does this agent structure standard require a specific folder hierarchy?

No, the agent structure standard specifies a flat file structure. All agent files must reside directly in the `agents/` directory without nested subfolders to simplify creation, review, and maintenance.

What are the required content sections for an agent definition file?

Required content sections for an agent definition file include Identity, Knowledge, and Instructions. These mandatory sections ensure the agent has a clear template and adheres to project standards for generic agents.

Why standardize agent file naming and folder placement?

Standardizing agent file naming and folder placement ensures consistency and adherence to project standards. This practice simplifies agent creation, code review, and long-term maintenance across different generic agents.