project-scaffold

Generate a runnable ML project scaffold from an experiment plan.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/EmaRimoldi/Claude-scholar-extended --skill project-scaffold-emarimoldi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-scaffold
Source: https://github.com/EmaRimoldi/Claude-scholar-extended/tree/main/skills/project-scaffold
Command: npx skills add https://github.com/EmaRimoldi/Claude-scholar-extended --skill project-scaffold-emarimoldi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of a complete, runnable ML experiment project scaffold from an experiment plan, removing boilerplate work and enabling focus on core research questions.

Core Features & Use Cases

  • Reads an experiment-plan.md to infer project structure and dependencies
  • Generates a complete boilerplate: pyproject.toml, src/ with Factory/Registry wiring, Hydra config templates, entry point, and a Makefile
  • Produces a test skeleton and versioned project layout ready for downstream skills (experiment-data-builder, model-setup, measurement-implementation)

Quick Start

Run the skill on an experiment-plan.md to generate a runnable project scaffold you can start coding against immediately.

Frequently Asked Questions about project-scaffold

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

FAQPage Schema
How do I generate a Python ML project scaffold from an experiment plan?

To generate an ML project scaffold, you can run a scaffold generator on an experiment-plan.md to automatically produce a src/ tree, pyproject.toml, and Hydra configs. This removes manual boilerplate work and creates a runnable project structure ready for immediate coding.

What is Hydra config and Factory/Registry wiring in ML project structure?

In ML project structure, Hydra config provides dynamic configuration management, while Factory/Registry wiring implements a pattern to dynamically instantiate objects. Using these together standardizes experiment execution and ensures the generated scaffold remains modular and easily extendable.

Can I use this scaffold generator without a pre-existing experiment plan?

Yes, you can apply the scaffold generator at project inception without a detailed experiment plan. It produces standard dependency templates, an entry point, and a test skeleton, giving you a versioned project layout to start coding against immediately.

Does this ML scaffold include a test skeleton and Makefile?

Yes, the generated ML scaffold includes a test skeleton for validating code and a Makefile for automating common development commands. It also provides a pyproject.toml for dependency management, ensuring a complete and runnable environment from the start.

Why use a scaffold generator instead of manually setting up ML project boilerplate?

Using a scaffold generator instead of manually setting up ML project boilerplate ensures consistent project structure and saves time. It automatically infers dependencies from your experiment plan and generates standardized Factory/Registry wiring and Hydra config templates.

What's the best way to structure a runnable ML project for downstream tasks?

The best way to structure a runnable ML project is to generate a standardized scaffold with a src/ tree, entry point, and Makefile. This versioned layout is specifically designed to be ready for downstream skills like experiment-data-builder and model-setup.