start

Initializes project workflow files with stack-aware CLAUDE.md, git hooks, and GitHub Actions.

3|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/bravros/bravros --skill start-bravros
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: start
Source: https://github.com/bravros/bravros/tree/main/plugins/core/skills/start
Command: npx skills add https://github.com/bravros/bravros --skill start-bravros

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a new project for agent-assisted development requires many repetitive, error-prone steps: writing a CLAUDE.md, configuring git hooks, creating a staging branch, and wiring GitHub Actions workflows. This Skill automates that entire bootstrap in one explicit invocation. ## Core Features & Use Cases - Stack Detection and Caching: Detects Laravel, Next.js, Expo, Node, Go, or Python from project markers and caches the result in .bravros/config.json for later sessions. - Init and Update Modes: Creates CLAUDE.md, sync-db.sh, git hooks, and .planning/ on fresh repos without overwriting existing files; on established repos it only refreshes the claude.yml workflow. - Branch and CI Setup: Creates the homolog staging branch and writes claude.yml (@claude trigger) and tests.yml (@tests trigger) GitHub Actions workflows following documented GitHub gotchas. - Use Case: A developer clones a Laravel starter repo, types /start, and gets a filled CLAUDE.md, a database sync script, a homolog branch pushed to origin, and working PR automation in one pass. ## Quick Start Type /start in a git repository to initialize the project workflow files for your detected stack.

Frequently Asked Questions about start

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

FAQPage Schema
How do I initialize a project for Claude Code with one command?▼

Type /start inside a git repository. The skill detects your stack, generates a stack-aware CLAUDE.md, configures git hooks, creates a staging branch, and writes GitHub Actions workflows without overwriting existing files.

How does the /start skill detect my project's tech stack?▼

It inspects project markers: composer.json with laravel/framework maps to Laravel, package.json with next to Next.js, react-native or expo to Expo, go.mod to Go, and requirements.txt or pyproject.toml to Python. The result is cached in .bravros/config.json.

Will /start overwrite my existing CLAUDE.md file?▼

No. In update mode, triggered when .githooks/ or .github/workflows/claude.yml already exists, the skill never touches an existing CLAUDE.md and only refreshes the claude.yml workflow. Init mode uses cp -n everywhere.

What GitHub Actions workflows does /start create?▼

It writes claude.yml, which runs Claude Code when @claude appears in comments or issues, and tests.yml, which runs the project's test suite when @tests is commented on a PR. Both follow documented GitHub permission and checkout gotchas.

What happens if my repository has no staging branch?▼

The skill asks for your staging branch name, defaulting to homolog, and creates and pushes it. If you have a main-only repo, it instead enables the police direct-main mode in .bravros/config.json so main is not gated.