astra

Author and debug astra.yaml specifications for ASTRA research analyses.

18|2|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/LightconeResearch/lightcone-cli --skill astra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: astra
Source: https://github.com/LightconeResearch/lightcone-cli/tree/main/claude/lightcone/skills/astra
Command: npx skills add https://github.com/LightconeResearch/lightcone-cli --skill astra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you eliminate ambiguity and structural mistakes when authoring or troubleshooting an astra.yaml specification for an ASTRA analysis.

Core Features & Use Cases

  • Schema clarity for structured research: Defines the complete astra.yaml structure, including inputs, outputs, decisions, prior_insights, findings, evidence, and narrative anchors.
  • Decision and option mechanics: Explains how to model methodological choices as parameterized decisions with constrained options.
  • Provenance- and evidence-driven validation: Covers evidence linking rules (DOI quote requirements, artifact references) and validation workflows so your spec is execution-ready.
  • Sub-analysis composition and universes: Documents inline/external sub-analyses, from-path wiring, and universe selection for loading option sets.

Quick Start

Ask an AI assistant to review your astra.yaml against the ASTRA reference and point out what is mis-specified, missing, or invalid.

Frequently Asked Questions about astra

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate an astra.yaml research analysis specification?

To validate an astra.yaml specification, ask an AI assistant to review your file against the ASTRA reference to identify mis-specified fields, missing structures, or invalid configurations. This ensures your spec is execution-ready by verifying inputs, outputs, decisions, and evidence links.

What is a parameterized decision in ASTRA decision modeling?

A parameterized decision in ASTRA decision modeling is a methodological choice defined within astra.yaml that uses constrained options to represent different analytical paths. This mechanism allows you to structure research decisions systematically and link them to specific sub-analyses.

How do I add DOI quote evidence to my research workflow spec?

To add DOI quote evidence to your research workflow spec, use the evidence linking rules in astra.yaml to associate artifact references and DOI quotes with your findings. This provenance-driven validation ensures your research outputs are traceable and execution-ready.

Can I compose nested sub-analyses and universes in astra.yaml?

Yes, you can compose nested sub-analyses and universes in astra.yaml by using inline or external sub-analysis definitions with from-path wiring. This allows you to load specific option sets and structure complex analytical hierarchies within your ASTRA research analyses.

Why is my astra.yaml spec failing validation checks?

Your astra.yaml spec may be failing validation due to missing required fields like inputs, outputs, decisions, or evidence, or due to incorrect YAML frontmatter. Debug by checking the structural clarity of your narrative anchors and ensuring all DOI quote requirements are met.