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 |
| 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. |
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 system prompt, model preference, and tooling policy |
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; droids enabled by default with live progress reporting in UI |
model_selection | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | per-droid model preference field independent of global model setting; enables mixed-model agent compositions |
| 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 independent of the global setting, enabling mixed-model agent compositions. |
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; /import-subagent converts Claude Code .claude/agents/*.md to droid format |
tool_restrictions | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | categorical tool policy using named categories (filesystem, shell, search, browser, web_fetch); differs from per-tool allowlists used by other providers |
| 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 categories (filesystem, shell, search, browser, web_fetch) instead of per-tool allowlists. |
| Claude Code Subagent Import | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | The /import-subagent slash command converts .claude/agents/*.md files to Factory droid format for migration. |
| 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 |