cosmo-agent-skills

Cosmo agent skills

Portable skills for Claude Code, Cursor, Ralph loops, and other agent workflows. This repository is also a Claude Code plugin — skills live under skills/; manifest under .claude-plugin/ (tracked in git).

Design: principles and checks, not copy-paste recipes. Every SKILL.md works standalone in any project — symlink, copy, or install via plugin. Project-specific commands, units, and science belong in that repo's CLAUDE.md.

Layout

cosmo-agent-skills/
├── hooks/                    # plugin Stop + PreToolUse hooks
├── commands/                 # /loop-on, /loop-off (plugin slash commands)
├── scripts/                  # loop toggle helpers
├── loop-prompt.md            # default continuation checklist
├── .claude-plugin/
│   ├── plugin.json           # plugin manifest
│   └── marketplace.json      # marketplace catalog
├── agents/                   # bundled subagents (code-reviewer, repo-organizer)
├── examples/                 # settings snippets
├── ref_papers/               # local PDFs only (gitignored)
└── skills/
    ├── hydrosim/             # simulation data (FLAMINGO: 6 skills)
    ├── plotting/             # figure export + validation (6 skills)
    ├── paper-reading/        # deep-read papers → critical notes (1 skill)
    ├── paper-writing/        # manuscript workflow (3 skills)
    └── coding/               # software engineering (4 skills)

Add new categories under skills/ with a category README.md.

Non-stop loop (plugin hooks)

Optional autonomous iteration: bundled in this plugin. A Stop hook re-sends the loop prompt whenever Claude tries to end a turn, until you run /loop-off.

1. Install the plugin (/plugin install cosmo-agent-skills@cosmo-agent-skills).
2. Open Claude Code in your project root.
3. /loop-on, then your first task. /loop-off when done.

Prompt source: plugin default loop-prompt.md, or override with .claude/loop-prompt.md in your project (created by /loop-on with arguments).

Requires bash, jq, and realpath on the host. Optional: merge examples/claude-settings.nonstop-loop.json if long prompts are truncated.

Safety: while /loop-on is active, Claude cannot exit until /loop-off. protect-write-scope limits Edit/Write to CLAUDE_PROJECT_DIR.

Claude Code plugin

Per Create plugins:

# Dev: load this repo as a plugin
claude --plugin-dir .

# Persistent: register marketplace + install
/plugin marketplace add /path/to/cosmo-agent-skills
/plugin install cosmo-agent-skills@cosmo-agent-skills

Skills invoke as /cosmo-agent-skills:<skill-name> (e.g. /cosmo-agent-skills:code-testing).

Validate: claude plugin validate .

Bump version in .claude-plugin/plugin.json and marketplace.json when releasing.

Sync skills into a project (flat layout)

For repos that vendor skills under .claude/skills/ (e.g. autoflamingo at /scratch/scratch-lxu/flamingo_data_analysis/autoflamingo):

/path/to/cosmo-agent-skills/scripts/sync-skills-to-project.sh /path/to/your/project

Re-run after pulling updates to this repository.

Install (pick one)

Cursor / Claude Code (standalone skills) — symlink or copy individual skills:

git clone https://github.com/licongxu/cosmo-agent-skills.git
cd cosmo-agent-skills

# Cursor: one skill → ~/.cursor/skills/
for d in skills/plotting/*/ skills/paper-writing/*/ skills/coding/*/; do
  ln -sf "$(pwd)/$d" ~/.cursor/skills/"$(basename "$d")"
done

Skills trigger by name/description in any repo. No dependency on this repository's layout.

Claude Code plugin — see Claude Code plugin above for /plugin install and namespaced skills (/cosmo-agent-skills:code-testing).

Categories

skills/hydrosim/flamingo/

FLAMINGO data release — run inventory and data products. Facts verified against the portal and Schaye et al. (2023) / Helly et al. (2026) release paper.

Skill	Use when
flamingo-simulations	Choosing a run, paths, naming, variations
flamingo-power-spectra	ASCII P(k), emulator, units
flamingo-snapshots	Particle HDF5, partial snapshots
flamingo-halo-catalogues	SOAP / HBT-HERONS catalogues
flamingo-lightcones	HEALPix maps, particle and halo lightcones
flamingo-hdfstream	Remote streaming access to FLAMINGO HDF5 on COSMA (default)