Scaffold Agent

The Scaffold Agent is a built-in agent that helps you create and edit agents, skills, and commands using natural language — no manual YAML editing required.

What it does

• Create new custom agents, skills, or commands from a simple description
• Edit existing agents, skills, or commands
• List all your agents, skills, and commands
• Delete agents, skills, or commands
• Reorder agents in the dropdown by maintaining agents/agent-order.txt

How to use it

1. Open the Peon AI view
2. Select Scaffold from the agent dropdown
3. Ask it to create, edit, or list your artifacts

Example prompts

Create a CodeReviewer agent with grep and read tools

Create a skill called "Search Files" that finds files by pattern

List all my skills

Edit the CodeReviewer agent to also have the write tool

Put my CodeReviewer agent at the top of the dropdown

How it works

The scaffold agent uses config-scoped disk tools to read and write files in your Peon AI config directory. After creating or editing any artifact, it calls reloadConfig() to make the changes immediately available — no restart needed.

No restart needed

Changes are picked up instantly. The scaffold agent triggers a config reload after every create/edit operation.

Config directory must be set

The scaffold agent requires a valid config directory. Set it in Preferences → Peon AI → Configuration → Config Directory.