Shinka Run

Launches ShinkaEvolve program mutation runs from the CLI when you've already got an evaluate.py and initial file ready to go. The workflow enforces a safety net: check available models first with shinka_models, validate your LLM and embedding choices against what's actually configured, then confirm the batch config before firing. Runs are human-in-the-loop by default, stopping between batches so you can review outcomes and steer the next generation count or tweak the task system message based on what worked or failed. It's built for iterative experimentation rather than fire-and-forget, which makes sense when you're burning tokens on evolutionary search and want to course-correct without wasting budget on bad directions.

skills.sh installs: 245
GitHub stars: 1.5K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add sakanaai/shinkaevolve --skill shinka-run --agent claude-code

Installs into .claude/skills of the current project.

Files

Shinka Run CLI Skill

Run a batch of program mutations using ShinkaEvolve's CLI interface.

When to Use

Use this skill when:

evaluate.py and initial.<ext> already exist
The user wants to run code evolution using the ShinkaEvolve/Shinka library
You want configurable program evolution runs using explicit CLI args

Do not use this skill when:

You need to scaffold a new task from scratch (use shinka-setup)

What is ShinkaEvolve?

A framework developed by SakanaAI that combines LLMs with evolutionary algorithms to propose program mutations, that are then evaluated and archived. The goal is to optimize for performance and discover novel scientific insights.

Repo and documentation: https://github.com/SakanaAI/ShinkaEvolve Paper: https://arxiv.org/abs/2212.04180