lesson-runner

Run Python lesson code with uv and automatic virtual environment handling.

Updated Oct 31, 2025
One-click install
npx skills add https://github.com/ilude/agent-spike --skill lesson-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lesson-runner
Source: https://github.com/ilude/agent-spike/tree/main/.claude/skills/lesson-runner
Command: npx skills add https://github.com/ilude/agent-spike --skill lesson-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the common struggle of setting up Python virtual environments and managing project-specific code execution. It automates the process of running lesson code within the agent-spike multi-agent learning project, handling uv and venv complexities so you can focus on learning and development, not environment setup.

Core Features & Use Cases

  • Automated Lesson Execution: Seamlessly run test scripts, demo scripts, and CLI commands for any agent-spike lesson.
  • Virtual Environment Management: Automatically handles uv and venv setup, ensuring your code runs with the correct Python interpreter and dependencies from any directory.
  • Use Case: When you're working in lessons/lesson-003 and need to run demo.py with a specific URL, simply ask the AI to "Run the demo script for lesson-003 with the URL 'https://example.com'," and it will execute the command uv run python lessons/lesson-003/demo.py "https://example.com" without you needing to activate a virtual environment or manage paths.

Quick Start

Run the test script 'test_coordinator.py' for lesson-003.

Frequently Asked Questions about lesson-runner

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

FAQPage Schema
How do I run Python lesson scripts without manually activating virtual environments?

Use uv to execute lesson code automatically—it discovers and activates the project's virtual environment, resolves dependencies, and selects the correct Python interpreter from any directory, eliminating manual venv setup.

Can I run test and demo scripts for agent-spike lessons from any directory?

Yes. This Skill executes lesson-specific test scripts, demo scripts, and CLI commands from any location by automatically handling uv and venv setup, ensuring the correct Python environment and dependencies are active.

How does uv manage virtual environments across lesson directories in agent-spike?

uv automatically discovers the project root .venv and lesson-specific environments, selecting the correct interpreter and resolving dependencies without requiring manual environment activation or path management.

What's the fastest way to run a lesson demo script with command-line arguments?

Invoke uv to run the lesson script with arguments directly—uv handles virtual environment activation and dependency resolution automatically, executing the command like `uv run python lessons/lesson-003/demo.py "https://example.com"`.

Do I need to install dependencies manually before running agent-spike lessons?

No. uv automatically resolves and installs dependencies from the project root .venv and lesson-specific environments, so code runs immediately with all required packages active.

What happens when I run a lesson script from a different working directory?

The Skill handles cross-directory execution by automatically locating and activating the correct virtual environment, ensuring the script runs with the proper Python interpreter and dependencies regardless of your current directory.