agentleFS
frenzymathfrenzymath/Danus/.agents/skills/initialize/SKILL.md

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

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. reactive/data-client★ 2ksame name
    2. 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.

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
  1. Distinctive:

    Ask this multiple-choice question in the chat (state the options.

    line 34
  2. Distinctive:

    If they chose the paid-API backend: a spend ceiling (USD) to warn at.

    line 47
  3. Very specific:

    Branch: if on main, git checkout -b <branch> (never work on main).

    line 51
  4. Very specific:

    Never put secrets anywhere but config/*.env.

    line 56
  5. Very specific:

    Never commit config/*.env or runtime/.

    line 69
  6. Very specific:

    Verify, never claim unchecked: Before telling the operator a service/endpoint is up or that a step worked, confirm it (check-codex.sh exits …

    line 86

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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-current

Note: 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.

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.md records 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 on main).
  • Config: cp -n config/danus.env.example config/danus.env; set CODEX_BACKEND to their choice. If the backend is the OpenAI-compatible key, cp -n config/codex.env.example config/codex.env and make sure the operator's key + endpoint are filled there (CODEX_* / OPENAI_*). Never put secrets anywhere but config/*.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 run bash scripts/setup-codex.sh login and give the operator the printed URL + device code (they only open it and authorize).
  • Services (must persist beyond your session — services.sh uses setsid): bash scripts/services.sh up verify (required — no verify means fact_submit fails 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; see AGENTS.md). Never commit config/*.env or runtime/.

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.sh exits non-zero on ping failure; doctor.sh for 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 on main.
  • Secrets only in config/*.env — never commit config/*.env or runtime/; only OPERATOR.md (and the branch) are committed.
  • Invoke scripts from the repo root (or by absolute path). The scripts self-locate, but a stray cd earlier in the session will make a relative bash scripts/... call fail — cd to the project dir first if unsure.
  • Persist each answer before moving on, and only write runtime/.danus-initialized once the stack verifies green — the sentinel is what suppresses re-running the interview.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.