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 | TranslatedConversion type: TranslatedActively 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 | TranslatedConversion type: TranslatedActively 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 | TranslatedConversion type: TranslatedActively 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 | TranslatedConversion type: TranslatedActively 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 | TranslatedConversion type: TranslatedActively 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 | TranslatedConversion type: TranslatedActively 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 | TranslatedConversion type: TranslatedActively 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 | TranslatedConversion type: TranslatedActively 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 portableConversion type: Not portableUnique 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 portableConversion type: Not portableUnique 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 portableConversion type: Not portableUnique 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 |