setup-project

Initialize and validate a Breeze workspace by configuring credentials and linking a project.

2|2|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/accionlabs/breezeai-claude-plugin --skill setup-project-accionlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-project
Source: https://github.com/accionlabs/breezeai-claude-plugin/tree/main/skills/setup-project
Command: npx skills add https://github.com/accionlabs/breezeai-claude-plugin --skill setup-project-accionlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the manual, error‑prone steps of configuring API keys, linking a Breeze project, and verifying ontology readiness, allowing teams to get started quickly and securely.

Core Features & Use Cases

  • Credential Setup: Prompts for and stores the Breeze API key and optional AWS credentials in .breeze.json.
  • Project Linking: Lists existing projects or creates a new one, then records the project UUID.
  • Ontology Check: Queries the Breeze MCP to report the current state of code, functional, and design graphs.
  • Guided Next Steps: Provides tailored recommendations for onboarding repositories, analyzing requirements, or visual‑to‑text conversion based on the project's status.

Quick Start

Invoke the /breeze:setup-project command to configure your workspace and link your project.

Frequently Asked Questions about setup-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Breeze workspace and link my project?

To set up a Breeze workspace, invoke the setup command to configure API keys, list or create a project, and save credentials to a .breeze.json file. This process links your project by recording its UUID for subsequent code and document uploads.

What is ontology readiness and how do I check it in Breeze?

Ontology readiness indicates the current state of your code, functional, and design graphs. You check ontology readiness by querying the Breeze MCP API, which reports graph status and provides tailored next steps for onboarding repositories or analyzing requirements.

Do I need AWS credentials to configure a Breeze project?

AWS credentials are optional for configuring a Breeze project. The setup process requires a Breeze API key stored in .breeze.json, but you can provide optional AWS credentials if your specific workflow demands integration with AWS services.

Can I link an existing project when bootstrapping my Breeze workspace?

Yes, you can link an existing project when bootstrapping your Breeze workspace. The setup process lists available projects via Breeze MCP API calls, allowing you to select one or create a new one, recording the project UUID in .breeze.json.

What's the best way to automate Breeze API key configuration?

The best way to automate Breeze API key configuration is using the guided setup command, which securely prompts for and stores credentials in a .breeze.json file. This eliminates manual errors by validating keys and linking projects automatically.

Why does my Breeze project setup fail before uploading code?

Breeze project setup fails before uploading code if the .breeze.json file is missing credentials, the API key is invalid, or the project UUID is unlinked. The setup validates ontology readiness, ensuring code, functional, and design graphs are initialized.