agent-artifex:design

Design AI agent tools with evidence-based principles for descriptions, parameters, and errors.

1|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/flexion/claude-domestique --skill agent-artifex-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-artifex:design
Source: https://github.com/flexion/claude-domestique/tree/main/agent-artifex/skills/design
Command: npx skills add https://github.com/flexion/claude-domestique --skill agent-artifex-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured, evidence-based approach to designing AI services, ensuring quality, reliability, and maintainability by adhering to proven design principles.

Core Features & Use Cases

  • Comprehensive Design Guidance: Covers critical areas like tool descriptions, parameter design, error messaging, system prompts, multi-turn conversations, tool set architecture, and response formats.
  • Evidence-Based Principles: Each design area is backed by empirical data and research, offering actionable insights and assessment criteria.
  • Use Case: A developer needs to design a new set of tools for an AI agent. They use this Skill to understand the best practices for writing clear tool descriptions, defining robust parameters, and structuring error messages that the AI can easily interpret and act upon, leading to a more reliable and effective agent.

Quick Start

Use the agent-artifex:design skill to learn about designing effective tool descriptions.

Frequently Asked Questions about agent-artifex:design

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

FAQPage Schema
How do I write effective tool descriptions for LLM agent development?

Effective tool descriptions for LLM agent development require clear, evidence-based principles that help the model accurately interpret tool functionality. This Skill provides structured guidance and empirical best practices for writing descriptions that improve AI service reliability and actionability.

What are the best practices for parameter and schema design in AI agents?

Parameter and schema design in AI agents should adhere to proven empirical principles to ensure robust system reliability. This Skill offers detailed, evidence-based guidance for defining parameters and constructing schemas that LLMs can easily interpret and process correctly.

How should I structure error messages for AI agent tools?

Error messages for AI agent tools should be structured to allow the LLM to easily interpret and act upon the failure. This Skill provides evidence-based design principles for constructing error messages that enable agents to recover autonomously and maintain multi-turn conversation flow.

What is the best way to design multi-turn conversation architecture for LLMs?

Multi-turn conversation architecture for LLMs is best designed using evidence-based principles that standardize response formats and tool set organization. This Skill delivers empirical guidance for structuring system prompts and managing complex agent interactions over multiple turns.

Do I need empirical research data to build high-quality AI services?

Building high-quality AI services relies heavily on empirical research data to ensure reliability and maintainability. This Skill supplies an evidence-based framework, integrating proven design principles for tool sets and prompt engineering, eliminating the need to gather research independently.