litestar

litestar-skills

Opinionated, first-party agent skills, plugins, subagents, slash commands, and MCP servers for the Litestar framework and its ecosystem — publishable to every major AI agent and IDE from a single repo.

litestar-skills is a curated collection of agentic-development assets that teach AI coding agents how the Litestar team actually builds software. Dedicated package guidance covers Litestar, SQLSpec, Advanced Alchemy, msgspec, Polyfactory, pytest-databases, Litestar Autowire, Litestar Granian, Litestar SAQ, Litestar Queues, Litestar Vite, Litestar MCP, Litestar Email, and Litestar HTMX.

Status

v0.6.0 — early access. Multi-host plumbing, 30 skills, ~28,500 lines of canonical content. Full launch-skill catalog growing.

Breaking host identity note: host-facing marketplace, plugin, extension, managed-config, and skill namespace IDs are litestar. Existing installs under litestar-skills should be removed and reinstalled; no alias is shipped. The Python package and repository remain litestar-skills.

Host Artifacts

This repo documents hosts by the artifacts it ships:

Host	Entry Point
Claude Code	.claude-plugin/plugin.json + marketplace metadata + .claude-plugin/agents/*.md
Antigravity CLI	plugin.json + hooks.json + agents/*.md + skills/ + hooks/
Codex CLI	.codex-plugin/plugin.json + .codex/agents/*.toml
OpenCode	.opencode/plugins/litestar.js + .opencode/agents/*.md
Cursor	.cursor-plugin/plugin.json
VS Code / Copilot	Raw skills/ path via chat.skillsLocations
OpenClaw	.agents/skills/ + AGENTS.md

Harness Names And Commands

Different hosts expose the same repo assets with different command surfaces. Keep four names separate:

Concept	Canonical Value
Plugin / marketplace identity	litestar
Skill directory names	skills/<skill-name>/SKILL.md, e.g. skills/litestar-routing/SKILL.md
Hook and policy namespace	litestar:<skill-name>, e.g. litestar:litestar-routing
Command files	commands/litestar/{configure,new-app,new-domain,review}.toml

Harness	Skill Manual Trigger	Command Trigger	Reviewer Agent Trigger
Claude Code	/litestar:litestar for the hub skill; /litestar:litestar-routing for focused skills. Plugin policy uses Skill(litestar:<skill-name>).	/litestar:configure, /litestar:new-app, /litestar:new-domain, /litestar:review	Select litestar-reviewer from .claude-plugin/agents/ where Claude exposes plugin subagents.
Antigravity CLI	Skills load from the litestar plugin or .agents/skills/; use the displayed skill/template name in Antigravity. SessionStart hooks inject litestar:<skill-name> reminders when project signals are detected.	No TOML slash-command surface in the Antigravity plugin schema. Use prompts backed by the skills or reviewer agent.	litestar-reviewer from top-level agents/.
Codex CLI	Codex surfaces installed skills by displayed name. In $-trigger Codex surfaces, force the hub with $litestar:litestar and focused skills with $litestar:<skill-name>; natural language also works.	Codex plugins do not currently expose plugin-defined /litestar:* slash commands. Use natural language such as “Use Litestar review…” and the litestar skill router.	$agent litestar-reviewer from .codex/agents/.
OpenCode	opencode skill list shows project-local copied skills; use the displayed skill name in the OpenCode UI. Plugin reminders use litestar:<skill-name>.	No TOML command loader in the OpenCode plugin. Use natural-language prompts or project-local command support.	litestar-reviewer from .opencode/agents/.
Cursor	Skills are discovered from the plugin/rule path; use the displayed skill name in Cursor.	Host command support varies; shipped TOML commands remain under commands/litestar/.	No Cursor-specific reviewer dialect shipped.
VS Code / Copilot	Skills are discovered from chat.skillsLocations; use the displayed skill name in Copilot Chat.	No shipped command wrapper.	No VS Code-specific reviewer dialect shipped.
OpenClaw	Skills are discovered from .agents/skills/; use the displayed skill name.	No shipped command wrapper.	No OpenClaw-specific reviewer dialect shipped.

Canonical agent source lives in tools/agent-sources/litestar-reviewer.yaml; run make agents after editing it, then make sync-codex-package before make lint so the generated Codex package copy stays current.

Install

Pick your host and run the one command below. If you use several agents, skip to the multi-host installer.

Claude Code

/plugin marketplace add litestar-org/litestar-skills
/plugin install litestar@litestar

The /plugin commands run inside a Claude Code session — the installer can't automate this part.

Antigravity CLI