skills.rest
swcstudiospace
swcstudiospaceOFFICIAL
Explore all skills by this author →
Website𝕏@govantarcticaGitHub

create-agent

Create custom AI agents as Markdown files with YAML frontmatter for aimee-codes.

Updated Aug 19, 2026
Search Tags:#markdown#prompt engineering#agent creation#yaml frontmatter#ai configuration#cli agents#aimee
One-click install
npx skills add https://github.com/swcstudiospace/aimeecodes --skill create-agent-swcstudiospace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-agent
Source: https://github.com/swcstudiospace/aimeecodes/tree/main/.aimee/skills/create-agent
Command: npx skills add https://github.com/swcstudiospace/aimeecodes --skill create-agent-swcstudiospace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Defining new specialized AI agents for the aimee-codes CLI requires a precise file format with mandatory YAML frontmatter fields and a structured instruction body; this Skill guides the creation of valid agent files that aimee can discover and load. ## Core Features & Use Cases - Agent File Authoring: Produces complete agent .md files with all required frontmatter fields (id, title, description, reasoning, tools, user_prompt) placed in the .aimee/agents directory. - Templates and Patterns: Provides ready-made templates for implementation, research, and planning agent types, plus tool-selection guidelines and naming conventions. - Validation Guidance: Includes a checklist and common-mistake examples to catch invalid YAML, missing fields, wrong file locations, and inappropriate tool assignments. - Use Case: You want a code-review agent for your project; use this Skill to generate a code-reviewer.md file with read-only tools, core principles, and clear limitations, saved where aimee will discover it. ## Quick Start Create a new aimee agent named code-reviewer that analyzes code quality using only read and search tools.

Frequently Asked Questions about create-agent

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

FAQPage Schema
How do I create a custom agent for aimee-codes?▼

Create a Markdown file named after the agent id in the .aimee/agents directory of your project. Include YAML frontmatter with id, title, description, reasoning, tools, and user_prompt fields, followed by a body describing the agent's principles, capabilities, and limitations.

Where should aimee agent files be placed?▼

Agent files must be placed in the .aimee/agents directory under the current working directory of your project. Files placed anywhere else will not be discovered or loaded by aimee.

What tools can an aimee agent use?▼

Available tools include sem_search, fs_search, read, write, patch, undo, remove, shell, fetch, skill, sage, and mcp_* wildcards for MCP tools. Choose tools based on agent type: implementation agents need write and shell, while research agents should be read-only.

Why is my custom aimee agent not loading?▼

Common causes are a file outside the .aimee/agents directory, a filename that does not match the agent id, invalid YAML frontmatter, or missing required fields like user_prompt. Validate the YAML syntax and confirm all six required fields are present.

What is the difference between implementation, research, and planning agents?▼

Implementation agents modify code using write, patch, and shell tools. Research agents are strictly read-only for codebase analysis. Planning agents create checkbox-formatted plans in Markdown files but do not implement changes.

Related Skills

Explore More Software Engineering Skills→
prototypdigitalprototypdigital

create-agent

Create specialized project agents with tools and responsibilities in the llm/agents/ directory.

Official
Advanced
ghufronbagaskaraghufronbagaskara

opencode

Delegate software engineering tasks to autonomous AI coding agent via CLI/TUI interfaces.

Community
Advanced
bbvch-aibbvch-ai
9

create-or-audit-subagent

Create or audit codebase-specific subagents in the .claude/agents directory.

Official
Advanced
heydemouraheydemoura

opencode

Configure and manage OpenCode AI coding agent settings, agents, commands, MCP servers, providers, skills, and permissions.

Community
Advanced