How to use the Open SaaS Getting Started agent skill

What is an agent skill and what does this one do?

An agent skill is a folder containing a SKILL.md file with instructions that an AI agent loads when it is relevant to your request. This skill is named getting-started and is included in the Open SaaS template under template/app/.agents/skills/getting-started.

When triggered, the skill tells the agent to follow three steps in order: fetch the documentation map from the LLMs.txt index at docs.opensaas.sh, fetch the Getting Started guide from its raw.githubusercontent.com URL and treat it as the source of truth, then run wasp version to check the Wasp installation.

• If Wasp is installed, the agent confirms the version and continues.
• If Wasp is not installed, the agent walks you through the installation steps from the guide for your operating system, then verifies with wasp version.
• Last, the agent asks whether you want help starting your managed PostgreSQL database and Wasp app, and if you say yes, it follows the guide's steps for starting the database, running migrations and starting the dev server.

Install the skill with a ZIP download or the Claude apps

Download the ZIP of the getting-started skill from this page, then unzip it. For a personal setup, place the unzipped folder in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder.

If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.

• Personal install: ~/.claude/skills/ (available across your projects).
• Project install: .claude/skills/ inside your project folder (available only there).
• Claude apps: Settings → Capabilities → Skills, then upload.

Check the requirements before you trigger the skill

The skill depends on three things. It runs wasp version, so the Wasp CLI needs to be on your computer or the agent must be able to install it. It expects a PostgreSQL database, which you set up following the guide. And it needs internet access to docs.opensaas.sh and raw.githubusercontent.com to fetch documentation.

• Wasp CLI installed, or permission for the agent to guide you through installing it.
• A PostgreSQL database, set up as the Getting Started guide describes.
• Internet access to docs.opensaas.sh and raw.githubusercontent.com.
• Your agent must be able to run local commands, because the skill executes them.

How do you trigger the skill with a natural request?

The skill description is about getting started with an Open SaaS project, so ask your agent in plain language that matches that purpose. The skill is user-invocable, which means you can also call it directly if your agent supports that. The skill source does not list specific trigger phrases, so the examples below are simply requests that match its description.

• "Help me get started with this Open SaaS project."
• "Check whether Wasp is installed and tell me what version I have."
• "Walk me through starting the database and dev server for this Open SaaS app."
• "I just cloned the Open SaaS template. What do I do first?"

What happens during a typical first run?

A typical run starts with the agent fetching documentation, which it does over the network. It then runs wasp version. If you see a version number, the agent moves on. If Wasp is missing, expect the agent to pause and guide you through installation, then re-check.

After the check, the agent asks before doing more. Starting the database, running migrations and launching the dev server only happen if you agree. If something fails, the agent is told to troubleshoot using the guide's content rather than guessing.

Safety notes: scripts and network access

This skill runs scripts and uses the network. It executes the local command wasp version and may guide installation, and it fetches remote documentation from docs.opensaas.sh and raw.githubusercontent.com. Before using it, be comfortable with an agent running commands on your machine.

If you do not want the agent running commands such as wasp version, do not install this skill. The skill's source is MIT licensed, so you can read the full SKILL.md before installing it.

• Read SKILL.md first; the whole skill is one file.
• Use it in a project you are willing to let the agent run commands in.
• Confirm each command the agent proposes before you approve it, especially any installation step.

Tips for a smoother first run

Clone or open the Open SaaS project before triggering the skill so the agent is working in the right folder. Keep the Getting Started guide open in a browser so you can compare what the agent says with the original steps. If you already know your Wasp and database setup, you may find the guided steps add little value and can skip the skill.

• Open the project folder first, then make your request.
• Have a PostgreSQL database ready so the database step is not blocked.
• Keep the guide open alongside the agent's steps.