superhero-tech/super-brain

# Feynman

Take a concept out of `4-Knowledge/`, explain it in words a child owns, and mark every place the explanation went thin. Those places are the gaps.

Teach in the language the human is using.

**This skill reads the wiki and never edits it.** It saves the session to `9-Outputs/` and logs it, so there is a record of what got studied - but it creates no wiki page, changes no existing page, and touches nothing in `5-Raw/`. Learning is not ingesting.

## How to invoke

- "Explain X to me properly"
- "Feynman me on [topic]"
- "What am I fuzzy on?"
- `/feynman`

# Ingest

Turn a source into wiki. Not one summary page per file - one page per concept, plus every existing page this source has something to say about.

Write wiki pages in the language the human writes in. One language per page.

## How to invoke

- "Process this", "run an ingest", "I dropped something in Inbox"
- "Process the whole inbox" for batch mode
- `/ingest`

Sources live in `2-Inbox/`. If the human clips with Obsidian Web Clipper on its default settings, check `Clippings/` too.

# Lint

Find what has rotted in the wiki, rank it, and hand the list to the human. Fixing is a separate decision.

Write the report in the language the wiki is written in.

## How to invoke

- "Check the wiki", "run a lint", "health check"
- The monthly maintenance pass
- Before the human leans on the vault for something expensive

## What this catches, and what it does not

# Project Start

Copying three files takes a second. The value of this skill is the conversation that fills them, because a brief nobody pushed back on says "for all users" and "success is more engagement" and helps no one.

Run the interview in the language the human is using.

## How to invoke

- "New project", "let's start a project on X"
- Work that has been living in the chat needs a folder
- `/project-start`

## How it works

# Project Update

Turn "here is what happened this week" into project state someone can pick up cold in three months.

Write every file in the language the human is using.

## How to invoke

- "I have an update", "here is what happened", "update the project"
- The human reports a decision, a prototype, a test result or a piece of research
- The scope of a project has moved

## How it works

# Query

Answer from the wiki, not from memory, and keep the answer so the next question starts further along.

Write the answer and every file you produce in the language the human is using.

## How to invoke

- Any question the vault plausibly covers
- "What do we know about X?"
- "Compare X and Y from what I have"
- "Write me a briefing on X"
- `/query`

# Second Brain Setup

## Purpose

Runs a conversation with the product builder and writes the result to `8-System/about.md`. That file tells the agent who the human is, how they want to be treated and where they need to be pushed. It works as a pair with `8-System/brain.md`, which holds the universal operating rules.

## When to use

- Setting up a new vault for the first time
- Refreshing the profile after a role change, a new project or a shift in priorities
- When the AI feels "out of calibration"

## How it works

# YouTube Video Summary

Turns a YouTube video into a structured note, then compiles that note into a wiki page in Knowledge.

## When to use

- You want a video turned into a clean note with metadata and key ideas
- For tutorials the output is a step-by-step guide, not a summary

## Requirements

This skill pulls metadata and subtitles with `yt-dlp`. Install it once:

```bash