Guide · Agent skill
How to use the Guided Tour of Open SaaS agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The guided-tour skill is an agent skill for the Open SaaS template, a React and Wasp based SaaS starter. Once it is installed, you ask your agent for a tour and it walks you through the project section by section, pointing at the matching files in your code. This guide covers what the skill does, how to install it, how to trigger it, and what it needs to run.
Guided Tour of Open SaaSwasp-lang/open-saas · MIT Download the skill Quick start
- 1Download the ZIP. Download the guided-tour ZIP from the skill page and unzip it. Confirm the folder contains SKILL.md.
- 2Place the skill. Move the guided-tour folder into ~/.claude/skills/ for a personal install, or into the project's .claude/skills/ folder for a single project.
- 3Or upload it in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
- 4Open the Open SaaS project. Open your Open SaaS project so the agent can read the code the tour refers to.
- 5Ask for a tour. Send a request such as 'Give me a guided tour of Open SaaS'.
- 6Go section by section. Read each section the agent presents, look at the files it points out, and ask questions at each pause.
What is an agent skill and what does guided-tour do?
An agent skill is a folder containing a SKILL.md file that gives an AI agent instructions for a specific task. When a skill is loaded, the agent follows those instructions when you ask for the matching kind of help.
The guided-tour skill tells the agent to take you through the Open SaaS project. It first fetches the project's documentation map, then fetches the 'Guided Tour' guide from it. It works through that guide one section at a time, presents each section, and points out the relevant files and code in your project.
After each major section the agent pauses and asks whether you have questions. If you ask one, it answers using the guide, your project's code, or additional pages from the documentation map.
- Reads the Open SaaS documentation online and your project code
- Presents one section at a time, with matching files pointed out
- Pauses after each major section so you can ask questions
- Does not run any scripts from the skill itself
Install the guided-tour skill
Download the guided-tour ZIP from this page and unzip it. The skill is a single file, SKILL.md, inside the guided-tour folder.
For a personal install that applies everywhere, unzip the folder into ~/.claude/skills/. To limit the skill to one project, unzip it into that project's .claude/skills/ folder instead.
In the Claude apps you can instead upload the skill under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/
- Project install: the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload
How do you trigger the tour?
The skill is user-invocable, so you start it by asking for a tour of Open SaaS in plain language. You do not need a special command. The skill's description names the request it covers: taking a guided tour of Open SaaS that walks through the project structure, features and customization checklist.
Good requests name Open SaaS and say what you want to learn. The agent will then start with Step 1 of the skill and fetch the documentation map.
- "Give me a guided tour of Open SaaS."
- "Walk me through the Open SaaS project structure step by step."
- "Take me through the Open SaaS customization checklist."
What happens during a tour
The skill sets a fixed order. The agent fetches the LLMs.txt index at docs.opensaas.sh, finds the 'Guided Tour' guide URL on raw.githubusercontent.com, and loads its full contents. That guide is the source of truth for the whole tour.
The agent then goes through the guide section by section. It keeps the pace comfortable and does not rush, so you can take your time. Answer questions as they come up, or say you are ready to continue.
- Step 1: fetch the documentation map from docs.opensaas.sh/llms.txt
- Step 2: fetch the Guided Tour guide from raw.githubusercontent.com
- Step 3: present each section, point out matching project files, then pause for questions
https://docs.opensaas.sh/llms.txtWhat the skill needs and safety notes
The skill needs internet access to docs.opensaas.sh and raw.githubusercontent.com, and an agent runtime that can load SKILL.md skills and fetch web content. It will fail without internet access, so it does not suit offline or locked-down environments.
The skill runs no scripts. It uses the network only to read documentation. Its only file is SKILL.md, and the skill is MIT licensed.
- Requires internet access to docs.opensaas.sh and raw.githubusercontent.com
- Requires an agent runtime that can load SKILL.md and fetch web content
- Runs scripts: no
- Uses network: yes
Tips for getting the most out of the tour
Clone or open the Open SaaS project before you start, so the agent can point at real files in your code. The tour is specific to Open SaaS, so it is not useful for other projects.
If a section raises a question, ask it right then. The agent is designed to pause for questions, and it can fetch more documentation when a topic goes beyond the guide.
- Open the Open SaaS project in your agent before starting the tour
- Ask follow-up questions at each pause rather than waiting until the end
- For quick lookups later, reading the docs directly is faster than a full tour
What people use it for
- Understanding the folder layout after cloning Open SaaS for the first time
- Onboarding a new team member to a React and Wasp based SaaS starter
- Learning how the features of Open SaaS fit together before customizing them
- Working through the customization checklist with the matching files open
Frequently asked questions
How do I install the guided-tour agent skill?
Download the guided-tour ZIP and unzip it into ~/.claude/skills/ for a personal install, or into a project's .claude/skills/ folder to limit it to that project. In the Claude apps, you can instead upload it under Settings → Capabilities → Skills.
What do I need to run the guided tour?
You need an agent runtime that can load SKILL.md skills and fetch web content, plus internet access to docs.opensaas.sh and raw.githubusercontent.com. Without internet access the skill will fail.
Is the guided-tour skill free to use?
The skill is MIT licensed, as stated on this page. Check the license of your agent runtime separately, since the source does not cover it.
Does the guided tour run scripts on my computer?
No. The skill runs no scripts. It reads documentation from the network and your project code, and its only file is SKILL.md.
Can I use the guided tour on a project that is not Open SaaS?
No. The tour is specific to the Open SaaS template and follows its Guided Tour guide, so it is not useful for other projects.
Is reading the docs better than the guided tour?
It depends on your goal. The tour suits developers new to the project layout who prefer a guided conversation. If you only need a quick reference, reading the docs directly is faster.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use guided-tour if you have just cloned Open SaaS, are new to its React and Wasp structure, or prefer learning through a guided conversation. Skip it if you only need a quick lookup, you work offline or in a locked-down environment, or your project is not Open SaaS.
Download the skill