evaluate-instructions

Evaluate AI agent instruction files against an academic rubric.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/EATSTEAK/dotagents --skill evaluate-instructions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evaluate-instructions
Source: https://github.com/EATSTEAK/dotagents/tree/main/skills/evaluate-instructions
Command: npx skills add https://github.com/EATSTEAK/dotagents --skill evaluate-instructions

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of creating high-quality, effective instructions for AI agents, ensuring they perform optimally and safely.

Core Features & Use Cases

  • Quality Assessment: Evaluates agent instruction files against 20 academic papers and official guides, providing a quantitative score across 8 critical categories (Structure, Clarity, Context, Reasoning, Feedback, Safety, Agentic, Evolution).
  • Actionable Recommendations: Identifies specific weaknesses and provides concrete suggestions for improvement, prioritizing impact.
  • Automated Improvement: Can initiate a self-improvement cycle based on the evaluation results.
  • Use Case: A developer has written a complex set of instructions for a new AI coding agent. They use this Skill to get an objective quality score and detailed feedback on how to make the instructions clearer, safer, and more effective before deploying the agent.

Quick Start

Evaluate the quality of the agent instructions found in the file '/path/to/your/AGENTS.md'.

Frequently Asked Questions about evaluate-instructions

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

FAQPage Schema
How do I evaluate the quality of AI agent instructions?

Evaluating AI agent instructions involves scoring them across eight categories like structure, clarity, context, reasoning, and safety. This yields a quantitative score and actionable recommendations to refine agent behavior and performance.

What makes effective prompt engineering for agentic capabilities?

Effective prompt engineering for agentic capabilities requires clear structure, defined reasoning steps, safety constraints, and feedback mechanisms. Evaluating these elements against academic research ensures instructions perform optimally and safely.

How do I refine and improve AI agent instruction files?

Refine AI agent instruction files by identifying specific weaknesses through quality assessment and applying prioritized, concrete suggestions for improvement. This can initiate an automated self-improvement cycle based on evaluation results.

Does assessing instruction tuning require specific dependencies or environments?

Assessing instruction tuning requires no external dependencies. You simply provide your agent instruction file, and the skill evaluates it against academic best practices to generate a quality score and feedback.

What is the best way to score code quality in AI agent prompts?

The best way to score code quality in AI agent prompts is using a comprehensive rubric derived from academic research. This evaluates structure, context evolution, and reasoning to provide an objective, quantitative measure.

Why do my AI agent instructions perform poorly despite detailed context?

AI agent instructions may perform poorly if they lack robust feedback mechanisms, safety constraints, or proper reasoning steps. A quality assessment can identify these specific weaknesses and provide prioritized recommendations for improvement.