Agent skill

Project Start

by superhero-tech in superhero-tech/super-brain

Sets up a new project folder and runs the interview that fills its brief.

MITAuto-check passedKnowledge Management

Install Project Start

skills CLI
$ npx skills add superhero-tech/super-brain --skill project-start -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install superhero-tech/super-brain project-start --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/superhero-tech/super-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/7-Skills/project-start .claude/skills/project-start && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-start
GitHub stars
160
Token cost
~1.1k tokens
SKILL.md length
659 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Sets up a new project folder and runs the interview that fills its brief.

  • Works in 7 steps: Name it → Create the folder → Check what the vault already knows → …
  • The human starts a new project
  • SKILL.md covers How to invoke, How it works, Self-check and Hard constraints
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Project Start is an agent skill from superhero-tech/super-brain. Sets up a new project folder and runs the interview that fills its brief. Use when the human starts a new project, or when work that has been living in chat needs a home with a brief, rules and a log.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Knowledge Management. The repository describes itself as: Product Builder Second Brain - AI Product Heroes Edition 3. The licence is MIT.

When your agent uses it

  • The human starts a new project
  • Work that has been living in chat needs a home with a brief
  • Rules and a log

Example prompts

  • “/project-start”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Name it
  2. Create the folder
  3. Check what the vault already knows
  4. Run the brief interview
  5. Show the draft, then write
  6. Ask about rules
  7. Register it

What it can do on your machine

Read from SKILL.md and the folder at commit 0922a1a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Start loads about 1.1k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 659 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from superhero-tech/super-brain at commit 0922a1a, republished under its MIT licence (© superhero-tech). 659 words, ~1,053 tokens.

Download SKILL.mdSave it as .claude/skills/project-start/SKILL.md (or your agent's skills folder).
name
project-start
description
Sets up a new project folder and runs the interview that fills its brief. Use when the human starts a new project, or when work that has been living in chat needs a home with a brief, rules and a log.

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

1. Name it

Get the project name, and derive a kebab-case slug: contract-tracker, q3-pricing.

Check 3-Projects/ for a folder with that slug. If it exists, this is an update to an existing project, not a new one - say so and stop.

2. Create the folder

Copy 3-Projects/_template/ to 3-Projects/<slug>/, then create the four working subfolders: discovery/, decisions/, prototypes/, analyses/.

Do not fill in the brief yet.

3. Check what the vault already knows

Read 4-Knowledge/index.md and look for pages that bear on this domain. If there are any, name them:

Before we start: the wiki already has [[Page A]] and [[Page B]] on this. Want me to link them from the brief so you are not starting from zero?

This is the payoff for every source ever ingested. On an empty wiki, skip it without comment.

4. Run the brief interview

One question at a time, in this order. Do not paste the whole template and ask them to fill it in.

SectionWhat you are asking forPush back when
In one sentenceWhat it does and for whomIt needs an "and" to hold two ideas - that is usually two projects
Who it is forA segment they could go and find tomorrowThe answer is "everyone", "users", "SMBs" - ask who the first ten would be
What done looks likeAn outcome with a number and a dateThe answer is a direction. "More engagement" is not an outcome; "50 paying by end of Q2, or we stop" is
ContextWhy this project, why nowIt reads as a feature description rather than a reason
ConstraintsWhat is genuinely non-negotiable: money, deadline, people, tech, legalEverything is listed as a constraint, which means nothing is
Open questionsWhat they do not know yetThe list is empty on day one, which means the project has not been thought about

Push back once per section, not three times. If the honest answer is "I do not know yet", that is a real answer: write it into Open questions and move on. A brief with holes that names its holes beats a project with no folder.

Show full SKILL.md (228 more words)Show less
5. Show the draft, then write

Show the filled brief in the conversation and wait for a yes before saving it. The human owns brief.md.

6. Ask about rules

Ask what constraints apply to this project specifically - things that should override the agent's normal behaviour. Most projects start with none.

When there are none, write an explicit "None yet." under each heading in rules.md. An empty file reads as "no contract here"; an explicit "None yet." reads as "asked and answered".

7. Register it
  • Add the row to 3-Projects/index.md: status active, the In-one-sentence line, today's date. The row format is in 3-Projects/README.md.
  • Write the first entry in <slug>/log.md: type scope-change, what changed is that the project exists, why is the reason they just gave you in Context.

Self-check

  • The slug did not already exist
  • brief.md was shown and agreed before it was written
  • Every section holds something specific, or names itself as an open question
  • rules.md says "None yet." rather than sitting empty
  • 3-Projects/index.md has the row and log.md has the first entry

Hard constraints

  • The brief is written after the human agrees to it, never from your own assumptions.
  • A section they could not answer becomes an open question. Filling it in yourself produces a brief that looks finished and means nothing.
  • The four working subfolders are created empty. Work goes in them later, not at setup.

© superhero-tech, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in 7-Skills/project-start of superhero-tech/super-brain.

Open the folder on GitHubat commit 0922a1a

Compare with similar skills

Project Start next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Start compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Start this skillsuperhero-tech/super-brain160—~1.1kAutomated safety check: PassMIT
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k3 repos~3.2kAutomated safety check: PassNone
Logseq Review Workflow Evallogseq/logseq45k—~1kAutomated safety check: PassAGPL-3.0
Obsidian CLIAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0
Esm Cjs Risk Scanlogseq/logseq45k—~3.3kAutomated safety check: PassAGPL-3.0
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence

Similar skills

  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 3 repos~3.2k tokens
    Knowledge ManagementAuto-check passed
  • Compare two revisions of the Logseq logseq-review-workflow skill by running the same review prompt against isolated before and after skill snapshots, collecting both outputs, and producing a…

    45k GitHub stars~1k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed
  • Esm Cjs Risk Scan

    logseq/logseq

    Scan Logseq ClojureScript Node/Electron targets for npm module loading risks, especially ESM-only packages that may fail when loaded through js/require or shadow-cljs require-based shims.

    45k GitHub stars~3.3k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Karpathy LLM Wiki

    Astro-Han/karpathy-llm-wiki

    A skill your agent uses when building or maintaining a personal LLM-powered knowledge base.

    2.4k GitHub stars~3.6k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed

More from superhero-tech/super-brain

All 8 skills in this repo
  • Ingest

    superhero-tech/super-brain

    Compiles a source from 2-Inbox/ into the wiki, across every page it touches, then archives it.

    160 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Second Brain Setup

    superhero-tech/super-brain

    A skill your agent uses when creating or refreshing a product builder's personal profile in 8-System/about.md - supports both assessment-based (Gallup, DISC, MBTI) and interview-based onboarding

    160 GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check passed
  • Feynman

    superhero-tech/super-brain

    Explains a concept from the wiki the way you would explain it to a twelve-year-old, then names where the explanation went thin.

    160 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Lint

    superhero-tech/super-brain

    Health check over the compiled wiki in 4-Knowledge/, written up as a ranked report.

    160 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Query

    superhero-tech/super-brain

    Answers from the compiled wiki in 4-Knowledge/, with citations and a saved output file.

    160 GitHub stars~909 tokensUpdated 1 mo ago
    Auto-check passed
  • Youtube

    superhero-tech/super-brain

    Captures a YouTube video as a source note and a wiki page. An agent skill from superhero-tech/super-brain.

    160 GitHub stars~985 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Project Start

What does Project Start do?

Sets up a new project folder and runs the interview that fills its brief. Project Start is an agent skill from superhero-tech/super-brain. Sets up a new project folder and runs the interview that fills its brief.

When should I use Project Start?

Project Start fits situations like: the human starts a new project; work that has been living in chat needs a home with a brief; rules and a log.

How do I install Project Start in Claude Code?

Run `npx skills add superhero-tech/super-brain --skill project-start -a claude-code`. Or copy the skill folder (7-Skills/project-start in superhero-tech/super-brain) into .claude/skills/project-start in your project. Claude Code loads it when a task matches its description.

How do I install Project Start in Codex?

Run `npx skills add superhero-tech/super-brain --skill project-start -a codex`. Or copy the skill folder (7-Skills/project-start in superhero-tech/super-brain) into .agents/skills/project-start in your project. Codex loads it when a task matches its description.

Can I use Project Start in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add superhero-tech/super-brain --skill project-start -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-start, .gemini/skills/project-start, .github/skills/project-start and .opencode/skills/project-start in your project.

What does Project Start need to run?

SKILL.md names no scripts, command-line tools or credentials: Project Start is instructions for the agent only.

Does Project Start access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Start safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Start use?

Project Start is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Start use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Project Start?

Skills that share tags, products or a category with Project Start: Baoyu URL To Markdown (sdyckjq-lab/llm-wiki-skill, 2.5k stars), Logseq Review Workflow Eval (logseq/logseq, 45k stars), Obsidian CLI (Atmosphere/atmosphere, 3.8k stars) and Esm Cjs Risk Scan (logseq/logseq, 45k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Start?

superhero-tech (a GitHub organization) maintains it in superhero-tech/super-brain, which has 160 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 25, 2026.

Source: superhero-tech/super-brain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.