ai-agent-camp
AI Agent Camp — non-engineer-friendly AI agent training curriculum. Lessons, skills, commands, and hooks for Claude Code, Cursor, and Codex.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/minicoohei--ai-agent-camp)HTML
<a href="/listings/minicoohei--ai-agent-camp"><img src="/api/listings/minicoohei--ai-agent-camp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Prerequisites
- Git installed - Python 3.9+ - Internet connection - Cursor, Claude Code, or Codex available - **Windows and macOS are both supported.** Some features (MCP integrations, for example) can differ by OS. For CLI-heavy workflows in this repository, [docs/terminal-guide.md](docs/terminal-guide.md) documents WSL2 + Ubuntu as a recommended Windows path.
> **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-aiagentMethod 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.gitPulling 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
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 962 lines
- [English](README.md) | [日本語](README.ja.md) | [Español](README.es.md)
- # ai-agent-camp
- **AI Agent Training for Non-Engineers - Complete Guide to Claude Code / Cursor / Codex**
- [](https://github.com/minicoohei/ai-agent-camp)
- [](https://github.com/minicoohei/ai-agent-camp/releases)
- [](https://www.python.org/)
- > ### ⚠️ 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:
- >
- > ```bash
- > 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`](docs/security-guardrails.md).
- <!-- AGENT-META v1
- schema: https://github.com/minicoohei/ai-agent-camp/blob/main/docs/release-process.md#agent-meta-v1
- repo: minicoohei/ai-agent-camp
- primary_branch: main
- languages: [ja, en, es]
- default_language: ja
- latest_tag_api: https://api.github.com/repos/minicoohei/ai-agent-camp/releases/latest
- release_asset_pattern: https://github.com/minicoohei/ai-agent-camp/releases/download/{tag}/ai-agent-camp-{lang}-{tag}.zip
- manifest_raw_pattern: https://raw.githubusercontent.com/minicoohei/ai-agent-camp/{ref}/courses/lessons.manifest{lang_suffix}.yaml
- lang_suffix: {ja: "", en: ".en", es: ".es"}
- integrity_cli: python3 tools/scripts/verify_integrity.py
- -->
- ## 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
- ```
- | Language | Asset | Checksum |
- |----------|-------|----------|
- | 日本語 | `ai-agent-camp-ja-{tag}.zip` | `ai-agent-camp-ja-{tag}.zip.sha256` |
- | English | `ai-agent-camp-en-{tag}.zip` | `ai-agent-camp-en-{tag}.zip.sha256` |
- | Español | `ai-agent-camp-es-{tag}.zip` | `ai-agent-camp-es-{tag}.zip.sha256` |
- Each zip contains `courses/`, `skills/`, `.claude/`, `.cursor/`, `docs/` with language suffixes already stripped, plus a `CHECKSUMS.txt` covering every file inside.
- ### For humans
- ```bash
- # 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`](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](#project-overview)
- - [Key Features](#key-features)
- - [Quick Start](#quick-start)
- - [Web Course (Recommended)](#web-course-recommended)
- - [Tool Comparison](#tool-comparison)
- - [Learning Path](#learning-path)
- - [Directory Structure](#directory-structure)
- - [Skill Matrix](#skill-matrix)
- - [Required APIs](#required-apis)
- - [Releases & Downloads](#releases--downloads)
- - [Documentation](#documentation)
- - [FAQ](#faq)
- - [Contributing](#contributing)
- - [Support](#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](docs/commands-reference.md)
- - Implemented skills documented in the [Skills Reference](docs/skills-reference.md)
- - Business-specific workflow samples
- - **Comprehensive Curriculum**
- - Official web catalog at [ai-agent.camp](https://ai-agent.camp) (as of 2026-08-31): **47 modules**, FAQ study time about **50–60 hours**
- - This repository: 26 Foundation chapters, 6 Setup chapters, 26 core modules (numbered 1–25 and 29; 26–28 unused), 4 practice chapters — **62** course chapters
- - 138 runnable `start-*` lessons in [`courses/lessons.manifest.yaml`](courses/lessons.manifest.yaml)
- - `course.yaml` estimates **50 hours**; the public FAQ uses 50–60 hours for the full web catalog
- - **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 and macOS are both supported.** Some features (MCP integrations, for example) can differ by OS. For CLI-heavy workflows in this repository, [docs/terminal-guide.md](docs/terminal-guide.md) documents WSL2 + Ubuntu as a recommended Windows path.
- > **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:
- ```bash
- 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.
- ```bash
- # 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:
- ```bash
- # 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
- ```bash
- git clone https://github.com/minicoohei/ai-agent-camp.git ~/ai-agent-camp
- cd ~/ai-agent-camp
- ```
- #### 2. Set Up Environment Variables
- ```bash
- # 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
- ```bash
- # Install dependencies with uv
- uv sync
- ```
- #### 4. Start the Course
- ```bash
- # 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
- ```bash
- /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](https://ai-agent.camp) is the official web course. As of 2026-08-31 the public catalog lists **47 modules**, and the FAQ estimates about **50–60 hours** to finish. A 24/7 AI tutor and a desktop app for environment setup are available on the site.
- >
- > This repository is the Cursor / Claude Code / Codex workspace for the same curriculum. It ships **138** `start-*` lessons (see `courses/lessons.manifest.yaml`). Copilot / ACP is not a first-class track here.
- >
- > 👉 **[Start learning at ai-agent.camp](https://ai-agent.camp)**
- <p align="center">
- <a href="https://ai-agent.camp">
- <img src="docs/images/ai-agent-camp-preview.png" alt="AI Agent Camp Web Course" width="600">
- </a>
- </p>
- ---
- ## Tool Comparison
- The materials themselves are shared. The differences are in how you enter and interact.
- | Item | Codex | Claude Code | Cursor |
- | --- | --- | --- | --- |
- | Entry point | `AGENTS.md` | `CLAUDE.md` | `.cursor/commands/*` |
- | Start lesson | `aiagent-lesson-runner` | Claude lesson flow | `/start-*` |
- | Setup check | `aiagent-check-setup` | Claude-side check | `/check-setup` |
- | Safety model | sandbox + approval | Claude hooks + permissions | Cursor rules + commands |
- | Lesson ID | `start-*` | `start-*` | `start-*` |
- 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.
- | Chapter | Content | Study Time |
- |---------|---------|------------|
- | 0-1 | How LLMs Work - Fundamental Principles | 30 min |
- | 0-2 | Token Concepts and Calculation | 30 min |
- | 0-3 | What Are AI Agents | 30 min |
- | 0-4 | Context Engineering and Prompting | 30 min |
- | 0-5 | How to Use Cursor | 25 min |
- | 0-6 | MCP (Model Context Protocol) | 25 min |
- | 0-7 | Multimodal AI | 25 min |
- | 0-8 | RAG (Retrieval-Augmented Generation) | 25 min |
- | 0-9 | Skills / SubAgents / Agent Teams | 25 min |
- | 0-10 | Hallucination Prevention | 25 min |
- | 0-11 | AI Security | 25 min |
- **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.
- | Module | Content | Study Time |
- |--------|---------|------------|
- | 0 | Claude Code / Cursor Setup | 30 min |
- | 0.5 | Extensions and Customization | 15 min |
- | 0.9 | API Key Setup and Authentication | 45 min |
- **Learning Objectives**
- - Install Claude Code / Cursor
- - Manage API keys securely
- - Complete basic configuration
- ---
- ### Phase 3: Core Modules
- Acquire skills you can use in real work. Lesson counts below match `courses/lessons.manifest.yaml` (modules 26–28 are unused).
- | # | Module | Key Skills | Lessons | Difficulty |
- |---|--------|------------|---------|------------|
- | **1** | **Banner & Image Generation** | banner-creator, nanobanana | 3 | ★ |
- | **2** | **Diagrams & Flowcharts** | diagram-generator, PlantUML | 3 | ★★ |
- | **3** | **Tutorials** | screenshot-analyzer, tutorial-generator | 6 | ★★ |
- | **4** | **Google Workspace** | gogcli, Gmail, Calendar, Drive, Sheets | 7 | ★★★ |
- | **5** | **PPTX Analysis & Editing** | pptx-analyzer, pptx-creator, pptx-converter | 2 | ★★ |
- | **6** | **Agent Development** | Commands/Skills creation, customization | 9 | ★★★★ |
- | **7** | **Skills & Commands** | Skill design, SKILL.md implementation, testing, design patterns | 8 | ★★★★ |
- | **8** | **Data Analysis & EDA** | data-analyst, BigQuery, Marimo | 4 | ★★★ |
- | **9** | **Slack Integration** | slack-search, check-inbox, task-manager | 3 | ★ |
- | **10** | **GAS Automation** | gas-clasp-ops, Calendar, Sheets | 4 | ★★★ |
- | **11** | **GitHub Actions** | Workflow, Secrets, CI/CD | 5 | ★★★ |
- | **12** | **Notion Integration** | Notion MCP, DB operations, ncli | 6 | ★★ |
- | **13** | **LP/HP Creation** | Messaging, wireframes, Pencil design, HTML, Vercel deploy | 5 | ★★★ |
- | **14** | **Article Writing** | article-writer, copy-editing, fact-checker | 7 | ★★★ |
- | **15** | **Video Production** | Kling, HeyGen, Veo, Remotion, MV | 13 | ★★★ |
- | **16** | **Email/LINE Automation** | email-sequence, Resend, LINE API | 8 | ★★★ |
- | **17** | **Marketing** | X posts, SEO research, copywriting, design mocks | 5 | ★★★ |
- | **18** | **Requirements & System Dev** | pm-toolkit, test-planner, Notion integration | 20 | ★★★★★ |
- | **19** | **Microsoft Office (Outlook)** | Outlook MCP integration | 2 | ★★ |
- | **20** | **Freee/MoneyForward** | Freee MCP accounting data operations | 1 | ★★ |
- | **21** | **Figma** | Figma MCP | 1 | ★★ |
- | **22** | **Discord** | Discord Bot / channel operations | 1 | ★★ |
- | **23** | **LINE** | LINE official account | 1 | ★★ |
- | **24** | **Salesforce** | Salesforce CLI | 1 | ★★ |
- | **25** | **Google Ads** | Google Ads API | 1 | ★★ |
- | **29** | **slide-forge** | Slide generation and revision | 4 | ★★ |
- **This repository:** 138 `start-*` lessons (including Module 0 setup). **Web course catalog** ([ai-agent.camp](https://ai-agent.camp), as of 2026-08-31): 47 modules; FAQ study time about 50–60 hours.
- ### Learning Options
- **Recommended order (Beginners)**
- ```text
- Module 1 → Module 2 → Module 3 → Module 5 → Module 6 → Module 8
- ```
- **Recommended order (Business Efficiency Focus)**
- ```text
- Module 4 → Module 9 → Module 10 → Module 11 → Module 12 → Module 8
- ```
- **Recommended order (Creative Focus)**
- ```text
- Module 1 → Module 2 → Module 3 → Module 15 → Module 13 → Module 14
- ```
- **Recommended order (Marketing Focus)**
- ```text
- 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.
- | Lesson | Chapters | Content |
- |--------|----------|---------|
- | **Lesson 01: Foundation** | 26 | LLM basics, Tokens, Agents, Context Engineering, MCP, Multimodal, RAG, SubAgents, Hallucination, Security, Observability, Feasibility |
- | **Lesson 02: Setup** | 6 | Environment setup, Extensions, API configuration, Security check, Remote environment, Knowledge base |
- | **Lesson 03: Core** | 26 | Banner through slide-forge (all core modules) |
- | **Lesson 04: Practice** | 4 | Diagram drill, parallel sessions, research-to-proposal deck, PMO operations (no `practice/` / `final/` directories) |
- 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
- | Module | Skills Acquired | Applications |
- |--------|----------------|--------------|
- | **1** | Image generation, banner creation | SNS marketing, presentations |
- | **2** | Flowcharts, diagrams | Process design, system design |
- | **3** | Screenshot analysis, tutorials | Manual creation, UI/UX improvement reports |
- | **4** | Google Workspace integration | Gmail analysis, Calendar management, Drive operations, AI assistant |
- | **5** | PowerPoint automation | Presentation materials, periodic reports |
- | **6** | Agent development | Commands/Skills creation, custom tools |
- | **7** | Skill/Commands design | Business-specific skills, design patterns |
- | **8** | Data analysis, visualization | Business analysis, report automation |
- | **9** | Slack integration, task management | Notification automation, team efficiency |
- | **10** | GAS automation | Schedule management, data integration |
- | **11** | GitHub Actions | CI/CD pipelines, automated testing |
- | **12** | Notion integration | Knowledge management, project management |
- | **13** | LP/HP creation | Messaging, wireframes, design, implementation, deployment |
- | **14** | Article writing | Theme setting, style application, proofreading, fact-checking |
- | **15** | AI video generation | Product introductions, music videos, slide videos |
- | **16** | Email/LINE automation | Email sequences, LINE Bot |
- | **17** | Marketing | X posts, SEO, copywriting |
- | **18** | Requirements & system dev | PRD, design, testing, Notion export |
- | **19** | Outlook integration | Microsoft Office integration |
- | **20** | Freee/MoneyForward | Accounting data operations |
- | **21** | Figma integration | Design systems and UI collaboration |
- | **22** | Discord integration | Bot and channel operations |
- | **23** | LINE official account | Messaging and account operations |
- | **24** | Salesforce CLI integration | CRM queries and metadata operations |
- | **25** | Google Ads integration | Advertising data operations |
- | **29** | slide-forge | Slide generation and revision workflows |
- ---
- ## Required APIs
- ### Required
- | API | Description | Where to Get | Purpose |
- |-----|-------------|--------------|---------|
- | **Gemini API** | Google's generative AI API | [Google AI Studio](https://aistudio.google.com/) | Image generation, text analysis, content creation |
- ### Strongly Recommended (Required for Modules 4, 8, 9, 12)
- | API | Description | Where to Get | Purpose | Required Module |
- |-----|-------------|--------------|---------|-----------------|
- | **Google OAuth** | Google account integration | [Google Cloud Console](https://console.cloud.google.com/) | Gmail, Calendar, Drive operations | 4, 10 |
- | **BigQuery** | Google's SQL data warehouse | [Google Cloud Console](https://console.cloud.google.com/) | Large-scale data analysis | 8 |
- | **Slack API** | Slack workspace integration | [Slack App Directory](https://api.slack.com/apps) | Message retrieval, auto-replies | 9 |
- | **Notion (OAuth)** | Notion workspace integration | `ncli login` (browser OAuth) + Notion Hosted MCP (`https://mcp.notion.com/mcp`) | Database operations | 12 |
- ### Optional (Recommended for Module 15)
- | API | Description | Where to Get | Purpose |
- |-----|-------------|--------------|---------|
- | **FAL.ai** | AI image/video generation | [fal.ai](https://fal.ai) | Fast image generation |
- | **Kling AI** | Text-to-video generation | [Kling](https://klingai.com/) | Automated short video creation |
- | **HeyGen** | Avatar video generation | [HeyGen](https://www.heygen.com/) | Automated explainer videos |
- | **Google Veo** | AI video generation model | [Google AI Studio](https://aistudio.google.com/) | High-quality video generation |
- | **GitHub Token** | GitHub integration | [GitHub Settings](https://github.com/settings/tokens) | CI/CD operations |
- ### API Key Setup Steps
- Refer to the following guides for details:
- - [Gemini API Setup](docs/setup-guides/docs/GEMINI_API_SETUP.md)
- - [Google OAuth Setup](docs/setup-guides/docs/GOOGLE_OAUTH_SETUP.md)
- - [BigQuery Setup](docs/setup-guides/docs/BIGQUERY_SETUP.md)
- - [Slack API Setup](docs/setup-guides/docs/SLACK_TOKEN_SETUP.md)
- - [Notion API Setup](docs/setup-guides/docs/NOTION_API_SETUP.md)
- ---
- ## Documentation
- ### Learning Materials
- | Document | Description |
- |----------|-------------|
- | [courses/aiagent](courses/aiagent) | Curriculum source of truth |
- | [docs/codex-guide.md](docs/codex-guide.md) | Codex getting started guide |
- | [Learning Checklist](PROGRESS_CHECKLIST.md) | Progress tracking checklist |
- ### Reference
- | Document | Description |
- |----------|-------------|
- | [Commands Reference](docs/commands-reference.md) | Auto-generated inventory of all commands |
- | [Skills Reference](docs/skills-reference.md) | Auto-generated inventory of all skills |
- | [Claude Code Guide](CLAUDE.md) | Claude Code specific features |
- ### 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](docs/troubleshoot.md) for solutions to common issues.
- ---
- ## FAQ
- ### Setup
- **Q: What if Python is not installed?**
- A: Download and install from:
- - [Python Official](https://www.python.org/downloads/)
- - Check "Add Python to PATH" during installation
- **Q: I can't install packages on macOS**
- A: Use Homebrew:
- ```bash
- 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 official web course FAQ on [ai-agent.camp](https://ai-agent.camp) (as of 2026-08-31) estimates about **50–60 hours** for the full 47-module catalog. This repository's `course.yaml` estimates 50 hours. At about 1 hour per day, that is 1–2 months; at 4 hours per day, about 2 weeks. You can also start from the modules you need.
- **Q: Is there a certificate of completion?**
- A: You can track your progress with the checklist in [PROGRESS_CHECKLIST.md](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](docs/security-guardrails.md) for security best practices. Enterprise configurations are possible.
- ---
- ## Contributing
- We welcome your feedback and suggestions for improvement!
- ### Bug Reports & Feature Requests
- 1. Check [Issues](https://github.com/minicoohei/ai-agent-camp/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](#documentation)
- - [Course Website](https://ai-agent.camp)
- - [Troubleshooting](docs/troubleshoot.md)
- ### Questions & Help
- | Method | Use For |
- |--------|---------|
- | [GitHub Issues](https://github.com/minicoohei/ai-agent-camp/issues) | Bug reports, feature requests, technical questions |
- | [Discussions](https://github.com/minicoohei/ai-agent-camp/discussions) | General questions, information sharing, idea proposals |
- ### In-Tool Help
- ```bash
- # 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](https://github.com/minicoohei/ai-agent-camp)
- - **Issue Tracker**: [Issues](https://github.com/minicoohei/ai-agent-camp/issues)
- - **Release Notes**: [Releases](https://github.com/minicoohei/ai-agent-camp/releases)
- ---
- ## Related Resources
- ### Official Documentation
- - [Claude AI Documentation](https://claude.ai/docs)
- - [Cursor Official Docs](https://cursor.com/docs)
- - [Google Gemini API Docs](https://ai.google.dev/docs)
- ### Community
- - [Claude Community Discord](https://discord.gg/claude)
- - [Cursor Community](https://community.cursor.sh)
.claude/settings.json · Bundled script · 72 lines · 1 finding marked
- {
- "permissions": {
- "deny": [
- "Bash(rm -rf /*)",
- "Bash(rm -rf ~*)",
- Dismissed after review: Runs `rm -rf` against a root or home-directory path
- Line 5 on GitHub
- "Bash(rm -rf .*)",
- "Bash(git push --force:*)",
- "Bash(git push -f :*)",
- "Bash(git reset --hard:*)",
- "Bash(git clean -f:*)",
- "Bash(git clean -fdx:*)",
- "Bash(sudo rm:*)",
- "Bash(sudo:*)",
- "Bash(chmod -R 777:*)",
- "Bash(dd:*)"
- ]
- },
- "hooks": {
- "PreToolUse": [
- {
- "matcher": "Bash",
- "hooks": [
- {
- "type": "command",
- "command": "REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; python3 \"$REPO_ROOT/.claude/hooks/bash_guard.py\""
- },
- {
- "type": "command",
- "command": "REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; \"$REPO_ROOT/.claude/hooks/git-push-review.sh\""
- }
- ]
- },
- {
- "matcher": "Write|Edit",
- "hooks": [
- {
- "type": "command",
- "command": "REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; python3 \"$REPO_ROOT/.claude/hooks/write_guard.py\""
- }
- ]
- }
- ],
- "PostToolUse": [
- {
- "matcher": "Edit|Write",
- "hooks": [
- {
- "type": "command",
- "command": "REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; \"$REPO_ROOT/.claude/hooks/console-log-guard.sh\""
- }
- ]
- },
- {
- "matcher": "Bash",
- "hooks": [
- {
- "type": "command",
- "command": "REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; python3 \"$REPO_ROOT/.claude/hooks/pptx_quality_check.py\""
- }
- ]
- }
- ]
- },
- "enabledPlugins": {
- "context7@claude-plugins-official": true,
- "codex@openai-codex": true
- },
- "language": "日本語",
- "showThinkingSummaries": true,
- "effortLevel": "high",
- "skipAutoPermissionPrompt": true
- }
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.