Markdown Agent Definitions
Create and modify your agents with a simple text file. No code required.
Defining an AI agent shouldn't require programming skills. With EasyClaw v2, an agent's personality, capabilities, and rules are defined in a standard Markdown file.
The definition file contains everything that makes the agent's identity: its name, personality, system instructions, available tools, behavior rules, and limits.
Modifying an agent becomes as simple as editing a document. Changes take effect immediately, with no restart or redeployment needed.
Creation
You create a Markdown file with standardized sections: identity, personality, instructions, tools, rules, limits.
Loading
EasyClaw reads the file at agent startup and builds the system prompt from its contents.
Sections
Each Markdown section (h2) corresponds to an aspect of the agent. Unknown sections are ignored for future compatibility.
Inheritance
An agent can inherit from another by referencing its file. Only redefined sections are replaced.
Hot reload
File modifications are detected and applied without interrupting ongoing sessions.
Non-technical team
A project manager defines a specialized agent for deliverable tracking by writing instructions in natural language in a Markdown file.
Rapid iteration
During agent development, the team modifies its personality and rules multiple times a day. The Markdown format makes these iterations instant.
Versioning
Agent definitions are versioned with Git like any configuration file. You can revert to a previous version and compare changes.
# Agent: Financial Analyst ## Personality You are a rigorous and methodical financial analyst. You favor factual data over opinions. ## Instructions - Always cite data sources - Present figures with 2 decimal places - Include a "Risks" section in every analysis ## Tools - search: Web search - calculator: Financial calculation - sheets: Google Sheets access ## Limits - Never give personal investment advice
- Available for all EasyClaw v2 agents
- Standard format documented in the toolkit
- Compatible with agent inheritance and composition