Agent skill

Agent Lightning

by VectorSpaceLab in VectorSpaceLab/AREX-Skill

Use this repo skill for Agent Lightning package tasks: authoring trainable agents, tracing rewards and spans, running LightningStore/Trainer loops, using agl CLI services, choosing examples, and…

MITAuto-check passed

Install Agent Lightning

skills CLI
$ npx skills add VectorSpaceLab/AREX-Skill --skill agent-lightning -a claude-code

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

GitHub CLI
$ gh skill install VectorSpaceLab/AREX-Skill agent-lightning --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/VectorSpaceLab/AREX-Skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/repositories/repo-skills/agent-lightning .claude/skills/agent-lightning && 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
agent-lightning
GitHub stars
328
Token cost
~1.4k tokens
SKILL.md length
508 words
Files
7 (incl. scripts, references)
Skills in repo
157
Repo updated
First seen
Licence
MIT

At a glance

Use this repo skill for Agent Lightning package tasks: authoring trainable agents, tracing rewards and spans, running LightningStore/Trainer loops, using agl CLI services, choosing examples, and…

  • Works in 4 steps: Identify the user's workflow and route… → If the user is using a different… → For install or import trouble, run or… → …
  • SKILL.md covers First steps for any task, Route map, Installation orientation and Core public objects to recognize, plus 2 more sections
  • Runs Python scripts from its folder; calls python

What it does

