Hello-QM/catgo-LRG / server/catgo/workflow/skills/campaign
campaign-md-orchestration
VerifiedDrive a file-first, agent-in-the-loop computational campaign via a folder + markdown tree (no DB). Use when the user opts out of the visual workflow engine.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| references/catgo-cli.md | markdown | 1.8 KB |
| scripts/INDEX.md | markdown | 1.8 KB |
| scripts/aggregate.py | script | 1011 B |
| scripts/archive.py | script | 1.8 KB |
| scripts/campaign_analysis.py | script | 4.3 KB |
| scripts/campaign_lib.py | script | 24.5 KB |
| scripts/campaign_lit.py | script | 3.3 KB |
| scripts/campaign_report.py | script | 1.6 KB |
| scripts/fetch_ref.py | script | 943 B |
| scripts/ingest_lit.py | script | 1.3 KB |
| scripts/make_report.py | script | 880 B |
| scripts/new_campaign.py | script | 932 B |
| scripts/poll.py | script | 798 B |
| scripts/submit_calc.py | script | 1.6 KB |
| scripts/test_campaign_analysis.py | script | 3.7 KB |
| scripts/test_campaign_lib.py | script | 21.8 KB |
| scripts/test_campaign_lit.py | script | 2.0 KB |
| scripts/test_campaign_report.py | script | 1.4 KB |
| scripts/test_entrypoints.py | script | 2.7 KB |
| scripts/test_skill_structure.py | script | 1.8 KB |
| scripts/test_vasp_sanity.py | script | 9.6 KB |
| scripts/vasp_sanity.py | script | 12.5 KB |
| templates/saa_her/plan.md | markdown | 1009 B |
references/catgo-cli.md
View on GitHub# catgo CLI — use during a campaign
> **TL;DR:** During an md-orchestration campaign, use the existing `catgo` CLI to
> build structures and analyze results. `catgo <op>` runs offline (no viewer
> needed for build/convert/analyze). Render inputs into the calc folder, then
> `submit_calc.py`; after a job finishes, analyze its outputs into `result.md`.
## Build / prepare structure (writes into the calc folder)
- `catgo slab --miller 1,1,1 --layers 4 --vacuum 15` — bulk -> surface slab.
- `catgo supercell --scaling 2,2,1` — integer supercell.
- `catgo reticular --preset mof-5` — MOF/COF from topology + building blocks.
- `catgo convert --out POSCAR` — write the active structure to another format
(extension picks the format).
- `catgo inspect` — composition / symmetry / nearest-neighbor sanity check.
## Analyze results (after a job finishes; feed values into result.md)
- `catgo dos --atoms all --channels spd` — `vaspout.h5` -> PDOS plot + d-band center.
- `catgo band` — `vasprun.xml` -> band structure + gap.
- `catgo cohp` — `COHPCAR.lobster` -> -pCOHP + ICOHP.
- `catgo freq --mode adsorbed --T 298.15` — `OUTCAR` -> Gibbs correction
(ZPE + TS) + imaginary-mode animation. This gives the gibbs/ΔG terms you write
into `result.md` for the volcano.
## How it fits the loop
1. Build/prepare -> rendered `INCAR`/`POSCAR`/`KPOINTS` land in the calc folder.
2. Input-file gate (show the user) -> `submit_calc.py`.
3. Job done (`poll.py` marks DONE) -> pull outputs / run `catgo freq` etc. ->
write the numbers into the calc's `result.md`.
4. `aggregate.py` rolls every `result.md` into `analysis/` (ranking / volcano /
funnel); `make_report.py` drafts the report.
Run these from the calc folder (or pass paths). They are offline and do not need
the `:8000` viewer for build/convert/analyze.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |