English | 日本語 | Español

ai-agent-camp

AI Agent Training for Non-Engineers - Complete Guide to Claude Code / Cursor / Codex

⚠️ Before you clone

Official repository (maintained by the authors):

• https://github.com/minicoohei/ai-agent-camp

Running AI agents from this repo grants them shell, file-write, and external-API permissions on your machine. Forks and mirrors can silently alter lessons or skills. Before running any lesson, verify your clone:

python3 tools/scripts/verify_integrity.py

If the check reports a fork or missing files, review git diff upstream/main -- .claude/ skills/ tools/ scripts/ before proceeding. See docs/security-guardrails.md.

Releases & Downloads

Releases are cut from main as tags matching v* (semver). A single tag produces three language-specific zip archives, all attached to the same GitHub Release.

Download URL pattern (pinned, never moves once published):

https://github.com/minicoohei/ai-agent-camp/releases/download/{tag}/ai-agent-camp-{lang}-{tag}.zip

Each zip contains courses/, skills/, .claude/, .cursor/, docs/ with language suffixes already stripped, plus a CHECKSUMS.txt covering every file inside.

For humans

# Latest release, any language
gh release download --repo minicoohei/ai-agent-camp --pattern 'ai-agent-camp-en-*.zip'

# Specific version
gh release download v0.1.0 --repo minicoohei/ai-agent-camp \
  --pattern 'ai-agent-camp-en-v0.1.0.zip'

For AI agents

Parse the <!-- AGENT-META v1 --> block above, then:

1. (optional) hit latest_tag_api to resolve the current tag
2. fill release_asset_pattern with {tag} and {lang}
3. download, verify against the matching .sha256 asset, unzip

If you only need the lesson manifest, use manifest_raw_pattern with the lang_suffix map to fetch courses/lessons.manifest[.en|.es].yaml directly from a ref (branch, tag, or commit SHA).

See docs/release-process.md for the full specification, versioning policy, rollback procedure, and a Python parsing sample.

Before the first tag is cut: there are no Release assets yet, so the URL pattern above will 404 until v0.1.0 ships. Until then, clone the repo directly (git clone https://github.com/minicoohei/ai-agent-camp.git) or fetch individual files via raw.githubusercontent.com/.../main/....

Table of Contents

• Project Overview
• Key Features
• Quick Start
• Web Course (Recommended)
• Tool Comparison
• Learning Path
• Directory Structure
• Skill Matrix
• Required APIs
• Releases & Downloads
• Documentation
• FAQ
• Contributing
• Support

Project Overview

ai-agent-camp is a comprehensive training resource for non-engineering roles such as marketing, sales, planning, and administration to automate and streamline their work using AI agents like Claude Code, Cursor, and Codex.

Target Audience

• People with no programming experience
• Those who want to use AI tools in their daily work
• Anyone interested in automation and data analysis
• Teams looking to improve their overall AI literacy

Vision

Democratize AI agents from "tools for specialists" to "tools everyone can use," boosting productivity across the entire organization.

Key Features

• Optimized for Non-Engineers

  • No programming knowledge required
  • Step-by-step tutorials
  • Materials based on real business scenarios

• Practical Skill Set

  • Ready-to-use commands documented in the Commands Reference
  • Implemented skills documented in the Skills Reference
  • Business-specific workflow samples

• Comprehensive Curriculum

  • AI Fundamentals (Foundation) - 26 chapters
  • Environment Setup - 6 chapters
  • 26 available core modules (Google Workspace, video production, requirements definition, marketing, and more)
  • CursorBootcamp YAML metadata support (62 chapters)
  • Total study time: approx. 24 hours (30+ hours including exercises)

• Security and Best Practices

  • API key management guidelines
  • Secure data handling methods
  • Enterprise deployment guidance

• Business Workflow Templates

  • Customer support
  • Sales processes
  • Content marketing
  • Onboarding automation
  • Approval flow optimization

Quick Start

Prerequisites

• Git installed
• Python 3.9+
• Internet connection
• Cursor, Claude Code, or Codex available
• Windows users: WSL2 + Ubuntu is required. Native Windows (PowerShell / cmd) is not supported. See docs/terminal-guide.md for WSL2 setup.

Which tool should I choose? Run /start-0-8 (Tool Selection Guide) to compare Cursor / Claude Code / Codex and find the best fit.

Quickest Way to Begin

1. Clone this repo
2. Read the entry point for your tool:
   • Codex: AGENTS.md
   • Claude Code: CLAUDE.md
   • Cursor: .cursor/commands/lesson/start-0-1.md and other files in .cursor/commands/*
3. Review the safety rules:
   • Codex: docs/codex-safety.md
   • Claude Code / Cursor: docs/security-guardrails.md
4. Run setup verification:
   • Codex: aiagent-check-setup
   • Cursor: /check-setup
5. Start the first lesson with start-0-1

Create Your Own Repository

Copy this repository as your own private repo using one of these methods:

Method 1: Import Repository (GUI - Easy)

This can be done entirely through the GitHub web interface.

1. Log in to GitHub and select "+" > "Import repository" in the top right
2. Enter:
   • Your old repository's clone URL: https://github.com/minicoohei/ai-agent-camp.git
   • Repository name: any name (e.g., my-aiagent)
   • Privacy: Select Private
3. Click "Begin import"
4. After import completes, clone your repository:

   git clone https://github.com/{your-username}/my-aiagent.git
   cd my-aiagent
   

Method 2: Clone & Push (Command Line)

For those comfortable with the terminal.

# 1. Create an empty Private repository on GitHub

# 2. Create a mirror clone
git clone --bare https://github.com/minicoohei/ai-agent-camp.git my-aiagent.git
cd my-aiagent.git

# 3. Set the new origin and push
git push --mirror https://github.com/{your-username}/my-aiagent.git

# 4. Clone again for regular use
cd ..
git clone https://github.com/{your-username}/my-aiagent.git

Pulling Updates from the Original Repository

When the source materials are updated, pull changes with:

# First time only: add the original repo as upstream
git remote add upstream https://github.com/minicoohei/ai-agent-camp.git

# Pull updates
git fetch upstream
git merge upstream/main

If you use Cursor, you can run /update-material in chat to do the same thing.

Note: If you have made local changes, merge conflicts may occur. Resolve them manually.

Installation Steps

1. Clone the Repository

git clone https://github.com/minicoohei/ai-agent-camp.git ~/ai-agent-camp
cd ~/ai-agent-camp

2. Set Up Environment Variables

# First, prepare the key entry in .env.local
uv run python tools/credential_manager.py prepare-dotenv GEMINI_API_KEY

# After saving, optionally migrate to the Credential Store
# uv run python tools/credential_manager.py import-dotenv GEMINI_API_KEY --delete

Do not paste API keys in chat. Save them in .env.local.

3. Install Python Dependencies

# Install dependencies with uv
uv sync

4. Start the Course

# Open the course in a browser
# macOS: open https://ai-agent.camp
# WSL2:  wslview https://ai-agent.camp   (or just open the URL in your Windows browser)

# Open the workspace in Cursor
cursor .

# Claude Code and Codex also work with the same repo
claude
codex

Getting Started by Tool

Cursor

/check-setup
/overview
/start-0-1

Claude Code

• Read CLAUDE.md
• Review docs/security-guardrails.md
• After setup verification, proceed to the lesson flow

Codex

• Read AGENTS.md
• Open docs/codex-guide.md
• Run aiagent-check-setup skill for environment verification
• Pass start-0-1 to the aiagent-lesson-runner skill to start the first lesson

Web Course (Recommended)

Want a guided, structured learning experience?

AI Agent Camp offers a comprehensive web-based course with 28 modules, 100+ lessons, and 70+ practical skills — including a 24/7 AI tutor and a dedicated desktop app for automated environment setup.

The web course covers the same curriculum as this repository, plus additional content and interactive features designed for non-engineers.

👉 Start learning at ai-agent.camp

Tool Comparison

The materials themselves are shared. The differences are in how you enter and interact.

Common points:

• All tools use the same repository
• All tools use the same lesson IDs
• Security principles for secrets and Git are the same

Basic rules for learners:

• Keep small tasks lightweight
• Write a short plan before starting large tasks
• Read the relevant safety guide before touching Git, MCP, or secrets

Learning Path

Phase 1: Foundation (AI Fundamentals) - 5 hours

Learn the basics of AI agents. The path below covers the first 11 chapters (about 5 hours); the Foundation lesson contains 26 chapters in total.

Learning Objectives

• Understand the fundamentals of LLMs
• Know what tokens are
• Grasp AI agent concepts
• Write better prompts
• Understand how MCP, RAG, and multimodal systems work
• Recognize security risks when using AI

Phase 2: Setup (Environment Setup) - 1.5 hours

Prepare to actually use AI agents.

Learning Objectives

• Install Claude Code / Cursor
• Manage API keys securely
• Complete basic configuration

Phase 3: Core Modules - 17.5 hours

Acquire skills you can use in real work.

Total study time: approx. 24 hours (30+ hours including exercises and hands-on tasks)

Learning Options

Recommended order (Beginners)

Module 1 → Module 2 → Module 3 → Module 5 → Module 6 → Module 8

Recommended order (Business Efficiency Focus)

Module 4 → Module 9 → Module 10 → Module 11 → Module 12 → Module 8

Recommended order (Creative Focus)

Module 1 → Module 2 → Module 3 → Module 15 → Module 13 → Module 14

Recommended order (Marketing Focus)

Module 1 → Module 17 → Module 13 → Module 15 → Module 14 → Module 16

CursorBootcamp YAML Metadata

YAML metadata for the CursorBootcamp platform is stored in courses/aiagent/. Some chapters include practice/ (exercises) and final/ (final assignments); chapters that link out to the web materials do not.

62 chapters in total.

Directory Structure

ai-agent-camp/
│
├── courses/                              # Curriculum source of truth
│   ├── lessons.manifest.yaml             # Lesson manifest
│   └── aiagent/
│       ├── course.yaml / .en.yaml / .es.yaml  # Course definition (multilingual)
│       ├── cover.png                     # Course cover image
│       ├── lesson01-foundation/          # Fundamentals (26 chapters)
│       │   └── ch00 ~ ch24/             # LLM, Tokens, Agents, MCP, RAG, Security, Observability, Feasibility, etc.
│       ├── lesson02-setup/              # Environment setup (6 chapters)
│       │   └── ch01 ~ ch06/             # Environment, Extensions, API setup, Security check, Remote env, Knowledge base
│       ├── lesson03-core/               # Core skills (26 available modules)
│       │   └── module01 ~ module25, module29/ # Banner through slide-forge
│       └── lesson04-practice/           # Practice exercises (4 chapters)
│           └── ex01 ~ ex04/             # Diagram drill, parallel sessions, research deck, PMO ops
│
├── .cursor/commands/                     # See docs/commands-reference.md
│   ├── lesson/                          # Learning commands
│   │   ├── /start-0-1 ~ /start-0-8     # Module 0: Setup
│   │   ├── /start-1-1 ~ /start-1-3     # Module 1: Banners
│   │   ├── /start-2-1 ~ /start-2-3     # Module 2: Diagrams
│   │   ├── /start-3-1 ~ /start-3-6     # Module 3: Tutorials
│   │   ├── /start-4-1 ~ /start-4-7     # Module 4: Google Workspace
│   │   ├── /start-5-1 ~ /start-5-2     # Module 5: PPTX
│   │   ├── /start-6-1 ~ /start-6-9     # Module 6: Agent Development
│   │   ├── /start-7-1 ~ /start-7-8     # Module 7: Skills/Commands
│   │   ├── /start-8-1 ~ /start-8-4     # Module 8: Data Analysis
│   │   ├── /start-9-1 ~ /start-9-3     # Module 9: Slack
│   │   ├── /start-10-1 ~ /start-10-4   # Module 10: GAS
│   │   ├── /start-11-1 ~ /start-11-5   # Module 11: GitHub Actions
│   │   ├── /start-12-1 ~ /start-12-6   # Module 12: Notion
│   │   ├── /start-13-1 ~ /start-13-5   # Module 13: LP Creation
│   │   ├── /start-14-1 ~ /start-14-7   # Module 14: Article Writing
│   │   ├── /start-15-1 ~ /start-15-13  # Module 15: Video Production (+ 7a-7d)
│   │   ├── /start-16-1 ~ /start-16-8   # Module 16: Email/LINE Automation
│   │   ├── /start-17-1 ~ /start-17-5   # Module 17: Marketing
│   │   ├── /start-18-1 ~ /start-18-20  # Module 18: Requirements/System Dev
│   │   ├── /setup-m365cli + /start-19-1 ~ /start-19-2 # Module 19: Outlook
│   │   ├── /setup-freee + /start-20-1   # Module 20: Freee/MoneyForward
│   │   ├── /setup-figma + /start-21-1   # Module 21: Figma
│   │   ├── /setup-discord + /start-22-1 # Module 22: Discord
│   │   ├── /setup-line-harness + /start-23-1 # Module 23: LINE
│   │   ├── /setup-salesforce + /start-24-1 # Module 24: Salesforce
│   │   ├── /setup-google-ads + /start-25-1 # Module 25: Google Ads
│   │   └── /start-29-1 ~ /start-29-4   # Module 29: slide-forge
│   │
│   └── utility/                         # Utility commands
│       ├── /check-setup                 # Setup verification
│       ├── /overview                    # Project overview
│       ├── /guide                       # Usage guide
│       ├── /tutor                       # Interactive help
│       ├── /update-material             # Update materials to latest
│       └── ... other helpers
│
├── skills/                              # See docs/skills-reference.md
│   │
│   │  -- Image & Banner Generation --
│   ├── banner-creator/                  # SNS banner generation
│   ├── nanobanana/                      # General image generation/editing
│   ├── diagram-generator/              # Infographic generation
│   │
│   │  -- Screenshots & Tutorials --
│   ├── screenshot-analyzer/             # Screenshot analysis
│   ├── screenshot-annotator/            # Screenshot annotation
│   ├── tutorial-generator/              # Auto tutorial generation
│   │
│   │  -- Document Processing --
│   ├── pptx-analyzer/                   # PPTX structure analysis
│   ├── pptx-converter/                  # PPTX template conversion
│   ├── pptx-creator/                    # Topic to PPTX auto-generation
│   ├── document-processor/              # PDF/Word processing
│   ├── pdf-compressor/                  # PDF compression
│   │
│   │  -- Video & Media --
│   ├── storyboard-generator/            # Storyboard + Kling video generation
│   ├── video-frame-reader/              # Video keyframe extraction
│   ├── media-generator/                 # Media file generation
│   │
│   │  -- Data Analysis & Auth --
│   ├── data-analyst/                    # Data analysis & EDA
│   ├── bigquery-auth/                   # BigQuery authentication
│   ├── gcp-auth/                        # GCP authentication & setup
│   │
│   │  -- Slack & Communication --
│   ├── check-inbox/                     # Email/Slack TODO extraction
│   ├── slack-search/                    # Slack semantic search
│   ├── slack-task-manager/              # Slack task management
│   ├── slack-unanswered/                # Unanswered message detection
│   │
│   │  -- GAS & Others --
│   ├── gas-clasp-ops/                   # Google Apps Script operations
│   ├── lp-designer/                     # LP/HP creation workflow
│   │
│   │  -- Marketing (20 skills) --
│   ├── ab-test-setup/                   # A/B test design & implementation
│   ├── analytics-tracking/              # GA4/GTM tracking
│   ├── competitor-alternatives/          # Competitor comparison pages
│   ├── content-strategy/                # Content strategy
│   ├── copy-editing/                    # Copy editing & review
│   ├── copywriting/                     # Marketing copy
│   ├── email-sequence/                  # Email sequences
│   ├── free-tool-strategy/              # Free tool strategy
│   ├── launch-strategy/                 # Launch strategy
│   ├── marketing-ideas/                 # Marketing ideas
│   ├── marketing-psychology/            # Marketing psychology
│   ├── paid-ads/                        # Paid ad campaigns
│   ├── pricing-strategy/                # Pricing strategy
│   ├── product-marketing-context/       # Product marketing
│   ├── programmatic-seo/                # Programmatic SEO
│   ├── referral-program/                # Referral programs
│   ├── schema-markup/                   # Structured data
│   ├── seo-audit/                       # SEO audits
│   └── social-content/                  # Social media content
│
├── mv-composer/                         # Operations/production-only Remotion video tools (not required for learners)
├── gas-example/                         # Operations/production-only GAS examples (not required for learners)
├── ops/                                 # Operations/production-only scripts (not required for learners)
│
├── data/                                # Minimum data for lessons/Codex
│   ├── codex-command-manifest.json      # Codex routing definitions
│   ├── google-sync/                     # Google sync scripts & templates
│   ├── slack-sync/                      # Slack sync scripts & data
│   └── videos/                          # Sample videos for lessons
│
├── tests/                               # Test suite
│   ├── e2e/                             # End-to-end tests
│   ├── security/                        # Security tests
│   ├── skills/                          # Skill tests
│   ├── knowledge_base/                  # Knowledge base tests
│   └── tools/                           # Tool tests
│
├── tools/                               # Python scripts & utilities
│   ├── ugc/                             # Video generation engine
│   │   ├── remotion/                    # Remotion (React video)
│   │   └── ... other video tools
│   └── ... other utilities
│
├── docs/                                # Documentation
│   ├── commands-reference.md            # Full commands reference
│   ├── skills-reference.md              # Full skills reference
│   ├── security-guardrails.md           # Security guardrails
│   ├── codex-guide.md                   # Codex getting started guide
│   ├── codex-safety.md                  # Codex safety guide
│   ├── troubleshoot.md                  # Troubleshooting
│   ├── i18n-glossary.md                 # Internationalization glossary
│   ├── images/                          # Documentation images
│   ├── bootcamp/                        # Bootcamp materials
│   ├── generated/                       # Generated content
│   └── setup-guides/                    # API setup guides
│       └── docs/
│           ├── GEMINI_API_SETUP.md
│           ├── SLACK_TOKEN_SETUP.md
│           ├── GOOGLE_OAUTH_SETUP.md
│           ├── BIGQUERY_SETUP.md
│           ├── NOTION_API_SETUP.md
│           └── GITHUB_SECRETS_SETUP.md
│
├── .cursor/                             # Cursor rules
│   └── rules/                           # Custom rules
│
├── .claude/                             # Claude Code configuration
│   ├── commands/                        # Claude commands
│   └── hooks/                           # Claude hooks
│
├── .github/                             # GitHub Actions
│   └── workflows/                       # CI/CD workflows
│
├── .githooks/                           # Git hooks
│   └── pre-commit                       # Pre-commit rules
│
├── .env.example                         # Environment variable template
├── .gitignore                           # Git ignore rules
├── AGENTS.md                            # Codex guide
├── CLAUDE.md                            # Claude Code guide
├── PROGRESS_CHECKLIST.md                # Learning progress checklist
├── package.json                         # NPM package config
├── requirements.txt                     # Python dependencies
├── requirements-test.txt                # Test dependencies
└── README.md                            # This file

Skill Matrix

Skills Acquired After Completion

Skills by Category

Data Processing & Analysis

• Data analysis with BigQuery
• Exploratory Data Analysis (EDA) with Python
• CSV/Excel file processing
• Data visualization

Content Generation

• AI image generation
• SNS banner & thumbnail creation
• Infographic & diagram generation
• Automated screenshot annotation

Video & Media

• AI video generation (Kling, HeyGen)
• Automated short video creation
• Keyframe extraction & analysis
• Automated storyboard generation

Document Processing

• Automated PPTX slide generation & editing
• PDF processing & compression
• Word document operations
• Document content analysis

Communication Automation

• Slack workflow automation
• Email TODO auto-extraction
• Chatbot development
• Message routing

Business Automation

• Google Sheets/Calendar automation
• GAS (Google Apps Script) development
• CI/CD with GitHub Actions
• Notion database operations

AI Agent Development

• Custom Command creation
• Custom Skill development
• LLM prompt optimization
• Workflow design

Marketing & CRO

• A/B test design & implementation
• SEO audits & programmatic SEO
• Copywriting & copy editing
• Email sequences & social media content
• Ad campaigns & pricing strategy
• GA4 / GTM tracking implementation

LP/HP Creation

• Messaging & copywriting
• Wireframe creation
• Pencil MCP design
• HTML/CSS/JS implementation
• Vercel deployment

Skills by Module

Required APIs

Required

Strongly Recommended (Required for Modules 4, 8, 9, 12)

Optional (Recommended for Module 15)

API Key Setup Steps

Refer to the following guides for details:

• Gemini API Setup
• Google OAuth Setup
• BigQuery Setup
• Slack API Setup
• Notion API Setup

Documentation

Learning Materials

Reference

API Setup Guides

All guides are in the docs/setup-guides/docs/ directory:

docs/setup-guides/docs/
├── GEMINI_API_SETUP.md      # Gemini API
├── GOOGLE_OAUTH_SETUP.md    # Google OAuth
├── BIGQUERY_SETUP.md        # BigQuery
├── SLACK_TOKEN_SETUP.md     # Slack
├── NOTION_API_SETUP.md      # Notion
└── GITHUB_SECRETS_SETUP.md  # GitHub Secrets

Troubleshooting

See the Troubleshooting Guide for solutions to common issues.

FAQ

Setup

Q: What if Python is not installed?

A: Download and install from:

• Python Official
• Check "Add Python to PATH" during installation

Q: I can't install packages on macOS

A: Use Homebrew:

brew install python3

Q: Can I proceed without certain API keys?

A: Yes. Only the Gemini API is required. Others can be obtained when you reach the relevant module.

Learning

Q: Is this OK for someone with no programming experience?

A: Yes. All commands and skills are designed to work without programming knowledge.

Q: Is the module order fixed?

A: No. You can study in any order you like. However, we recommend completing the Foundation modules (0-1 through 0-4) first.

Q: How long does the course take?

A: The lecture content takes about 24 hours. Including exercises and hands-on tasks, expect 30+ hours. At 2-3 hours per day, you can complete it in about 2 weeks.

Q: Is there a certificate of completion?

A: You can track your progress with the checklist in PROGRESS_CHECKLIST.md.

Practical Application

Q: Can I customize this for my own work?

A: Yes. Module 6 (Agent Development) and Module 7 (Skills/Commands) teach you how to create custom Commands and Skills.

Q: We're considering organization-wide adoption.

A: Please open an Issue to discuss licensing and enterprise customization.

Q: We need stricter security.

A: Refer to Security Guardrails for security best practices. Enterprise configurations are possible.

Contributing

We welcome your feedback and suggestions for improvement!

Bug Reports & Feature Requests

1. Check Issues for existing reports
2. Create a new Issue if needed
3. Follow the template and provide detailed information

Pull Requests

1. Fork this repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Create a Pull Request

Documentation Improvements

Typo fixes and wording improvements are also welcome. Please submit PRs with:

• The target file clearly identified
• The reason for the improvement
• A proposed fix if possible

Questions & Discussion

Issues can be written in English or Japanese. The community is multilingual.

Support

Documentation

• Documentation Index
• Course Website
• Troubleshooting

Questions & Help

In-Tool Help

# Setup check
Cursor: /check-setup
Codex: aiagent-check-setup

# Usage guide
/guide

# Project overview
/overview

# Interactive help
/tutor

# About a specific module
/help-module-1

Other Resources

• Official Repository: github.com/minicoohei/ai-agent-camp
• Issue Tracker: Issues
• Release Notes: Releases

Related Resources

Official Documentation

• Claude AI Documentation
• Cursor Official Docs
• Google Gemini API Docs

Community

• Claude Community Discord
• Cursor Community