CtrlK
BlogDocsLog inGet started
Tessl Logo

evolving-ai-agents

Provides guidance for automatically evolving and optimizing AI agents across any domain using LLM-driven evolution algorithms. Use when building self-improving agents, optimizing agent prompts and skills against benchmarks, or implementing automated agent evaluation loops.

69

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and well-structured, with executable examples, checklists, validation via the Gate phase, and clean one-level-deep references to a verified bundle. Its only real weakness is moderate verbosity from the redundant 'Usage Instructions for Agents' / 'Pro Tips' sections and the time-sensitive benchmark table.

Suggestions

Trim the 'Usage Instructions for Agents' and 'Pro Tips' sections, which largely restate guidance already covered in the workflows and configuration reference.

Move the model-specific benchmark-results table (e.g. 'Claude Opus 4.6: 79.4%') into references/releases.md to avoid time-sensitive clutter at the top of the overview.

DimensionReasoningScore

Conciseness

Mostly efficient with executable code and tight config references, but the 'Usage Instructions for Agents' section and 'Pro Tips'/'Warning Signs' repeat guidance from earlier sections, and the benchmark-results table at the top adds time-sensitive padding that could be tightened.

2 / 3

Actionability

Provides fully executable, copy-paste-ready code throughout — the three-line quick start, full EvolveConfig workflow, custom BenchmarkAdapter, and custom EvolutionEngine examples are concrete and complete.

3 / 3

Workflow Clarity

The five-phase evolution loop is clearly sequenced, each workflow opens with a 'Critical Requirements' checklist, and the Gate phase plus convergence settings provide explicit validation and rollback feedback for batch mutation operations.

3 / 3

Progressive Disclosure

The body is an overview that points to seven well-signaled, one-level-deep references (architecture.md, api.md, tutorials.md, etc.), all of which exist in ./references/, keeping detailed material out of SKILL.md.

3 / 3

Total

11

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, complete, and distinct, with an explicit 'Use when' trigger and concrete actions in correct third-person voice. Its main weakness is the technical 'LLM-driven evolution algorithms' jargon, which slightly limits natural trigger-term coverage.

Suggestions

Replace or supplement 'LLM-driven evolution algorithms' with more natural user-facing phrasing such as 'automatically improving agents through iterative mutation'.

Add common variation keywords a user might say, e.g. 'prompt optimization', 'agent self-improvement', or 'automated agent evaluation', to broaden trigger coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'evolving and optimizing AI agents', 'optimizing agent prompts and skills against benchmarks', and 'implementing automated agent evaluation loops' — rather than vague language.

3 / 3

Completeness

Clearly answers both 'what' ('Provides guidance for automatically evolving and optimizing AI agents...') and 'when' with an explicit 'Use when building self-improving agents...' clause.

3 / 3

Trigger Term Quality

Includes relevant natural phrases like 'self-improving agents' and 'optimizing agent prompts and skills against benchmarks', but 'LLM-driven evolution algorithms' is technical jargon and coverage of common user phrasings is incomplete.

2 / 3

Distinctiveness Conflict Risk

The agent-evolution-and-optimization niche is distinct from general agent-building skills and uses clear, specific triggers; third-person voice is used correctly.

3 / 3

Total

11

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
Orchestra-Research/AI-Research-SKILLs
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.