Factory Droid — Agents
- File format
- Markdown
- Discovery path
-
.factory/droids - Global install path
-
~/.factory/droids - Syllago install method
- Symlink, Direct copy
- Symlink support
- Yes
- Native frontmatter fields
-
name,description,model,tools
Features
How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.
Other features
Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.
| Feature | Conversion | Summary |
|---|---|---|
agent_scopes | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | project (.factory/droids/) overrides personal (~/.factory/droids/) on name collision — reverse of skills precedence; top-level files only, no recursion |
| Custom Droid Format | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Agents are flat .md files in .factory/droids/ (project) or ~/.factory/droids/ (personal); top-level scan only, no recursion. Frontmatter fields: name (required, lowercase/digits/-/_), description (optional, ≤500 chars), model, reasoningEffort, tools. |
definition_format | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | .md files in .factory/droids/ (project) or ~/.factory/droids/ (personal); single-file with YAML frontmatter (name, description, model, reasoningEffort, tools) and system prompt body |
invocation_patterns | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | exposed as subagent_type targets for the Task tool; primary assistant delegates mid-session; droids enabled by default with live progress streaming in UI |
model_selection | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | model field accepts inherit (use parent session model) or a specific model identifier; custom BYOK models use custom: prefix; reasoningEffort (low/medium/high) is an additional per-droid field ignored when model is inherit |
| Per-Droid Model Selection | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Each droid declares its own model preference (inherit or specific model ID; custom BYOK via custom: prefix) independent of the global setting, plus an optional reasoningEffort field (low/medium/high, ignored when model is inherit). |
subagent_spawning | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | droids exposed as subagent_type targets for Task tool delegation; /droids menu (I key) imports Claude Code .claude/agents/*.md to droid format with field mapping and model family translation |
tool_restrictions | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | tools field accepts a category string (read-only, edit, execute, web, mcp), an explicit array of tool IDs (["Read", "Edit", "Execute"], case-sensitive), or omission for all tools; TodoWrite is automatically included for all droids |
| Tool Categories | Conversion type: No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → | Droids restrict tools by named category strings (read-only → Read/LS/Grep/Glob; edit → Create/Edit/ApplyPatch; execute → Execute; web → WebSearch/FetchUrl; mcp → dynamically populated MCP tools) or explicit tool ID arrays. TodoWrite is automatically included for all droids. When using Edit with OpenAI models, ApplyPatch is automatically included. |
| Claude Code Subagent Import | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | The /droids UI (press I) imports .claude/agents/*.md files from both project and personal scopes to Factory droid format; maps agent name → droid name, description → droid description, instructions → system prompt body, model families (inherit→inherit, sonnet→first Sonnet, etc.). Invalid tools listed with a warning; common remaps: Write → Edit/Create, BrowseURL → WebSearch/FetchUrl. |
| Droids Management UI | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | /droids slash command opens a modal with list of droids (name, model, description, location badge, tools summary), a Create wizard (description, system prompt, identifier, model, tools), an Import from Claude Code option, and View/Edit/Delete/Reload actions. CLI normalizes filenames to lowercase-hyphenated on save. |
| Project-Over-Personal Precedence | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | Project-scope droids override personal droids of the same slug — the reverse of skills precedence. |
Sources
| Source |
|---|
| https://docs.factory.ai/cli/configuration/custom-droids |