English | 日本語 | Español

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 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.

# 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'

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/....

• 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

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.

• 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

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

• Optimized for Non-Engineers

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

• Practical Skill Set

  • 80+ ready-to-use commands
  • 42+ implemented skills (including marketing and LP/HP creation)
  • Business-specific workflow samples

• Comprehensive Curriculum

  • AI Fundamentals (Foundation) - 11 chapters
  • Environment Setup - 3 chapters
  • 20 core modules (Google Workspace, video production, requirements definition, marketing, and more)
  • CursorBootcamp YAML metadata support (all 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

• 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.

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

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

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

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

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.

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

# 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.

# Install dependencies with uv
uv sync

# 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

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

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

• 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

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

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

Learn the basics of AI agents across 11 chapters.

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

Prepare to actually use AI agents.

Learning Objectives

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

Acquire skills you can use in real work.

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

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

YAML metadata for the CursorBootcamp platform is stored in courses/aiagent/. Each chapter includes practice/ (exercises) and final/ (final assignments).

All chapters include practice/final content.

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 (11 chapters)
│       │   └── ch01 ~ ch11/             # LLM, Tokens, Agents, MCP, RAG, Security, etc.
│       ├── lesson02-setup/              # Environment setup (3 chapters)
│       │   └── ch01 ~ ch03/             # Environment, Extensions, API setup
│       └── lesson03-core/               # Core skills (20 modules)
│           └── ch01 ~ ch20/             # Banner through Freee (practice/final included)
│
├── .cursor/commands/                     # 80+ commands
│   ├── lesson/                          # Learning commands (52+)
│   │   ├── /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-5     # 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-2     # Module 9: Slack
│   │   ├── /start-10-1 ~ /start-10-3   # Module 10: GAS
│   │   ├── /start-11-1 ~ /start-11-2   # 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-8   # Module 15: Video Production
│   │   ├── /start-16-1 ~ /start-16-8   # Module 16: Email/LINE Automation
│   │   ├── /start-17-1 ~ /start-17-4   # Module 17: Marketing
│   │   ├── /start-18-1 ~ /start-18-20  # Module 18: Requirements/System Dev
│   │   ├── /start-19-1                  # Module 19: Outlook (in progress)
│   │   └── /start-20-1                  # Module 20: Freee/MoneyForward (in progress)
│   │
│   └── utility/                         # Utility commands (28+)
│       ├── /check-setup                 # Setup verification
│       ├── /overview                    # Project overview
│       ├── /guide                       # Usage guide
│       ├── /tutor                       # Interactive help
│       ├── /update-material             # Update materials to latest
│       └── ... other helpers
│
├── skills/                              # 42+ reusable skills
│   │
│   │  -- 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
│
├── 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

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

Refer to the following guides for details:

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

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

See the Troubleshooting Guide for solutions to common issues.

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.

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.

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.

We welcome your feedback and suggestions for improvement!

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

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

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

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

• Documentation Index
• Course Website
• Troubleshooting

# 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

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

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

• Claude Community Discord
• Cursor Community