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. It covers the Litestar core plus first-party libraries (sqlspec, advanced-alchemy, litestar-granian, litestar-saq, litestar-vite, litestar-mcp, litestar-email, litestar-htmx, litestar-asyncpg, litestar-oracledb, and more).
Status
v0.4.0 — early access. Multi-host plumbing, 28 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
'%20stop-opacity%3D'0.16'%2F%3E%3Cstop%20offset%3D'1'%20stop-color%3D'rgb(200%2C90%2C60)'%20stop-opacity%3D'0.03'%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D'320'%20height%3D'200'%20fill%3D'url(%23g)'%2F%3E%3Ccircle%20cx%3D'250'%20cy%3D'56'%20r%3D'92'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.06'%2F%3E%3Ccircle%20cx%3D'64'%20cy%3D'172'%20r%3D'58'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.05'%2F%3E%3C%2Fsvg%3E)
