agent-definition

Create and configure DEVS platform AI agents using YAML and JSON definitions.

52|1|Updated Aug 2, 2025
One-click install
npx skills add https://github.com/codename-co/devs --skill agent-definition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-definition
Source: https://github.com/codename-co/devs/tree/main/.github/skills/agent-definition
Command: npx skills add https://github.com/codename-co/devs --skill agent-definition

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides comprehensive guidance on creating, configuring, and managing AI agents within the DEVS platform, streamlining the process of defining agent behavior and capabilities.

Core Features & Use Cases

  • Agent Configuration: Learn how to structure agent definitions using YAML/JSON, including essential fields like id, name, icon, role, and instructions.
  • Instruction Best Practices: Follow detailed guidelines for writing effective agent instructions, covering identity, expertise, behavior, output format, and constraints.
  • Use Case: A user wants to create a new "Code Reviewer" agent. They can consult this Skill to understand the YAML structure, best practices for writing instructions that guide the agent to identify potential bugs and suggest improvements, and how to add it to the agent manifest.

Quick Start

Use the agent-definition skill to generate a YAML template for a new AI agent.

Frequently Asked Questions about agent-definition

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

FAQPage Schema
How do I define an AI agent using YAML?

To define an AI agent using YAML, you structure a template with essential fields like `id`, `name`, `icon`, `role`, and `instructions`. This configuration specifies the agent's persona and capabilities for the platform.

What should be included in AI agent instructions?

AI agent instructions should include guidelines for identity, expertise, behavior, output format, and constraints. Writing effective instructions ensures the custom persona accurately performs its specific role and capabilities.

How do I configure agent internationalization and slugs?

Configuring agent internationalization and slugs involves updating the agent manifest and generating appropriate slug identifiers. This process ensures custom AI personas are correctly registered and localized.

What temperature guidelines should I follow for AI agent configuration?

Temperature guidelines for AI agent configuration dictate the randomness of the model's responses. Adjusting the temperature parameter in the YAML definition tunes the agent's behavior to be more focused or creative.

Can I use JSON instead of YAML for AI agent definitions?

Yes, you can use JSON instead of YAML for AI agent definitions. The Skill guides users in creating and configuring agents using both YAML and JSON formats to define behavior and capabilities.

Where are AI agent definition files located?

AI agent definition files are located in specific agent file locations within the platform directory. The Skill provides comprehensive guidance on where to place these YAML and JSON files for proper integration.