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.