initialize
Skill391 starsChanged 3 months agoApache-2.0View on GitHub
First-run setup interview for a Danus deployment. Run it on the FIRST session, whenever runtime/.danus-initialized is absent or OPERATOR.md is still the blank template, or when the operator asks to set up / initialize / onboard / re-configure. It greets the operator, explains Danus, asks the critical choice (codex backend) plus a few free-text fields (how to address them, language, git branch, spend ceiling), then provisions everything (branch, config/danus.env, OPERATOR.md, codex login, verify service) and marks runtime/.danus-initialized. The system cannot run without these answers, so do not skip it.
- Reads credentials
2 other projects use a version of this.
Adopted by
Most recently taken up by
- Melvynx/ai-maxxing-skillstheir own version, first seen Nov 1, 2026
- reactive/data-clienttheir own version, first seen Oct 9, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- reactive/data-client★ 2ksame name
- Melvynx/ai-maxxing-skills★ 32same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository4 other files it gives its agents.
- AGENTS.mdAGENTS.md
- elaborationSkill
- human-summarySkill
- write-paperSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 2 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- could be automatic: a setting could enforce it
- Distinctive: line 34
Ask this multiple-choice question in the chat (state the options.
- Distinctive: line 47
If they chose the paid-API backend: a spend ceiling (USD) to warn at.
- Very specific: line 51
Branch: if on main, git checkout -b <branch> (never work on main).
- Very specific: line 56
Never put secrets anywhere but config/*.env.
- Very specific: line 69
Never commit config/*.env or runtime/.
- Very specific: line 86
Verify, never claim unchecked: Before telling the operator a service/endpoint is up or that a step worked, confirm it (check-codex.sh exits …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
initialize — first-run setup interview
You are the Danus main agent meeting this operator for the first time on this
deployment. Collect the few critical settings by asking (never auto-decide),
set everything up, and leave a clean, initialized, running system. Open the interview in the operator's language if you
already know it; otherwise use English, then honor the language they pick below
(this is the moment their language preference is first captured — record it in
OPERATOR.md and follow it thereafter).
0. Greet + orient (brief)
Tell the operator, in 2–3 sentences: Danus is an automated mathematics system —
codex workers prove, a verifier is the sole gate on correctness, and you
(codex) orchestrate; you'll ask a few setup questions, then you're ready
to take a problem. Say the answers are saved permanently (OPERATOR.md), so this
is a one-time setup.
1. Read current state (so you don't ask about what's already done)
bash scripts/doctor.sh
git branch --show-currentNote: codex reachable? on main (needs a working branch)? config/danus.env
present? OPERATOR.md filled or still the template?
2. Ask the choices — as plain questions in the conversation
Ask this multiple-choice question in the chat (state the options; put the recommended one first and label it). There is no popup — codex asks in plain text and reads the operator's reply:
- codex backend (what the workers + verifier run on) —
- OpenAI-compatible API key (recommended): the key you place in
config/codex.env— works immediately, no login. - My own ChatGPT subscription: device-code login.
- OpenAI-compatible API key (recommended): the key you place in
Then ask, as plain text questions:
- How to address them (name), and their language (default English) — this sets
the language you use with them from now on (
OPERATOR.mdrecords it). - The git working branch name (default
deploy/<operator-or-host>). - If they chose the paid-API backend: a spend ceiling (USD) to warn at.
3. Provision — act on the answers, persisting each before moving on
- Branch: if on
main,git checkout -b <branch>(never work onmain). - Config:
cp -n config/danus.env.example config/danus.env; setCODEX_BACKENDto their choice. If the backend is the OpenAI-compatible key,cp -n config/codex.env.example config/codex.envand make sure the operator's key + endpoint are filled there (CODEX_*/OPENAI_*). Never put secrets anywhere butconfig/*.env. - OPERATOR.md: fill name / language / spend ceiling / default worker roster, in place (no duplicates).
- codex: backend=api →
bash scripts/check-codex.sh(confirm reachable); backend=chatgpt → you runbash scripts/setup-codex.sh loginand give the operator the printed URL + device code (they only open it and authorize). - Services (must persist beyond your session —
services.shuses setsid):bash scripts/services.sh up verify(required — no verify meansfact_submitfails and the whole pipeline is silently dead). - Verify the stack:
bash scripts/doctor.sh; report green/red plainly. - Mark done:
mkdir -p runtime && date -u +%FT%TZ > runtime/.danus-initialized. - Commit (git discipline): commit
OPERATOR.md(and the new branch) locally — do not push (push is an explicit operator action, never automatic; seeAGENTS.md). Never commitconfig/*.envorruntime/.
4. Hand off
Summarize the chosen backend, confirm the system is up, then ask
for the math problem (or return to the operator's original request). When they
give it, write runtime/projects/<p>/PROBLEM.md and begin the strategic loop.
Also mention, in one line, a capability they'll want later so it isn't hidden:
when you eventually write a paper, you can drop your own papers into the
write-paper skill's style/anchors/ folder so the output matches your writing
voice (see that folder's README.md; a complete paper is produced either way).
Rules:
- Ask, don't assume — the choices are the operator's call. "Use the defaults" is fine, but record it explicitly. If a step needs something only they can supply (a key, a login), pause and ask rather than guessing.
- Verify, never claim unchecked. Before telling the operator a service/endpoint
is up or that a step worked, confirm it (
check-codex.shexits non-zero on ping failure;doctor.shfor the rest). A premature "it's up" that turns out to be a failure is exactly what to avoid. - Never work on
main— branch first if onmain. - Secrets only in
config/*.env— never commitconfig/*.envorruntime/; onlyOPERATOR.md(and the branch) are committed. - Invoke scripts from the repo root (or by absolute path). The scripts
self-locate, but a stray
cdearlier in the session will make a relativebash scripts/...call fail —cdto the project dir first if unsure. - Persist each answer before moving on, and only write
runtime/.danus-initializedonce the stack verifies green — the sentinel is what suppresses re-running the interview.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

