docs: add SKILL.md for Claude Code agent integration#433
Open
DavyMorgan wants to merge 5 commits intoalgorithmicsuperintelligence:mainfrom
Open
docs: add SKILL.md for Claude Code agent integration#433DavyMorgan wants to merge 5 commits intoalgorithmicsuperintelligence:mainfrom
DavyMorgan wants to merge 5 commits intoalgorithmicsuperintelligence:mainfrom
Conversation
Add a Claude Code skill file that provides comprehensive agent instructions for using OpenEvolve. This makes the tool ready-to-use for AI coding agents by documenting the full workflow: scaffolding experiments, writing evaluators, configuring evolution, running jobs, inspecting checkpoints, and retrieving evolved programs. The skill file uses YAML frontmatter (name, description) so that Claude Code can automatically discover and activate it when users ask about evolutionary code optimization. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Adds a Claude Code “skill file” (SKILL.md) intended to teach agents how to use OpenEvolve as an end-user tool (scaffolding experiments, writing evaluators, configuring/running evolution, resuming from checkpoints, and inspecting results).
Changes:
- Add root-level
SKILL.mdwith YAML frontmatter for Claude Code discovery. - Document end-to-end OpenEvolve workflow, including CLI/API usage, configuration patterns, troubleshooting, and built-in examples.
You can also share your feedback on Copilot code review. Take the survey.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
- Fix core concepts: config.yaml is optional, not required - Clarify EVOLVE-BLOCK markers are LLM guidance, not enforced by the tool - Fix fitness description: excludes MAP-Elites feature dimensions - Remove non-numeric error field from evaluator example metrics dict - Fix checkpoint structure: programs are .json, add best_program.py and best_program_info.json, add artifacts/ directory - Fix output paths to be consistent (my_experiment/output throughout) - Point to best_program.py instead of programs/<id>.py for result retrieval - Remove plotly from visualizer install (Flask only, no plotly dependency) - Clarify artifact config: evaluator.enable_artifacts + prompt.include_artifacts Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
SKILL.mdat the repo root — a Claude Code skill file with YAML frontmatter (name,description) and comprehensive agent instructions for using OpenEvolveWhat is a Claude Code Skill File?
A skill file is a markdown document with YAML frontmatter that Claude Code automatically discovers and uses when relevant. When a user asks Claude Code to "evolve a sorting algorithm" or "optimize a GPU kernel with OpenEvolve," the skill file provides the agent with precise, up-to-date instructions — eliminating guesswork and hallucination.
This repo already has
CLAUDE.md(developer guide for working on OpenEvolve) and.github/workflows/claude.yml(GitHub Action). TheSKILL.mdcomplements these by teaching agents how to use OpenEvolve as an end-user tool.Why at root level?
The repo already places
CLAUDE.mdat root.SKILL.mdfollows the same convention for visibility. If the maintainers prefer.claude/skills/openevolve.md(the Claude Code directory convention), happy to move it there.Test plan
SKILL.mdrenders correctly on GitHub (YAML frontmatter displayed as metadata)🤖 Generated with Claude Code