agent-frontmatter-reference

Configure DeskAgent agents using Markdown with JSON frontmatter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a comprehensive reference guide for configuring DeskAgent agents using Markdown and JSON frontmatter, helping users understand and implement various options and features.

Core Features & Use Cases

  • Detailed Reference Guide: Explains the full set of frontmatter options and their uses in DeskAgent agent configuration.
  • Format and Options Overview: Includes an overview of the required YAML format, common frontmatter options, and their descriptions.
  • Use Case: New users or developers who are unfamiliar with DeskAgent agent configuration can refer to this guide to understand and apply the correct syntax and settings for creating efficient and secure agents.

Quick Start

To create a new DeskAgent agent, follow the guide in 'cowork-plugin/skills/agent-frontmatter-reference/SKILL.md'.

Frequently Asked Questions about agent-frontmatter-reference

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

FAQPage Schema
How do I configure a DeskAgent agent using Markdown and JSON frontmatter?

To configure a DeskAgent agent, you write Markdown files with JSON frontmatter to define categories, descriptions, icons, AI backends, security settings, and knowledge bases. This reference guide explains the required YAML format and available options for local AI workflows.

What frontmatter options are available for DeskAgent agent configuration?

DeskAgent frontmatter options include categories, descriptions, icons, AI backends, security settings, and knowledge base configurations. These options are written in a required YAML format within the Markdown file to control agent behavior.

Does DeskAgent require specific syntax for local AI agent setup?

Yes, DeskAgent requires a specific YAML format for JSON frontmatter within Markdown files to properly configure local AI agents. This syntax ensures the system correctly parses categories, AI backends, and security settings.

Can I set security settings and knowledge bases when creating a DeskAgent agent?

Yes, you can define security settings and configure knowledge bases directly within the JSON frontmatter of your Markdown file. The reference guide details how to apply these options to ensure efficient and secure agent operation.

What is the best way to start building a local AI agent with DeskAgent?

The best way to start is by following the quick start guide located in 'cowork-plugin/skills/agent-frontmatter-reference/SKILL.md', which provides the foundational Markdown and JSON frontmatter syntax needed for DeskAgent configuration.

Why are my DeskAgent agent configurations not applying correctly?

DeskAgent configurations often fail due to incorrect YAML format in the JSON frontmatter. Ensure your Markdown file strictly follows the required syntax for categories, descriptions, and AI backends outlined in the reference guide.