concept-to-exercise

Generate diagnosis exercises with broken and fixed git commits from concept descriptions.

Updated Jul 5, 2025
One-click install
npx skills add https://github.com/nsuberi/proto-portal-showcase-hub --skill concept-to-exercise
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: concept-to-exercise
Source: https://github.com/nsuberi/proto-portal-showcase-hub/tree/main/apps/code-dojo-deprecated/.claude/skills/concept-to-exercise
Command: npx skills add https://github.com/nsuberi/proto-portal-showcase-hub --skill concept-to-exercise

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Convert high-level teaching intents about technical concepts into hands-on diagnosis exercises that demonstrate a concrete failure and its minimal fix, removing the friction of creating reproducible broken/fixed code examples and git commits for training or assessments.

Core Features & Use Cases

  • Example Generation: Produce minimal, realistic code examples that reproduce a targeted symptom for domains like Flask, pytest, async code, Docker, and database usage.
  • Repository & Commits: Initialize a demo git repository and create clear "before" (broken) and "after" (fixed) commits with descriptive messages and captured hashes.
  • Handoff & Packaging: Prepare the contextual metadata (repo path, before/after hashes, symptom, environment, key insight) and invoke downstream diagnosis tooling to produce a packaged exercise and teaching guide.
  • Use Case: Quickly create a Flask ProxyFix exercise or a pytest fixture-scope demo for workshops, automated training pipelines, or learning platforms.

Quick Start

Create an exercise by describing the concept and environment, for example: "Teach Flask ProxyFix by generating a minimal app that breaks behind a proxy, commit broken and fixed states, and package the exercise."

Frequently Asked Questions about concept-to-exercise

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

FAQPage Schema
How do I generate broken and fixed git commits for teaching code diagnosis?

You can generate pytest fixture-scope or Flask ProxyFix diagnosis exercises by providing a concept description, which produces minimal broken and fixed code repositories with corresponding before and after commit hashes.

What is the best way to create reproducible code diagnosis exercises for Flask or pytest?

The best way to create reproducible code diagnosis exercises for Flask or pytest is to generate minimal broken and fixed code repositories from concept descriptions, capturing the repository path, commit hashes, symptom, and environment details for training pipelines.

Can I use this to generate Docker networking or async pattern exercises for workshops?

Yes, you can generate Docker networking and async pattern exercises for workshops by applying the Skill to those infrastructure topics, producing minimal demo repositories with broken and fixed states formatted for downstream diagnosis tooling.

How do I package a generated code diagnosis exercise for a learning platform?

You package a generated code diagnosis exercise by preparing contextual metadata including the absolute repository path, before and after commit hashes, concrete symptom, environment description, and key insight to invoke downstream tech-diagnosis-exercise processing.

Does generating diagnosis exercises require manual git repository setup beforehand?

Generating diagnosis exercises does not require manual git repository setup beforehand, as the Skill initializes the demo repository itself and automatically creates the descriptive before and after commits with captured hashes.