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.3.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 |
| Gemini CLI | gemini-extension.json + agents/*.md |
| 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 |
| Google Antigravity | .agent/skills/ or ~/.gemini/antigravity/skills/ |
| OpenClaw | .agents/skills/ + AGENTS.md |
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.
Gemini CLI
gemini extensions install https://github.com/litestar-org/litestar-skills --auto-update
Gemini auto-indexes this repo into its extension gallery via the gemini-cli-extension GitHub topic.
Codex CLI
Codex CLI 0.125+ required. The marketplace lives at .agents/plugins/marketplace.json and points at the committed generated package under plugins/litestar/.
codex plugin marketplace add litestar-org/litestar-skills
Then enable inside a Codex session via /plugins. See .codex/INSTALL.md for local-development install paths.
OpenCode
OpenCode reads .opencode/skills/, .claude/skills/, and .agents/skills/ natively. Two install paths:
# Option 1: project-local skills (no plugin features)
git clone --depth 1 https://github.com/litestar-org/litestar-skills /tmp/litestar-skills
mkdir -p .agents/skills
cp -r /tmp/litestar-skills/skills/* .agents/skills/
# Option 2: global plugin (recommended) — injects project-aware skill reminders
git clone https://github.com/litestar-org/litestar-skills ~/.config/opencode/litestar
ln -sf ~/.config/opencode/litestar/.opencode/plugins/litestar.js \
~/.config/opencode/plugins/litestar.js
Option 2 ships a real experimental.chat.system.transform handler that injects targeted Litestar skill reminders into the system prompt and honors managed-config policy. See .opencode/INSTALL.md.
Google Antigravity
Antigravity reads Agent Skills from .agent/skills/ (singular .agent, note the naming collision with the plural .agents/skills/ used by Claude Code / OpenCode / VS Code) or from ~/.gemini/antigravity/skills/ globally. Since this repo ships the plural form, the recommended workspace-scope install is a symlink:
cd your-project
git clone --depth 1 https://github.com/litestar-org/litestar-skills /tmp/litestar-skills
mkdir -p .agents/skills
cp -r /tmp/litestar-skills/skills/* .agents/skills/
ln -s .agents .agent # community workaround — not a Google-blessed integration
For global installs across all workspaces:
mkdir -p ~/.gemini/antigravity/skills
cp -r /tmp/litestar-skills/skills/* ~/.gemini/antigravity/skills/
See Antigravity Skills docs. The installer's --antigravity-symlink flag (below) automates the workspace symlink when you already have .agents/skills/ present.
OpenClaw
OpenClaw reads the generic Agent Skills tree; no OpenClaw-specific manifest is needed:
git clone --depth 1 https://github.com/litestar-org/litestar-skills /tmp/litestar-skills
mkdir -p .agents/skills
cp -r /tmp/litestar-skills/skills/* .agents/skills/
OpenClaw consumes the shipped generic Agent Skills tree and AGENTS.md; no OpenClaw-specific wrapper is shipped.
Cursor
