Agent skill

Catgo Campaign

by Hello-QM in Hello-QM/catgo-LRG

Run a CatGo file-first md-orchestration "campaign" — a multi-step / high-throughput computational-materials study (e.g.

AGPL-3.0Auto-check passedData & Analytics

Install Catgo Campaign

skills CLI
$ npx skills add Hello-QM/catgo-LRG --skill catgo-campaign -a claude-code

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

GitHub CLI
$ gh skill install Hello-QM/catgo-LRG catgo-campaign --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/Hello-QM/catgo-LRG.git skills-src && mkdir -p .claude/skills && cp -r skills-src/server/catgo/workflow/skills/catgo-campaign .claude/skills/catgo-campaign && 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
catgo-campaign
GitHub stars
205
Token cost
~1k tokens
SKILL.md length
503 words
Files
1
Skills in repo
75
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Run a CatGo file-first md-orchestration "campaign" — a multi-step / high-throughput computational-materials study (e.g.

  • Works in 9 steps: Scaffold at the user's chosen location → Plan — ASK the user: brainstorm the plan… → Reference script (optional): catgo… → …
  • The user says 跑一个 campaign
  • SKILL.md covers Launcher (works from any…, Before anything: confirm the…, Steps and Notes
  • Calls pip

What it does

Catgo Campaign is an agent skill from Hello-QM/catgo-LRG. Run a CatGo file-first md-orchestration "campaign" — a multi-step / high-throughput computational-materials study (e.g. SAA HER screening) driven from a human-readable folder + markdown tree, not the DB workflow engine. Use when the user says "跑一个 campaign", "md 模式跑", "high-throughput screening", or wants an agent-in-the-loop study with stages/funnel/analysis/report. Requires catgo on PATH.

Its SKILL.md is about 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 Data & Analytics, covering Product analytics. The repository describes itself as: AI-driven workbench for computational materials science — interactive 3D structure viewer, natural-language CatBot assistant, visual DAG workflow engine, HPC job submission… The licence is AGPL-3.0.

When your agent uses it

  • The user says 跑一个 campaign
  • High-throughput screening
  • Wants an agent-in-the-loop study with stages/funnel/analysis/report

Example prompts

  • “campaign”
  • “跑一个 campaign”
  • “md 模式跑”
  • “/catgo-campaign”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Scaffold at the user's chosen location
  2. Plan — ASK the user: brainstorm the plan together (literature-grounded, one
  3. Reference script (optional): catgo campaign fetch-ref --project --ssh --remote_path <.sb>
  4. Per calc: build inputs into the LOCAL calc folder, then the input-file gate (below),
  5. Loop (~10 min, user-triggered): catgo campaign poll --project --ssh
  6. At a stage / decision point: catgo campaign aggregate --project --plot
  7. Report: catgo campaign report --project --occasion groupmeeting
  8. Literature: catgo campaign ingest --project --pdf (MinerU) or
  9. Archive (clean the tree, never auto-decide): catgo campaign archive --project --list

What it can do on your machine

Read from SKILL.md and the folder at commit fd6291b. 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

    Shell commands in SKILL.md call:

    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    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

Catgo Campaign loads about 1k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 503 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~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 Hello-QM/catgo-LRG at commit fd6291b, republished under its AGPL-3.0 licence (© Hello-QM). 503 words, ~1,042 tokens.

Download SKILL.mdSave it as .claude/skills/catgo-campaign/SKILL.md (or your agent's skills folder).
name
catgo-campaign
description
Run a CatGo file-first md-orchestration "campaign" — a multi-step / high-throughput computational-materials study (e.g. SAA HER screening) driven from a human-readable folder + markdown tree, not the DB workflow engine. Use when the user says "跑一个 campaign", "md 模式跑", "high-throughput screening", or wants an agent-in-the-loop study with stages/funnel/analysis/report. Requires `catgo` on PATH.

catgo-campaign — run a file-first computational campaign

A "campaign" = a coordinated multi-step study (many calculations → analysis → report) toward one research goal. This skill drives it via the portable catgo campaign CLI, which dispatches to CatGo's campaign reference scripts.

Launcher (works from any directory)

Run via the catgo CLI:

catgo campaign <action> ...

With an editable install (pip install -e <repo>/server) the CLI reflects the LIVE repo source, so edits to the campaign scripts/SKILL take effect immediately, no reinstall. If catgo is not on PATH (env not activated), use the entry point inside its python env directly: <env-prefix>/bin/catgo campaign .... In the steps below, catgo campaign means that launcher.

Before anything: confirm the environment (NEVER guess)

Ask the user and record in cluster.md: which cluster + SSH host/account + partition/walltime/ntasks, the compute binary + load method (module/conda/full path + run command), the POTCAR/pseudopotential root, the python env, and the remote base dir. The user may give a reference job script (local or a path on the cluster — pull it with catgo campaign fetch-ref). catgo campaign submit REFUSES until cluster.md is complete. A wrong path fails every job — if unsure, STOP and ask.

Steps

  1. Scaffold at the user's chosen location: catgo campaign new /path/to/Project --name "<name>" --template saa_her|blank

  2. Plan — ASK the user: brainstorm the plan together (literature-grounded, one question at a time, propose approaches) OR use the template / generate directly.

  3. Reference script (optional): catgo campaign fetch-ref --project <dir> --ssh <alias> --remote_path <.sb>

  4. Per calc: build inputs into the LOCAL calc folder, then the input-file gate (below), then catgo campaign submit --project <dir> --calc calc/<stage>/<candidate> --ssh <alias> (skip the gate only on explicit YOLO opt-in).

    ⛔ INPUT-FILE GATE (hard rule — catgo-campaign + autochem). Before ANY submit (and after a calc converges, before building the NEXT step's inputs): sync the CONTCAR and the INCAR to the LOCAL campaign folder, and tell the user the exact LOCAL file paths of the INCAR + CONTCAR. The user reviews / edits / confirms the files THEMSELVES on disk. Submit ONLY after the user explicitly confirms. Do NOT push structures to the CatGO viewer as a substitute for local-file review of inputs, and NEVER auto-submit. (Waived only by explicit YOLO.)

  5. Loop (~10 min, user-triggered): catgo campaign poll --project <dir> --ssh <alias> marks DONE/FAILED via squeue→sacct. A scheduler DONE != converged — open the work_dir outputs to confirm, write numbers into the calc's result.md, log gotchas in LESSONS.md.

  6. At a stage / decision point: catgo campaign aggregate --project <dir> --plot (ranking / volcano / funnel), then checkpoint with the user.

  7. Report: catgo campaign report --project <dir> --occasion groupmeeting

  8. Literature: catgo campaign ingest --project <dir> --pdf <p.pdf> (MinerU) or --repo <url> --purpose "…".

  9. Archive (clean the tree, never auto-decide): catgo campaign archive --project <dir> --list proposes FAILED calcs (funnel rejects are kept as data); move one only on the user's explicit OK: catgo campaign archive --project <dir> --calc calc/<stage>/<name> --reason "…".

Show full SKILL.md (32 more words)Show less

Notes

  • Default to a review gate (user-in-the-loop); only auto-advance on explicit opt-in.
  • Full conventions live in the in-repo skill server/catgo/workflow/skills/campaign/SKILL.md (read it for the folder layout, progressive-md rules, two-level plan, gate details).

© Hello-QM, AGPL-3.0. 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 server/catgo/workflow/skills/catgo-campaign of Hello-QM/catgo-LRG.

Open the folder on GitHubat commit fd6291b

Compare with similar skills

Catgo Campaign 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.

Catgo Campaign compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Catgo Campaign this skillHello-QM/catgo-LRG205—~1kAutomated safety check: PassAGPL-3.0
PostHog CLI Queriesdebugtheworldbot/keyStats1.5k—~1.2kAutomated safety check: PassMIT
Retentioneering Contributingretentioneering/retentioneering-tools927—~1.8kAutomated safety check: PassApache-2.0
Retentioneering Product Analyticsretentioneering/retentioneering-tools927—~1.6kAutomated safety check: PassApache-2.0
Feature Analytics Instrumentation Plannermistralai/mistral-vibe5.1k—~2.2kAutomated safety check: PassApache-2.0
Funnel Analysisliangdabiao/claude-data-analysis-ultra-main2901 repos~781Automated safety check: NotesNone

Similar skills

  • PostHog CLI Queries

    debugtheworldbot/keyStats

    Runs HogQL queries against this project's PostHog data from the terminal using posthog-cli, with bundled scripts for dashboard metadata the CLI itself has no command for.

    1.5k GitHub stars~1.2k tokensUpdated 7 days ago
    Data & AnalyticsAuto-check passed
  • Retentioneering Contributing

    retentioneering/retentioneering-tools

    Help the user turn their Retentioneering ideas, friction reports, bug findings, or feature needs into high-quality upstream contributions: from capturing and validating the idea, through minimal…

    927 GitHub stars~1.8k tokensUpdated 3 days ago
    Data & AnalyticsAuto-check passed
  • Retentioneering Product Analytics

    retentioneering/retentioneering-tools

    Analyze event logs, clickstreams, user paths, product funnels, retention, behavioral segments, transition graphs, step matrices, sequence patterns, and customer journeys using Retentioneering.

    927 GitHub stars~1.6k tokensUpdated 3 days ago
    Data & AnalyticsAuto-check passed
  • Official

    Plans which analytics events and properties a new feature needs, checks them against the existing event registry, and verifies them per environment.

    5.1k GitHub stars~2.2k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Funnel Analysis

    liangdabiao/claude-data-analysis-ultra-main

    Analyze user conversion funnels, calculate step-by-step conversion rates, create interactive visualizations, and identify optimization opportunities.

    290 GitHub starsUsed in 1 repo~781 tokens
    Data & AnalyticsAuto-check: notes
  • Event Tracking

    linuxfoundation/insights

    Add event tracking calls to Vue/Nuxt components in the Insights app using the useTrackEvent composable.

    282 GitHub stars~1.9k tokensUpdated 9 days ago
    Data & AnalyticsAuto-check passed

More from Hello-QM/catgo-LRG

All 75 skills in this repo
  • Campaign Md Orchestration

    Hello-QM/catgo-LRG

    Drive a file-first, agent-in-the-loop computational campaign via a folder + markdown tree (no DB).

    205 GitHub stars~1.6k tokensUpdated 18 days ago
    Auto-check passed
  • Catgo Gibbs Pipeline

    Hello-QM/catgo-LRG

    Compute adsorption/reaction Gibbs free energies, free-energy diagrams, and electrochemical overpotentials (HER/ORR/OER/CO2RR/NRR) with VASP.

    205 GitHub stars~669 tokensUpdated 18 days ago
    Auto-check passed
  • Abinit

    Hello-QM/catgo-LRG

    Generate and manage ABINIT DFT calculations. An agent skill from Hello-QM/catgo-LRG.

    205 GitHub stars~963 tokensUpdated 18 days ago
    Auto-check passed
  • Adsorbate Placement

    Hello-QM/catgo-LRG

    A skill your agent uses when the user asks to place an adsorbate molecule on a surface, find adsorption sites, or set up a surface+adsorbate model for DFT.

    205 GitHub stars~3k tokensUpdated 18 days ago
    Auto-check passed
  • Adsorption Energy

    Hello-QM/catgo-LRG

    A skill your agent uses when the user asks for adsorption energy, binding energy, or wants to compare how strongly a molecule binds to a surface.

    205 GitHub stars~1.4k tokensUpdated 18 days ago
    Auto-check passed
  • Analysis Router

    Hello-QM/catgo-LRG

    A skill your agent uses when the user asks to analyze computational results: Gibbs free energy, OER/HER/CO2RR overpotentials, adsorption energy, convergence tests, DOS/d-band analysis, or Bader…

    205 GitHub stars~869 tokensUpdated 18 days ago
    Auto-check passed

Questions about Catgo Campaign

What does Catgo Campaign do?

Run a CatGo file-first md-orchestration "campaign" — a multi-step / high-throughput computational-materials study (e.g. Catgo Campaign is an agent skill from Hello-QM/catgo-LRG.g.

When should I use Catgo Campaign?

Catgo Campaign fits situations like: the user says 跑一个 campaign; high-throughput screening; wants an agent-in-the-loop study with stages/funnel/analysis/report.

How do I install Catgo Campaign in Claude Code?

Run `npx skills add Hello-QM/catgo-LRG --skill catgo-campaign -a claude-code`. Or copy the skill folder (server/catgo/workflow/skills/catgo-campaign in Hello-QM/catgo-LRG) into .claude/skills/catgo-campaign in your project. Claude Code loads it when a task matches its description.

How do I install Catgo Campaign in Codex?

Run `npx skills add Hello-QM/catgo-LRG --skill catgo-campaign -a codex`. Or copy the skill folder (server/catgo/workflow/skills/catgo-campaign in Hello-QM/catgo-LRG) into .agents/skills/catgo-campaign in your project. Codex loads it when a task matches its description.

Can I use Catgo Campaign 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 Hello-QM/catgo-LRG --skill catgo-campaign -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/catgo-campaign, .gemini/skills/catgo-campaign, .github/skills/catgo-campaign and .opencode/skills/catgo-campaign in your project.

What does Catgo Campaign need to run?

Going by SKILL.md and its folder, Catgo Campaign needs the command-line tools its instructions call (pip). Our summary lists: Python 3.

Does Catgo Campaign access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Catgo Campaign 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 Catgo Campaign use?

Catgo Campaign is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Catgo Campaign use?

About 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 Catgo Campaign?

Skills that share tags, products or a category with Catgo Campaign: PostHog CLI Queries (debugtheworldbot/keyStats, 1.5k stars), Retentioneering Contributing (retentioneering/retentioneering-tools, 927 stars), Retentioneering Product Analytics (retentioneering/retentioneering-tools, 927 stars) and Feature Analytics Instrumentation Planner (mistralai/mistral-vibe, 5.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Catgo Campaign?

Hello-QM (a GitHub user) maintains it in Hello-QM/catgo-LRG, which has 205 GitHub stars. The repository holds 75 skills in this directory. The repository was last updated on September 22, 2026.

Source: Hello-QM/catgo-LRG on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.