# facts

This skill produces a short briefing on the critical facts of an effort and what they imply, before or after the work.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 469 installs · ★ 143
- Author: backnotprop
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/backnotprop/bro/tree/HEAD/skills/facts/SKILL.md
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/skills/facts

## What it does

\`facts` gives a capable engineer a tight summary of the current effort: only the facts that matter and how they affect existing or future parts of the system. It is not a full audit. The scope is whatever has been discussed or planned recently, or just built. Author is backnotprop, repo `backnotprop/bro`.

The skill ships as a single `SKILL.md` file. Its instruction is to keep every fact terse, direct and free of jargon, assuming the reader is new to this context but a competent engineer. Slogans and rhetorical flourishes are out.

One detail matters in practice: the frontmatter sets `disable-model-invocation: true`. The skill never fires on its own. You invoke it by typing `$facts`, and that is the only way it runs — so if you expect automatic briefings after each task, you will not get them.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add backnotprop/bro --skill facts -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/facts/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/facts/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add backnotprop/bro --skill facts -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/facts/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add backnotprop/bro --skill facts -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/facts/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install backnotprop/bro facts
```

2. **Manually: put the files in place**
- File: `.github/skills/facts/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add backnotprop/bro --skill facts -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/backnotprop/bro --path skills/facts
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/facts/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add backnotprop/bro --skill facts -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/backnotprop/bro/tree/HEAD/skills/facts/SKILL.md

## When to use it
- get a short list of key facts before starting work
- see how a decision affects code already written
- learn what changed after a finished task
- separate critical items from noise in the next phase plan
- explain the gist of a task to a newcomer without jargon

## Example prompts
- $facts — what do I need to know before we start this phase?
- $facts — what did we just build and what does it imply?
- $facts on the current task, only the critical parts

## Similar
- [matter-briefing](https://affpapa.org/en/nevibecode/skills/matter-briefing.md) — skill · 608 installs
- [meeting-briefing](https://affpapa.org/en/nevibecode/skills/meeting-briefing.md) — skill · 3000 installs
- [roundup](https://affpapa.org/en/nevibecode/skills/roundup.md) — skill · 1300 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs
- [planning-with-files](https://affpapa.org/en/nevibecode/skills/othmanadi-planning-with-files.md) — skill · 47000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
