Skip to content
Skills Library
AI & agents · Tool integration

thoth

/thoth

Official Codex public surface for the Thoth authority runtime. Use this skill when the user wants to operate Thoth through the single `$thoth <command>` public entry.

Repository
thoth ↗
Licence
MIT
Last repository change
15.06.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
13
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 15.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Official Codex public surface for the Thoth authority runtime. Use this skill when the user wants to operate Thoth through the single `$thoth <command>` public entry.

Original author description

Official Codex public surface for the Thoth authority runtime. Use this skill when the user wants to operate Thoth through the single `$thoth <command>` public entry.

How it works

  1. Public Entry
  2. Dispatcher
  3. Route Table
  4. Shared Rules
Original SKILL.md headings · 57 lines, 541 words
SKILL.md preview
---
name: thoth
description: Official Codex public surface for the Thoth authority runtime. Use this skill when the user wants to operate Thoth through the single `$thoth <command>` public entry.
---

# Thoth

Official Codex public surface for Thoth. This skill is generated from the same host-neutral command specification that renders the Claude `/thoth:*` commands.

## Public Entry

Use the single public entrypoint:

- `$thoth <command>`

Supported commands:
- `$thoth init`: Initialize, migrate, resync, or seed an intent discussion for canonical .thoth authority without taking ownership of repo-root `.codex`.
- `$thoth run`: Start one strict run bound to `work_id@revision`; live runs foreground and `--sleep` detaches the same runtime driver.
- `$thoth loop`: Start one bounded controller service whose parent creates four-phase child runs.
- `$thoth argue`: Run an adversarial attacker/adjudicator discussion against an idea, work item, or decision.
- `$thoth auto`: Run the DAG-first actionable work queue until ready/active/failed work is closed, paused, or stopped.
- `$thoth status`: Show repo status and active durable runs from the shared ledger.
- `$thoth discuss`: Discuss or record planning decisions without entering implementation execution.
- `$thoth doctor`: Alias for `status --doctor`; strictly audit project health without writing authority.
- `$thoth dashboard`: Alias for `status --dashboard`; manage the local dashboard backed by .thoth ledgers.
- `$thoth tui`: Open or snapshot the read-only terminal dashboard backed by shared Thoth providers.
- `$thoth extension`: Create, list, validate, and manage project-local Dashboard/TUI extensions and experiment registry objects.

## Dispatcher

- `.thoth` is the only runtime authority.
- Parse the requested `$thoth <command>`, then open only the matching micro prompt under `./commands/<command>.md`.
- Execute the literal shell command immediately; do not replace it with explanation.
- If `thoth` is not on PATH, use the installed Codex plugin cache or marketplace-root runtime entrypoint described by the micro prompt; do not use a local checkout as fallback.
- If neither PATH nor the installed Codex plugin cache / marketplace root contains the runtime entrypoint, treat that as host install drift.
- Do not create alternative public Codex variants such as `run:codex` or `loop:codex`.

## Route Table

- `init` -> `hybrid_init` / `intent_sensitive` / `result_envelope_or_command_packet`
- `run` -> `live_intelligent` / `high` / `phase_controller`
- `loop` -> `live_intelligent` / `high` / `phase_controller`
- `argue` -> `live_intelligent` / `high` / `argument_record`
- `auto` -> `live_intelligent` / `high` / `phase_controller`
- `status` -> `mechanical_fast` / `none` / `result_envelope`
- `discuss` -> `live_intelligent` / `high` / `command_packet`
- `doctor` -> `mechanical_fast` / `none` / `result_envelope`
- `dashboard` -> `mechanical_fast` / `none` / `result_envelope`
- `tui` -> `mechanical_fast` / `none` / `result_envelope`
- `extension` -> `mechanical_fast` / `none` / `result_envelope`

## Shared Rules

- `init` is hybrid: no intent is a mechanical audit-first receipt; natural-language intent opens an inquiring discussion and must be closed through compact project_patch/work_graph authority.
- `status`, `doctor`, `dashboard`, `tui`, and `extension` are mechanical fast-path commands and should return only short receipts.
- `discuss`, `run`, `loop`, `auto`, and `argue` are high-intelligence paths.
- `argue` preserves full attacker/adjudicator artifacts; authority patches require explicit confirmation before apply.
- `run` and `loop` use one RuntimeDriver: lifecycle is `plan -> execute -> validate -> reflect`; live is foreground monitor, `--sleep` is detached monitor.
- For `run`, `loop`, and `auto`, preserve trailing natural-language command text as temporary runtime guidance. During a live run, inject user corrections into the active run guidance inbox instead of only narrating advice.
- Host hooks and subagents may improve throughput but are never correctness requirements.
Files in this package (13)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • commands/argue.md 4 KB
  • commands/auto.md 6 KB
  • commands/dashboard.md 3 KB
  • commands/discuss.md 5 KB
  • commands/doctor.md 3 KB
  • commands/extension.md 4 KB
  • commands/init.md 6 KB
  • commands/loop.md 6 KB
  • commands/run.md 6 KB
  • commands/status.md 3 KB
  • commands/tui.md 3 KB

Versions

RepositoryScoreLicence
This page · seeleai/thoth90MIT
jarakube/thoth100MIT
NirvanaGuha/thoth95MIT
NirvanaGuha/thoth90MIT

Database snapshot: 13.11.2026 · package version 47c3592a9bf3 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96codex
    用户输入 /codex <任务> 时,通过 peer 调度 Codex 执行该任务并汇报结果。Codex 可读取并写入当前工作目录。

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.