ULIS Field Reference

Auto-generated from Zod schemas. Do not edit manually — run bun run gen:reference to regenerate.

This document lists every field for each ULIS entity type. For narrative explanation of how entities relate and how the build pipeline works, see SPEC.md.

Indented rows are nested fields of the row above them. A <key> row stands for an arbitrary user-chosen key in a map. Types, defaults and constraints are derived from the schemas; descriptions appear only for fields the schema annotates.

Agent

YAML frontmatter of a file under agents/.

Field	Type	Required	Default	Constraints	Description
name	string			length 1–64, pattern ^(?!-)(?!.*--)(?!.*-$)[a-z0-9-]+$
description	string	✓
model	string — one of 69 values | string
temperature	number			≥ 0, ≤ 1
effort	"low" | "medium" | "high" | "max"
tools	object | string	✓
maxTurns	integer			> 0
background	boolean
isolation	"worktree" | "none"
memory	"user" | "project" | "local" | "none"
skills	string[]
hooks	object
PreToolUse	object[]
matcher	string
command	string	✓
PostToolUse	object[]
matcher	string
command	string	✓
Stop	object[]
command	string	✓
mcpServers	string[]
contextHints	object
maxInputTokens	number			> 0
excludeFromContext	string[]
priority	"low" | "normal" | "high"		"normal"
toolPolicy	object
prefer	string[]
avoid	string[]
requireConfirmation	string[]
security	object
permissionLevel	"readonly" | "readwrite" | "full"		"readwrite"
blockedCommands	string[]
restrictedPaths	string[]
requireApproval	"write" | "edit" | "bash" | "agent" | "mcp"[]
rateLimit	object
perHour	number	✓		> 0
color	string — one of 8 values
tags	string[]		[]
platforms	object
claude	object
enabled	boolean		true
model	string — one of 25 values | string
permissionMode	"default" | "auto" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "plan"
disallowedTools	string[]
initialPrompt	string
opencode	object
enabled	boolean		true
model	string — one of 21 values | string
mode	"primary" | "subagent" | "all"		"subagent"
top_p	number			≥ 0, ≤ 1
rate_limit_per_hour	number
permission	object
edit	"ask" | "allow" | "deny"
bash	"ask" | "allow" | "deny"
hidden	boolean
disable	boolean
codex	object
enabled	boolean		true
model	string — one of 9 values | string
sandbox_mode	string
model_reasoning_effort	string
nickname_candidates	string[]
mcp_servers	object — map of any
<key>	any
cursor	object
enabled	boolean		true
model	string — one of 26 values | string
readonly	boolean
is_background	boolean
forgecode	object
enabled	boolean		true
model	string
provider	string
temperature	number			≥ 0, ≤ 2
top_p	number			≥ 0, ≤ 1
top_k	integer			≥ 1, ≤ 1000
max_tokens	integer			≥ 1, ≤ 100000
max_turns	integer			> 0
max_requests_per_turn	integer			> 0
max_tool_failure_per_turn	integer			> 0
tool_supported	boolean
user_prompt	string
reasoning	object
enabled	boolean
effort	"low" | "medium" | "high"
max_tokens	integer			> 0
exclude	boolean

Skill

YAML frontmatter of skills/<name>/SKILL.md.

Field	Type	Required	Default	Constraints	Description
key	string
name	string	✓		length 1–64, pattern ^(?!-)(?!.*--)(?!.*-$)[\p{Ll}\p{Nd}-]+$
description	string	✓		length 1–1024
license	string
compatibility	string			length 1–500
metadata	object — map of string
<key>	string
allowed-tools	string
argumentHint	string
userInvocable	boolean		true
allowModelInvocation	boolean		true
allowImplicitInvocation	boolean		true
model	string — one of 69 values | string
effort	"low" | "medium" | "high" | "max"
isolation	"fork" | "none"
tools	object | string
hooks	object
PreToolUse	object[]
matcher	string
command	string	✓
PostToolUse	object[]
matcher	string
command	string	✓
Stop	object[]
command	string	✓
paths	string | string[]
category	string
tags	string[]		[]
version	string
platforms	object
claude	object
enabled	boolean		true
model	string — one of 25 values | string
shell	"bash" | "powershell"
opencode	object
enabled	boolean		true
model	string — one of 21 values | string
codex	object
enabled	boolean		true
model	string — one of 9 values | string
displayName	string
shortDescription	string
iconSmall	string
iconLarge	string
brandColor	string
defaultPrompt	string
mcpDependencies	object[]
type	"mcp"	✓
value	string	✓
description	string
transport	string
url	string
cursor	object
enabled	boolean		true
model	string — one of 26 values | string
forgecode	object
enabled	boolean		true
model	string

MCP Config

Fields of mcp.yaml.

Field	Type	Required	Default	Constraints	Description
servers	object — map of object		{}
<key>	object
type	"local" | "remote"	✓
transport	"http" | "sse"
url	string
command	string
args	string[]
env	object — map of string
<key>	string
headers	object — map of string
<key>	string
localFallback	object
command	string	✓
args	string[]	✓
enabled	boolean
disabled	boolean
targets	string[]

Skills Config

Fields of skills.yaml.

Field	Type	Required	Default	Constraints	Description
*	object
skills	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]				Command-line fragments; each item may contain an option and its value.
claude	object
skills	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]				Command-line fragments; each item may contain an option and its value.
opencode	object
skills	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]				Command-line fragments; each item may contain an option and its value.
codex	object
skills	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]				Command-line fragments; each item may contain an option and its value.
cursor	object
skills	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]				Command-line fragments; each item may contain an option and its value.
forgecode	object
skills	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]				Command-line fragments; each item may contain an option and its value.

Extensions Config

Fields of extensions.yaml.

Field	Type	Required	Default	Constraints	Description
*	object
extensions	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]
claude	object
extensions	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]
opencode	object
extensions	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]
codex	object
extensions	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]
cursor	object
extensions	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]
forgecode	object
extensions	object[]		[]
key	string
name	string	✓		pattern ^[^-\s]\S*$
args	string[]

Preset metadata

Fields of preset.yaml at the root of a preset source. Display metadata only.

Field	Type	Required	Default	Constraints	Description
name	string
description	string
version	integer