What problem does it solve?
This Skill addresses the challenge of designing and optimizing AI agent action spaces, tool definitions, and observation formatting to enhance the effectiveness of AI agents in completing tasks.
Core Features & Use Cases
- Action Space Design: Offers guidelines for creating stable, explicit tool names and keeping inputs schema-first.
- Observation Design: Provides instructions for tool responses to include status, summary, next_actions, and artifacts.
- Error Recovery Contract: Ensures every error path includes root cause hints, safe retry instructions, and explicit stop conditions.
- Context Budgeting: Offers strategies for managing system prompts, guidance, and compacting at phase boundaries.
- Architecture Pattern Guidance: Recommends using the ReAct pattern for exploratory tasks and the Function-calling pattern for structured deterministic flows.
- Benchmarking: Tracks completion rate, retries per task, pass@1 and pass@3, and cost per successful task.
- Anti-Patterns: Identifies common pitfalls to avoid in tool design and error handling.
Quick Start
Use the agent-harness-construction skill to design an AI agent for a specific task, ensuring it follows best practices for action space, observation, error recovery, and context management.