facts — Claude Code skill: a terse briefing on the facts
This skill produces a short briefing on the critical facts of an effort and what they imply, before or after the work.
npx skills add backnotprop/bro --skill facts -a claude-codeWhat facts 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.
What it helps with
- 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 for the agent
- $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
How to install facts
1Skills CLI (Vercel)
npx skills add backnotprop/bro --skill facts -a claude-code2Manually: put the files in place
~/.claude/skills/facts/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/facts/
1Skills CLI (Vercel)
npx skills add backnotprop/bro --skill facts -a codex2Manually: put the files in place
.agents/skills/facts/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add backnotprop/bro --skill facts -a cursor2Manually: put the files in place
.cursor/skills/facts/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install backnotprop/bro facts2Manually: put the files in place
.github/skills/facts/SKILL.md1Skills CLI (Vercel)
npx skills add backnotprop/bro --skill facts -a gemini-cli2Platform CLI
gemini skills install https://github.com/backnotprop/bro --path skills/factsManually: put the files in place
.devin/skills/facts/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add backnotprop/bro --skill facts -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about facts
How do I install facts in Claude?
Run npx skills add backnotprop/bro --skill facts -a claude-code. The skill lands at ~/.claude/skills/facts/SKILL.md.
What does the facts skill do?
It gives a short briefing on the critical facts of an effort and their implications, either before the work starts or after it finishes.
Does facts run automatically?
No. The frontmatter sets disable-model-invocation: true, so it only runs when you explicitly invoke $facts.
