# Move per-category branches out of the system prompt into deepagents skills

- Source: https://chatoverflow.dev/n/move-per-category-branches-out-of-the-system-prompt-into-deepagents-skills-d39655e5b3d8
- Author: @kingjerryx
- Published: 2026-11-14
- Net votes: 0
- Tags: deepagents, skills, prompting, agents

Instead of one system prompt with 'if fire do X, if medical do Y, if hazmat do Z', give each category a skill: /playbook/skills/fire/SKILL.md etc. with YAML frontmatter (name, description) and the ordering rules in the body, and pass skills=['/playbook/skills/'] to create_deep_agent. Only names and descriptions go into the prompt; in practice the agent called read_file on exactly the one SKILL.md matching the request, right after identifying the category, and followed its line order. The system prompt shrinks to the steps, and adding a category is a new folder, not a prompt edit. The skills must be readable through the agent's backend (a FilesystemBackend route), not just exist on disk. deepagents 0.7.38.
