start-3-1-1
GitHub用于引导学生配置Gemini API密钥及计费,验证Python环境,并执行首张图像生成的教学脚本。
Trigger Scenarios
Install
npx skills add carlvellotti/free-ai-courses --skill start-3-1-1 -g -y
SKILL.md
Frontmatter
{
"name": "start-3-1-1",
"description": "3.1.1 Welcome & First Generation. Use when the student types \/start-3-1-1.\n",
"allowed-tools": [
"Read",
"Write",
"Bash",
"AskUserQuestion"
],
"disable-model-invocation": true
}
Setup
Read .claude/rules/teaching-rules.md and follow it for everything below.
ACTION: Silently stage bundled scenario assets without overwriting student work:
cp -rn ".claude/skills/start-3-1-1/assets/." .
ACTION: Silently verify that the Python image runtime imports successfully. If any dependency is missing, run python3 -m pip install -r requirements.txt yourself. Never show raw installer output; summarize only whether the runtime is ready or what concise error remains before the first generation.
Teach this lesson from the bundled script. Follow every Say block verbatim, stop at every Check gate, and have the agent perform every Action. Do not expose instructor metadata.
Module 3.1.1: Welcome & First Generation
Teaching Script for Claude Code
Teaching Flow
Welcome to Nano Banana Pro in Claude Code for PMs!
I'm going to quote the course creator Carl here: "You aren't going to believe how fucking amazing this is."
He's right. We're going to use Gemini 3 Pro - also known as Nano Banana Pro - Google's most advanced image generation model. It can create photorealistic images, transform reference photos, generate text overlays, and so much more.
STOP: Are you ready to see what it can do?
USER: Yes / Ready
Before we generate anything, we need to set up your API key. This takes about 2-3 minutes and you only do it once.
First, go to Google AI Studio:
STOP: Open that link in your browser and let me know when you're there.
USER: I'm there
If this is your first time, accept the Terms of Service.
Then:
- Click "Get API Key" in the left sidebar
- Click "Create API key" in the upper right
- Name your key whatever you want and select "Default Gemini Project"
- Click on the key in the dashboard to reveal it
- Copy the key - it starts with "AIza..."
STOP: Do you have your API key copied?
USER: Yes
Important: You also need to set up billing for Gemini 3 Pro to work.
Don't worry about cost - it's about $0.10 per image, and this whole course will cost less than $5 total. (This goes to Google, not to Carl... unfortunately.)
- In Google AI Studio, go to Get API key (bottom of left sidebar)
- Under the "Quota tier" column, click Set up billing
- Follow the prompts to add a payment method
STOP: Is your billing set up?
USER: Yes / Done
Now let's add your API key without putting the secret in this conversation.
ACTION: If .env does not exist, copy .env.example to .env. Never overwrite an existing .env. Then provide the clickable link .env.
Click .env in the Desktop project tree and paste the key directly after GEMINI_API_KEY=. Save the file, then tell me done. Never paste the key into the composer.
STOP: Wait for the student to say "done."
USER: Done
ACTION: Verify that .env exists and that GEMINI_API_KEY loads as a non-empty value. Do not print, echo, log, or otherwise expose the key. Report only whether verification succeeded.
Great, you're all set up!
Now for the fun part - let's generate your first image.
I have a reference photo of Carl, the course creator. You can find it at carl-reference.JPG if you want to see what you're working with. We're going to put him in a banana suit to welcome you to the course.
STOP: Say "Generate Carl in a banana suit welcoming me to Nano Banana"
USER: Generate Carl in a banana suit welcoming me to Nano Banana
This will take about 10-15 seconds
ACTION: Run generate() with reference image carl-reference.JPG and prompt: "Carl in a bright yellow banana suit, standing confidently with arms crossed, big friendly smile, ready to teach. Text overlay says 'Welcome to Nano Banana!' Professional course instructor vibe but fun and playful."
ACTION: After generation succeeds, read the exact saved path reported by generate(), state that path in prose, and provide a Markdown link to that exact file so the student can open it in Desktop.
STOP: What do you think?
USER: Response about the image
Pretty incredible, right?
That's Gemini 3 Pro. It can take a reference photo and transform it while keeping the person recognizable. And because we're doing this in Claude Code, I handle all the complexity for you:
- API calls
- Session management
- Saving outputs
- Picking smart parameters
Through this course, you'll build your own system of prompts, reference images, and styles. We'll start by covering general use and then move onto PM use cases in the next module.
STOP: Want to hear what's coming next in this module?
USER: Yes
Here's what we'll cover in Module 3.1:
- Understanding the Basics - how the generate() function works, available parameters, output structure
- Consistency & Style - using reference images, building a style database, extracting styles from existing images
- Iteration Strategies - sessions, refining images step by step, reverting when needed
Once you've got the fundamentals down, Module 3.2 will show you PM-specific use cases like mockups, personas, and diagrams.
STOP: Ready to continue to the next lesson?
USER: Yes / Ready
Great! In the next lesson, you'll learn how the generate() function works and all the options available to you.
Run /start-3-1-2 when you're ready to continue.
ACTION: End module
Important Notes for Claude
File operations in this module:
- Read
.env.exampleto show the student the template - Copy
.env.exampleto.envwhen student requests - The student opens .env and pastes the key directly into the file; the key never enters chat
- Verify only that the key loads and is non-empty; never echo it
For the image generation:
- Use the
generate()function fromimage_gen.py - Pass the reference image path and the exact prompt specified
- The output will be saved automatically to
outputs/
If something goes wrong:
- API key errors: Have them open .env and check the value directly without sharing it
- Billing errors: Confirm billing is set up in Google AI Studio settings
- Generation fails: Check the error message and troubleshoot accordingly
Opening images: State the exact path and link it. Optionally run open <path> for the student.
Success Criteria
Module 3.1.1 is successful if the student:
- ✅ Has their Gemini API key set up in
.env - ✅ Has billing configured in Google AI Studio
- ✅ Generated their first image (Carl in banana suit)
- ✅ Understands what they'll learn in this module
- ✅ Knows how to continue to the next lesson
Remember: This is the student's first taste of image generation. Make it magical. The "wow" moment with that first generated image sets the tone for the entire module.
Sendoff
ACTION: Before wrapping up, record this lesson as complete by running this WITHOUT NARRATING the raw output:
fspm progress complete cc-pms-3-1-1
If it fails because the fspm CLI isn't installed, follow the teaching rules' missing-CLI guidance: tell the learner progress tracking needs the FSPM CLI, offer to install it, and continue the wrap-up either way.
Then close out with the student's options, in natural language (never as a command list):
- Mention they can leave feedback on this lesson anytime — if they have some, collect it conversationally and submit it with the CLI (see teaching rules).
- Remind them, briefly and only if it fits the moment, that they can always ask for a recap, a quiz on what they just did, a saved note, or where they stand in the course.
- End with the next step: when you're ready for the next lesson, start a fresh chat (New Chat), then:
/start-3-1-2
Version History
- 8a6f91b Current 2026-07-31 07:46
- 058c617 2026-07-23 00:54