Agent Lightning is an agent skill from VectorSpaceLab/AREX-Skill. Use this repo skill for Agent Lightning package tasks: authoring trainable agents, tracing rewards and spans, running LightningStore/Trainer loops, using agl CLI services, choosing examples, and troubleshooting optional backends.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/compatibility.md`, `references/repo-provenance.md` and `references/repo-routing-metadata.json`).

The repository describes itself as: A Skill Library for Automated Machine Learning. The licence is MIT.

Example prompts

  • “/agent-lightning”

Requirements

  • Python 3
  • Docker

Workflow steps

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

  1. Identify the user's workflow and route to the nearest sub-skill below.
  2. If the user is using a different checkout or package version, read repo provenance before relying on version-sensitive details.
  3. For install or import trouble, run or adapt scripts/check_agentlightning_install.py and read compatibility plus cross-cutting…
  4. Treat GPU, MongoDB, cloud API, W&B/Tinker, Docker/SWE-bench, and dashboard workflows as optional unless the user explicitly provides those…

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

    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

Agent Lightning loads about 1.4k tokens when it runs, and up to ~4k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 508 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from VectorSpaceLab/AREX-Skill at commit ac3fe1a, republished under its MIT licence (© VectorSpaceLab). 508 words, ~1,414 tokens.

Download SKILL.mdSave it as .claude/skills/agent-lightning/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
agent-lightning
description
Use this repo skill for Agent Lightning package tasks: authoring trainable agents, tracing rewards and spans, running LightningStore/Trainer loops, using agl CLI services, choosing examples, and troubleshooting optional backends.
disable-model-invocation
true
metadata.disco-role
operating
license
MIT

Agent Lightning Repo Skill

Use this skill when a user asks for help with Agent Lightning (agentlightning): writing trainable agents, collecting spans and rewards, coordinating runners/stores/trainers/algorithms, using agl services, selecting example recipes, or diagnosing package/backend issues.

Agent Lightning's core loop is: a runner executes a LitAgent, a tracer emits spans into a LightningStore, algorithms read those traces and update resources, and Trainer wires those components together.

First steps for any task

  1. Identify the user's workflow and route to the nearest sub-skill below.
  2. If the user is using a different checkout or package version, read repo provenance before relying on version-sensitive details.
  3. For install or import trouble, run or adapt scripts/check_agentlightning_install.py and read compatibility plus cross-cutting troubleshooting.
  4. Treat GPU, MongoDB, cloud API, W&B/Tinker, Docker/SWE-bench, and dashboard workflows as optional unless the user explicitly provides those resources.

Route map

User intentUse this sub-skillWhat it contains
Write or wrap an agent, fix @rollout signatures, use PromptTemplate or LLM, debug one rolloutagent-authoringAgent function/class patterns, resource injection, return contracts, runner single-step smoke
Emit rewards/messages/objects, inspect spans, adapt traces to messages/triplets, debug missing token IDstracing-and-instrumentationOtelTracer, AgentOpsTracer, emitters, operation, adapters, trace troubleshooting
Operate LightningStore, runners, algorithms, Trainer.fit, Trainer.dev, status/retry behaviorrunner-store-trainingStore API, rollout/attempt lifecycle, resources, custom algorithms, training loop recipes
Use agl CLI, store/prometheus services, LLM proxy, vLLM bridge, endpoint checks, metricscli-and-servicesHelp-confirmed CLI flags, service launch patterns, safe LiteLLM/OpenAI-compatible checks
Choose or adapt examples such as APO, SQL, RAG, ChartQA, Unsloth, Azure, Claude Code, Tinkerexamples-and-recipesExample/backend catalog, optional dependency matrix, maintainer example rules

Installation orientation

General use:

bash
python -m pip install --upgrade agentlightning
python - <<'PY'
import agentlightning as agl
print(agl.__version__)
print(type(agl.InMemoryLightningStore()).__name__)
PY

For source development, use the repository's uv workflow and choose only the optional groups needed for the task. CPU-only work can inspect and run base package APIs without CUDA. APO requires the apo extra (poml) plus an OpenAI-compatible endpoint for full examples. VERL/vLLM/Unsloth/vision/RAG examples require larger dependency groups and usually CUDA-compatible hardware.

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

Core public objects to recognize

  • Agent authoring: rollout, llm_rollout, prompt_rollout, LitAgent, PromptTemplate, LLM, ProxyLLM, NamedResources.
  • Execution: LitAgentRunner, Runner, Hook, Trainer, Algorithm, FastAlgorithm, Baseline, algo.
  • Store/control plane: LightningStore, InMemoryLightningStore, LightningStoreClient, LightningStoreServer, LightningStoreThreaded, RolloutConfig.
  • Tracing: OtelTracer, AgentOpsTracer, DummyTracer, emit_reward, emit_message, emit_object, emit_exception, operation, find_final_reward, TracerTraceToTriplet, LlmProxyTraceToTriplet, TraceToMessages.
  • Services: agl, LLMProxy, ProxyLLM, metrics backends, OpenAI-compatible endpoint patterns.

Fast validation

Use this when a user asks whether the installed package is basically usable:

bash
python scripts/check_agentlightning_install.py

For deeper workflow checks, run the nearest sub-skill smoke script:

  • Agent authoring: python sub-skills/agent-authoring/scripts/agent_rollout_smoke.py
  • Tracing: python sub-skills/tracing-and-instrumentation/scripts/local_trace_smoke.py
  • Store/training control plane: python sub-skills/runner-store-training/scripts/store_status_smoke.py
  • Services: python sub-skills/cli-and-services/scripts/check_litellm_proxy.py --help or python sub-skills/cli-and-services/scripts/check_prometheus_metrics.py --duration 1 --host 127.0.0.1

Run scripts from the generated skill directory or pass explicit paths/URLs where the script supports them. The scripts are safe by default: they do not train models, download data, mutate Docker/Mongo/Ray, or print secrets.

Known limits

This skill was verified for CPU-compatible package import, CLI help, and in-memory store/runner/tracing smokes. It preserves guidance for optional GPU/cloud/service workflows but does not claim those backends were available or verified. When a user requests optional workflows, first confirm or detect the required hardware, credentials, endpoints, datasets, and dependency groups before running expensive commands.

© VectorSpaceLab, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in skills/repositories/repo-skills/agent-lightning of VectorSpaceLab/AREX-Skill.

  • SKILL.md
  • references/compatibility.md
  • references/repo-provenance.md
  • references/repo-routing-metadata.json
  • references/troubleshooting.md
  • scripts/check_agentlightning_install.py
  • sub-skills

Open the folder on GitHubat commit ac3fe1a

Compare with similar skills

Agent Lightning 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.

Agent Lightning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Lightning this skillVectorSpaceLab/AREX-Skill328—~1.4kAutomated safety check: PassMIT
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT
Configuring Oauth2 Authorization Flowmukul975/Anthropic-Cybersecurity-Skills34k—~1.7kAutomated safety check: PassApache-2.0
Authoring Skillsvercel/next.js143k—~1kAutomated safety check: PassMIT
Abp Authorizationabpframework/abp14k—~1.3kAutomated safety check: PassLGPL-3.0
Implementing GCP Binary Authorizationmukul975/Anthropic-Cybersecurity-Skills34k—~2kAutomated safety check: PassApache-2.0

Similar skills

  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Configuring Oauth2 Authorization Flow

    mukul975/Anthropic-Cybersecurity-Skills

    Configures secure OAuth 2.0 authorization flows, including Authorization Code with PKCE, Client Credentials, and Device Authorization Grant, covering flow selection, PKCE implementation, token…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Authoring Skills

    vercel/next.js

    Official

    How to create and maintain agent skills in .agents/skills/. An agent skill from vercel/next.js.

    143k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Abp Authorization

    abpframework/abp

    ABP permission system - PermissionDefinitionProvider, [Authorize] attribute, CheckPolicyAsync, IsGrantedAsync, ICurrentUser, IPermissionManager, multi-tenancy side.

    14k GitHub stars~1.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Implementing GCP Binary Authorization

    mukul975/Anthropic-Cybersecurity-Skills

    Implements GCP Binary Authorization end to end, including creating KMS-backed attestors, Container Analysis notes, deploy-time policies, and signing image attestations, so that only trusted…

    34k GitHub stars~2k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Collectors Authoring

    netdata/netdata

    Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins.

    81k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed

More from VectorSpaceLab/AREX-Skill

All 157 skills in this repo
  • Agent Tools

    VectorSpaceLab/AREX-Skill

    A skill your agent uses when configuring LiteLLM for MCP tools, A2A agents, Claude Code/Cursor agent gateway traffic, MCP auth/OAuth, tool permissions, semantic filtering, or agent-specific proxy…

    328 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Agents And Awel

    VectorSpaceLab/AREX-Skill

    Build and debug DB-GPT agents, tools, skills, teams, and AWEL workflows, including deterministic local DAG runs and HTTP-trigger topology without assuming an LLM, credential, or external service.

    328 GitHub stars~2.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Agents And Middleware

    VectorSpaceLab/AREX-Skill

    Work on the actively maintained LangChain v1 agent package: initchatmodel, createagent, structured output, tools, middleware, embeddings initialization, provider routing, and agent runtime…

    328 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Agents Workflows

    VectorSpaceLab/AREX-Skill

    A skill your agent uses for giskard.agents async chat workflows, tools, prompt templates, structured outputs, retries, rate limiting, embeddings, and optional LiteLLM backend.

    328 GitHub stars~500 tokensUpdated 1 mo ago
    Auto-check passed
  • Alphafold3

    VectorSpaceLab/AREX-Skill

    A skill your agent uses for AlphaFold 3 input preparation, prediction command planning, output interpretation, and Python API inspection.

    328 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • App Callback Workflows

    VectorSpaceLab/AREX-Skill

    A skill your agent uses for Plotly Dash app layouts, callbacks, pages, assets, configuration, clientside callbacks, Jupyter display, CSP, and app-level debugging.

    328 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Agent Lightning

What does Agent Lightning do?

Use this repo skill for Agent Lightning package tasks: authoring trainable agents, tracing rewards and spans, running LightningStore/Trainer loops, using agl CLI services, choosing examples, and…. Agent Lightning is an agent skill from VectorSpaceLab/AREX-Skill. Use this repo skill for Agent Lightning package tasks: authoring trainable agents, tracing rewards and spans, running LightningStore/Trainer loops, using agl CLI services, choosing examples, and troubleshooting optional backends.

How do I install Agent Lightning in Claude Code?

Run `npx skills add VectorSpaceLab/AREX-Skill --skill agent-lightning -a claude-code`. Or copy the skill folder (skills/repositories/repo-skills/agent-lightning in VectorSpaceLab/AREX-Skill) into .claude/skills/agent-lightning in your project. Claude Code loads it when a task matches its description.

How do I install Agent Lightning in Codex?

Run `npx skills add VectorSpaceLab/AREX-Skill --skill agent-lightning -a codex`. Or copy the skill folder (skills/repositories/repo-skills/agent-lightning in VectorSpaceLab/AREX-Skill) into .agents/skills/agent-lightning in your project. Codex loads it when a task matches its description.

Can I use Agent Lightning 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 VectorSpaceLab/AREX-Skill --skill agent-lightning -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-lightning, .gemini/skills/agent-lightning, .github/skills/agent-lightning and .opencode/skills/agent-lightning in your project.

What does Agent Lightning need to run?

Going by SKILL.md and its folder, Agent Lightning needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3; Docker.

Does Agent Lightning access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agent Lightning 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Agent Lightning use?

Agent Lightning is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Lightning use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.6k tokens, read only when the agent opens those files.

What are the alternatives to Agent Lightning?

Skills that share tags, products or a category with Agent Lightning: Hermes Agent Skill Authoring (NousResearch/hermes-agent, 252k stars), Configuring Oauth2 Authorization Flow (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Authoring Skills (vercel/next.js, 143k stars) and Abp Authorization (abpframework/abp, 14k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Lightning?

VectorSpaceLab (a GitHub organization) maintains it in VectorSpaceLab/AREX-Skill, which has 328 GitHub stars. The repository holds 157 skills in this directory. The repository was last updated on September 3, 2026.

Source: VectorSpaceLab/AREX-Skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.