shinka-convert

Convert an existing codebase into a ShinkaEvolve task with evaluate.py and runner files.

1|1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/tan-yong-sheng/GrowChat --skill shinka-convert
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shinka-convert
Source: https://github.com/tan-yong-sheng/GrowChat/tree/main/.claude/skills/shinka-convert
Command: npx skills add https://github.com/tan-yong-sheng/GrowChat --skill shinka-convert

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Convert an existing codebase in the current working directory into a ShinkaEvolve task directory by snapshotting the relevant code, adding evolve blocks, and generating evaluate.py plus Shinka runner/config files. Use when the user wants to optimize existing code with Shinka instead of creating a brand-new task from a natural-language description.

Core Features & Use Cases

  • Snapshot the minimal runnable codebase and generate an evolvable task scaffold.
  • Produce evaluate.py and Shinka runner/config files to enable automated evolution.
  • Preserve the original code while isolating the evolvable regions for safe experimentation.

Quick Start

Place the existing project in the current directory and run the shinka convert workflow to produce a Shinka-ready task directory.

Frequently Asked Questions about shinka-convert

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

FAQPage Schema
How do I convert an existing codebase into an automated evolvable task?▼

To convert an existing codebase into an evolvable task, snapshot the relevant code, add evolve blocks, and generate evaluate.py plus runner/config files. This isolates evolvable regions for safe automated experimentation while preserving the original project.

Can I optimize existing code with Shinka instead of creating a task from scratch?▼

Yes, you can optimize existing code with Shinka by snapshotting the minimal runnable codebase and generating an evolvable task scaffold. This avoids creating a new task from a natural-language description and allows direct automated evolution of your current project.

What is the best way to automate codebase evolution for an existing project?▼

The best way to automate codebase evolution for an existing project is generating a ShinkaEvolve task directory that produces evaluate.py and Shinka runner/config files. This enables the Shinka pipeline to safely evaluate and evolve isolated regions of your code.

Do I need to modify my original project files to generate a Shinka task?▼

No, you do not need to modify your original project files to generate a Shinka task. The conversion process preserves the original code while producing a small, isolated evolution task directory for experimentation.

What files are generated when snapshotting an existing project for Shinka evolution?▼

When snapshotting an existing project for Shinka evolution, the process generates an evolvable task scaffold containing evaluate.py and Shinka runner/config files. These files enable automated evaluation within the Shinka pipeline.

When should I use automated codebase conversion instead of natural-language task generation?▼

You should use automated codebase conversion instead of natural-language task generation when you want to optimize an existing project. It snapshots your current code to isolate evolvable regions, whereas natural-language generation creates brand-new tasks from descriptions.