create-agent

The create-agent skill provides a robust architectural framework for developers building AI agents using the gitagent standard. It serves as an authoritative guide for scaffolding new agent projects, ensuring that your configuration files like agent.yaml, SOUL.md, and RULES.md adhere to best practices for maintainability and scalability. This skill is essential for developers looking to define precise model constraints, runtime behaviors, and complex sub-agent delegation patterns within a git-native environment. By leveraging this tool, you can ensure your project structure is optimized for the gitagent ecosystem, including proper placement of skills, tools, and knowledge repositories.

• Guided configuration of agent.yaml specifying model preferences, fallbacks, and runtime parameters like temperature, max_turns, and timeout limits.

• Automated generation of identity-focused files, including SOUL.md to define core persona and RULES.md to establish hard boundaries and interaction constraints.

• Standardized directory scaffolding for skills/ and tools/ modules, ensuring correct registration for discovery and execution.

• Seamless integration support for sub-agent definitions, enabling complex, multi-agent workflows through clear delegation modes and trigger mechanisms.

• Integrated guidance on adding knowledge/index.yaml documentation, allowing you to load reference files and markdown contexts directly into the system prompt.

• Best-practice enforcement for README.md generation, ensuring every agent project includes executable install instructions, structure diagrams, and registry links.

• Always start by defining your core agent identity in SOUL.md before adding specialized skills or knowledge.

• Use the validate command frequently after modifying configuration files to catch schema errors in agent.yaml or structural inconsistencies.

• Ensure your skills/ directories follow the SKILL.md format to be compatible with registry discovery and cross-project reusability.

• When defining tools, map them strictly to their respective yaml files in the tools/ directory to prevent runtime resolution errors.

• The tool is designed to work exclusively within the gitagent CLI context; it does not handle external application code logic outside of agent orchestration.