shinka-setup

Generate evaluate.py and initial.<ext> scaffolds for ShinkaEvolve tasks.

1.3k|268|Updated Sep 17, 2025
One-click install
npx skills add https://github.com/SakanaAI/ShinkaEvolve --skill shinka-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shinka-setup
Source: https://github.com/SakanaAI/ShinkaEvolve/tree/main/skills/shinka-setup
Command: npx skills add https://github.com/SakanaAI/ShinkaEvolve --skill shinka-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires shinka, pyyaml, and includes scripts (resource) components.

What problem does it solve?

Create ShinkaEvolve task scaffolds by generating an evaluation harness (evaluate.py) and an initial solution file (initial.<ext>) from a user-provided task description, enabling rapid task setup for code-evolution experiments.

Core Features & Use Cases

  • Generate language-appropriate initial.<ext> with an EVOLVE-BLOCK region and a stable I/O contract for the evolving task.
  • Produce evaluate.py to drive the evaluation loop, collect metrics, and interface with the ShinkaEvolve runner.
  • Support multi-language templates (python, julia, cpp, cuda, rust, swift, json) and optional run_evo.py and shinka.yaml for end-to-end pipelines.

Quick Start

Provide a task description and optional language, and this skill will generate initial.<ext> and evaluate.py scaffolds ready for ShinkaEvolve.

Frequently Asked Questions about shinka-setup

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

FAQPage Schema
How do I set up a new ShinkaEvolve task scaffold?

To set up a ShinkaEvolve task scaffold, provide a task description and optional language to auto-generate an evaluate.py evaluation harness and an initial.<ext> solution file with an EVOLVE-BLOCK region.

What is an EVOLVE marker in code evolution experiments?

An EVOLVE-BLOCK marker defines the specific code region within the initial.<ext> solution file targeted for mutation and optimization during the ShinkaEvolve task loop.

Can I generate task scaffolds for languages other than Python?

Yes, you can generate language-appropriate initial.<ext> solution files for multiple languages including julia, cpp, cuda, rust, swift, and json, alongside the Python evaluate.py harness.

What does the evaluate.py file do in a ShinkaEvolve task?

The evaluate.py file drives the evaluation loop, collects metrics, interfaces with the ShinkaEvolve runner, and enforces the deterministic evaluation contract for the evolving task.

Do I need pyyaml to run ShinkaEvolve task scaffolds?

You need pyyaml and the shinka dependency installed to support optional shinka.yaml configuration files for end-to-end code evolution pipelines.