agents-best-practices

Design provider-neutral agent architectures with loops, tools, and MCP connectors.

Updated Mar 26, 2025
One-click install
npx skills add https://github.com/ricardoalt1515/.config --skill agents-best-practices-ricardoalt1515
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-best-practices
Source: https://github.com/ricardoalt1515/.config/tree/main/agents/skills/agents-best-practices
Command: npx skills add https://github.com/ricardoalt1515/.config --skill agents-best-practices-ricardoalt1515

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides guidance and best practices for designing, generating MVP blueprints for, auditing, refactoring, or explaining agentic harnesses across various domains.

Core Features & Use Cases

  • Provider-Neutral Architecture: Offers advice on agent architecture for OpenAI, Anthropic, and OpenAI-compatible APIs.
  • Agent Loop Design: Assists in creating model-instruction loops with validation, authorization, execution, and observation.
  • MCP/External Connectors: Guidance on integrating Agent Skills, reusable workflows, and external connectors.
  • Observability & Evaluations: Best practices for ensuring safety, latency, and observability.
  • Use Case: When developing an agentic harness, this Skill aids in creating a minimal viable product (MVP) that meets specific objectives while adhering to safety and observability standards.

Quick Start

To design an MVP agent harness for a specific domain, use the skill to generate a blueprint following the provided guidelines and references.

Frequently Asked Questions about agents-best-practices

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

FAQPage Schema
How do I design an agentic harness architecture that works across different LLM providers?

To design provider-neutral agent architectures, you need to implement model-instruction loops with validation, authorization, execution, and observation layers. This approach supports OpenAI, Anthropic, and OpenAI-compatible APIs while maintaining consistent agentic harness behavior.

What is the best way to integrate MCP and external connectors into an AI agent loop?

Integrating MCP and external connectors involves configuring reusable workflows and agent skills within the execution phase of your agent loop. This setup allows the harness to interact with external tools dynamically while maintaining strict permissions and observability.

How do I create an MVP blueprint for a domain-specific AI agent?

Creating an MVP blueprint for a domain-specific AI agent requires defining the core agent loop, tool design, memory, and planning components. You then map these to specific domain objectives while ensuring baseline safety and observability standards are met.

Does this approach to agent architecture support safety evaluations and latency monitoring?

Yes, agent architecture design must include observability and evaluation practices to ensure safety and monitor latency. By embedding evaluation checkpoints within the agent loop, you can audit agentic harnesses for safe execution and performance bottlenecks.

Can I use this method to audit and refactor existing agentic harnesses?

Yes, you can audit and refactor existing agentic harnesses by applying best practices for agent loop design, permissions, and memory. This process identifies architectural flaws and aligns the harness with safety, observability, and provider-neutral standards.

What are the limitations of using provider-neutral agent architectures for complex planning?

Provider-neutral agent architectures can face limitations in complex planning when relying on model-specific features for reasoning or tool use. If your harness requires deep integration with proprietary model capabilities, a strictly provider-neutral design may restrict advanced agentic behaviors.