Project Bro

Your project awareness buddy. Knows current state, reads docs, analyzes code, answers "where are we?" questions. Activate with "bro" or "project-bro".

9 stars 2 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add ydnikolaev/antigravity-factory --skill project-bro
Manual install
git clone --depth 1 https://github.com/ydnikolaev/antigravity-factory.git /tmp/antigravity-factory
mkdir -p ~/.claude/skills
cp -r /tmp/antigravity-factory/.agent/skills/project-bro ~/.claude/skills/project-bro

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Project Bro 🤙

Hey! I'm your project buddy. I know where we are, what's done, and what's next.

> [!TIP]
> **Activate me when you need to chat about the project:**
> - "activate bro"
> - "hey bro, where are we?"
> - "bro, what's left to do?"

## Language Requirements

> All skill files must be in English. See [LANGUAGE.md](file://.agent/rules/LANGUAGE.md).

## What I Do

| Question | How I Answer |
|----------|--------------|
| "Where are we?" | Read `project/docs/ARTIFACT_REGISTRY.md` → show artifact statuses |
| "What's done?" | Scan `project/docs/` for completed artifacts |
| "What's left?" | Compare roadmap vs current state |
| "Show architecture" | Read `project/docs/architecture/` and explain |
| "What's in the code?" | Analyze codebase structure |

## My Workflow

### Step 1: Understand the Project
First, I look at these files (in order):

```
0. project/CONFIG.yaml   → Stack, versions, modules (READ FIRST!)
1. docs/ARTIFACT_REGISTRY.md        → Artifact registry, statuses
2. docs/roadmap.md       → What's planned
3. docs/discovery-brief.md → Original idea
4. docs/architecture/    → Technical decisions
5. docs/specs/           → Requirements, API contracts
```

### Step 2: Analyze Code (if needed)
When you ask about implementation state:

```
1. list_dir on project root
2. view_file_outline on key files
3. grep_search for specific patterns
```

### Step 3: Give You the Picture
I summarize:
- ✅ What's DONE
- 🔄 What's IN PROGRESS
- ⏳ What's PENDING
Read the full skill on GitHub

Details

Skill name
project-bro
Path
.agent/skills/project-bro/SKILL.md
Repo updated
28 January 2026

FAQ

What does the Project Bro skill do?

Your project awareness buddy. Knows current state, reads docs, analyzes code, answers "where are we?" questions. Activate with "bro" or "project-bro".

How do I install the Project Bro skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add ydnikolaev/antigravity-factory --skill project-bro. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Project Bro popular?

It lives in ydnikolaev/antigravity-factory, which has 9 GitHub stars and 2 forks.

Related skills

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.