onboard-repository

Upload a source repository into the Breeze code graph with Node.js 22+.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Uploads a repository into the Breeze code graph for the current project. This skill wraps the breeze-code-ontology-generator CLI with --capture-statements so method-level statements are captured for downstream skills (generate-functional-from-ui, generate-functional-from-backend, generate-code, search). Verifies Node.js 22+ before running and resolves the target repo from a path argument or the current directory. Run once per repo. Re-run to re-index after large changes. Use when: "onboard repo", "upload repository", "index repo into breeze", "add repo to project", "ingest codebase", "register code graph", or whenever a Breeze skill reports the project has no code ontology yet.

Core Features & Use Cases

  • Upload a repository into Breeze's code graph for the current project, capturing files, classes, functions, route decorators, call chains, and method-level statements
  • Downstream compatibility: works with /breeze:generate-functional-from-ui, /breeze:generate-functional-from-backend, /breeze:generate-code, /breeze:search, /breeze:analyze-functional
  • Run once per repo to index frontend and backend components and refresh the code graph.

Quick Start

Onboard a repository by providing its absolute path to the Breeze onboard-repository skill.

Frequently Asked Questions about onboard-repository

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

FAQPage Schema
How do I index a repository into the Breeze code graph?

To index a repository into the Breeze code graph, provide its absolute path to the onboard-repository skill. It resolves the target directory, runs the code ontology generator with statement capture, and uploads the graph to the current project.

What does capturing method-level statements in a code graph do?

Capturing method-level statements in a code graph records detailed function logic and call chains during repository upload. This enables downstream Breeze skills to generate UI, backend code, and perform functional analysis based on the captured statements.

Do I need Node.js 22 to upload a codebase to Breeze?

Yes, you need Node.js 22 or higher to upload a codebase to Breeze. The onboarding process verifies Node.js 22+ before running the code ontology generator and applying the code graph to your project.

Can I onboard a repository to Breeze without a .git directory?

You can onboard a repository without a .git directory if it contains a valid manifest file. The skill enforces repository integrity checks and requires either a .git folder or a manifest before proceeding with the code graph upload.

How do I configure Breeze credentials for code graph onboarding?

To configure Breeze credentials for code graph onboarding, create a .breeze.json file in your project. This file must contain your apiKey, projectUuid, and apiBase values, which the onboarding process validates before uploading.

When should I re-index my repository into the Breeze code graph?

You should re-index your repository into the Breeze code graph after making large changes to your codebase. The initial onboarding runs once per repo, but re-running updates the graph to capture new files, classes, functions, and method-level statements.