$npx -y skills add alfredxw/denova --skill agent-configUse when config_manager creates or updates Denova Agent page settings through agent config tools.
| 1 | # Agent Config |
| 2 | |
| 3 | Use this skill before calling `write_agent_configs`. |
| 4 | |
| 5 | ## Workflow |
| 6 | |
| 7 | 1. Call `list_agent_configs` first. It returns user, workspace, and effective Agent page settings in one response. |
| 8 | 2. Use `write_agent_configs` only for Agent page settings. Do not edit `config.toml` files directly. |
| 9 | 3. Always set `scope` explicitly to `user` or `workspace`. Use the scope requested by the user or shown by the current Agents page context. |
| 10 | 4. Preserve fields not requested by the user. For updates, copy the existing override from `list_agent_configs`, change only the requested fields, then send the complete replacement override. |
| 11 | 5. Delete or disable SubAgents only after the user clearly asked for it. |
| 12 | |
| 13 | ## Supported Operations |
| 14 | |
| 15 | - `set_agent_override`: replace one Agent override in the selected layer. |
| 16 | - `agent`: `default`, `ide`, `interactive_story`, `interactive_director`, `config_manager`, `version_summary`, `tool_agent`, `image`, `automation`, or `context_compaction`. |
| 17 | - Optional replacement sections: `model`, `tools`, `prompt`, `skills`, `context`. |
| 18 | - `set_general_sub_agent`: set or inherit the built-in General SubAgent switch. |
| 19 | - `agent`: `default`, `ide`, `interactive_story`, `config_manager`, or `automation`. |
| 20 | - `enabled`: `true` or `false`; omit/null to inherit. |
| 21 | - `upsert_sub_agent`: create or replace one custom SubAgent in the selected layer. |
| 22 | - Provide a complete `sub_agent` with `id`, `description`, and `system_prompt`. |
| 23 | - Use `enabled: false` with the same `id` to shadow an inherited SubAgent. |
| 24 | - `delete_sub_agent`: remove one custom SubAgent from the selected layer only. |
| 25 | - This does not delete SubAgents inherited from another layer. |
| 26 | |
| 27 | ## Field Notes |
| 28 | |
| 29 | - `agent_config_read` and `agent_config_write` are only meaningful for the Config Manager Agent and its configured SubAgents. |
| 30 | - A SubAgent cannot gain tools disabled on its parent Agent. Tool settings are upper bounds, not grants beyond the parent. |
| 31 | - `model.profile_id` must reference an existing model profile or be empty to inherit. This skill does not create model profiles. |
| 32 | - `prompt.flow_prompt` changes Denova flow rules for an Agent. `prompt.system_prompt` adds user custom rules. Neither can override runtime contracts, output protocols, tool permissions, or backend validation. |
| 33 | - Context compaction fields are ratios, not percentages: use `0.9` for 90%. |
| 34 | |
| 35 | ## Safe Defaults |
| 36 | |
| 37 | - Use `workspace` scope for book-specific Agent behavior and `user` scope for personal defaults across books. |
| 38 | - Prefer disabling one tool or one Skill over rewriting a full Agent prompt when the user asks for a capability boundary. |
| 39 | - Prefer a focused custom SubAgent with narrow tools over broad changes to the parent Agent. |