// Load top-performing Shinka programs into agent context using `shinka.utils.load_programs_to_df`, and emit a compact Markdown bundle for iteration planning.
| name | shinka-inspect |
| description | Load top-performing Shinka programs into agent context using `shinka.utils.load_programs_to_df`, and emit a compact Markdown bundle for iteration planning. |
Extract the strongest programs from a Shinka run and package them into a context file that coding agents can load directly.
Use this skill when:
Do not use this skill when:
shinka-setup)shinka-run)shinka.utils.load_programs_to_df to read program recordscombined_scorek correct programs (fallback to top-k overall if no correct rows)ls -la <results_dir>
python skills/shinka-inspect/scripts/inspect_best_programs.py \
--results-dir <results_dir> \
--k 5
python skills/shinka-inspect/scripts/inspect_best_programs.py \
--results-dir <results_dir> \
--k 8 \
--max-code-chars 5000 \
--min-generation 10 \
--out <results_dir>/inspect/top_programs.md
<results_dir>/shinka_inspect_context.md--results-dir: Path to run directory (or direct DB file path)--k: Number of programs to include (default 5)--out: Output markdown path (default under results dir)--max-code-chars: Per-program code truncation cap (default 4000)--min-generation: Optional lower bound on generation--include-feedback / --no-include-feedback: Include text_feedback blockscombined_score.
Create ShinkaEvolve task scaffolds from a target directory and task description, producing `evaluate.py` and `initial.<ext>` (multi-language). Use when asked to set up new ShinkaEvolve tasks, evaluation harnesses, or baseline programs for ShinkaEvolve.
Run existing ShinkaEvolve tasks with the `shinka_run` CLI from a task directory (`evaluate.py` + `initial.<ext>`). Use when an agent needs to launch async evolution runs quickly with required `--results_dir`, generation count, and strict namespaced keyword overrides.
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.