🔭 Lightcone Research — Agent Skills

Portable, open-standard skills that teach coding agents the Lightcone Research stack.

---

Agent skills for the Lightcone Research stack, packaged as plugins to work across Claude Code, Codex, and other compatible agents.

📦 Prerequisites

Some plugins have Python dependencies that install themselves on first use. The only prerequisite is uv: https://docs.astral.sh/uv/getting-started/installation/.

🛒 Add the marketplace

One-time setup: register this repository as a plugin marketplace in your harness. It registers under the name lightcone-research, which is the @lightcone-research suffix in the install commands below.

Claude Code

claude plugin marketplace add LightconeResearch/agent-skills

Claude App

Open Customize → Plugins → Add → Add marketplace → Add from repo and paste https://github.com/LightconeResearch/agent-skills.

Codex CLI

codex plugin marketplace add LightconeResearch/agent-skills

Codex App

Open Plugins from the arrow beside Create and add the LightconeResearch/agent-skills marketplace.

🧩 Plugins

Plugin	Skills	Adds
astra	astra	authoring guidance for ASTRA analysis specs (astra.yaml); validate-on-save & session-start hooks
lightcone	lightcone, astra	end-to-end guidance for working on a Lightcone project with the lc CLI — scoping, implementation, materialization, publishing. Bundles the astra plugin (skill + hooks), so installing lightcone alone gets the full stack — don't install astra alongside it

🚀 Install a plugin

Plugin skills are namespaced by plugin name: once a plugin is installed, invoke its skills as /<plugin>:<skill> in Claude or $<plugin>:<skill> in Codex. The examples below install astra; substitute any plugin from the table above.

Claude Code

claude plugin install astra@lightcone-research

Then invoke /astra:astra in a session.

Claude App

In Customize → Plugins, choose astra from the lightcone-research marketplace, then invoke /astra:astra.

Codex CLI

codex plugin add astra@lightcone-research

Then invoke the skill in Codex, for example $astra:astra.

Codex App

Open Plugins from the arrow beside Create, then search for and install astra. Invoke /astra:astra.

✨ Skills

Skill	What it does
astra	Teaches the agent to author and revise an astra.yaml: the judgment a schema can't carry — what deserves to be a decision, when to split a sub-analysis, how to back claims with verifiable evidence.
lightcone	Teaches the agent to work on a Lightcone project at any phase: interview the user to scope a new analysis, orient and summarize when resuming one, and drive the lc workflow — integrate recipes, materialize outputs, interpret status, diagnose failures, publish.

📄 License

BSD 3-Clause — see LICENSE. Copyright (c) 2026, Centre National de la Recherche Scientifique (CNRS) and The Regents of the University of California.

_{Built with ❤️ by Lightcone Research · Skills follow the open Agent Skills standard}