configuration-reference

Document DeskAgent configuration files for system settings, AI backends, external APIs, and agents.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/deskagent-ai/community --skill configuration-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuration-reference
Source: https://github.com/deskagent-ai/community/tree/main/cowork-plugin/skills/config-reference
Command: npx skills add https://github.com/deskagent-ai/community --skill configuration-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires json, yaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill unit provides a comprehensive guide to DeskAgent's configuration files, aiding users in understanding and customizing the system settings, AI backends, external APIs, and agents.

Core Features & Use Cases

  • System Configuration: Offers detailed explanations and examples for system-wide settings like UI, logging, and email watchers.
  • AI Backends: Provides information on configuring and using various AI backends like Claude, Gemini, OpenAI, and Mistral.
  • External APIs: Covers the setup and usage of external APIs such as Billomat, UserEcho, and SEPA for integration with external services.
  • Agents Configuration: Explains how to define and manage agents within DeskAgent, including legacy agents.json and modern frontmatter-based configurations.

Quick Start

Use the configuration-reference skill to learn how to set up and customize your DeskAgent environment to suit your specific needs.

Frequently Asked Questions about configuration-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure AI backends like Claude, Gemini, or OpenAI in DeskAgent?

Configure AI backends in DeskAgent by modifying its modular configuration files. This reference provides detailed setup instructions and examples for integrating Claude, Gemini, OpenAI, and Mistral to customize your environment.

What is the best way to define and manage agents in DeskAgent?

Define and manage DeskAgent agents using modern frontmatter-based configurations or the legacy `agents.json` file. This reference explains both methods to help you set up and customize agent definitions effectively.

How do I set up external API integrations such as Billomat or SEPA?

Set up external API integrations for services like Billomat, UserEcho, and SEPA by editing DeskAgent configuration files. This guide provides the setup and usage instructions needed to connect with external APIs.

Can I customize system-wide settings like UI and logging using JSON or YAML?

Customize system-wide settings like UI, logging, and email watchers using JSON or YAML configuration files. This guide provides detailed explanations and examples to help you tailor DeskAgent's system settings to your needs.

Do I need to use YAML for DeskAgent configuration, or does it support JSON?

DeskAgent configuration supports both JSON and YAML formats. You can use either dependency to define system settings, AI backends, external APIs, and agents based on your preferred syntax for configuration management.