⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
advanced-alchemy
Auto-activate for advanced_alchemy, alembic/, SQLAlchemyAsyncRepositoryService, SQLAlchemyAsyncConfig, repository_type, service_class, filters, or storage. Not for raw SQLAlchemy — use sqlspec.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
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 Security, Litestar Autowire, Litestar Granian, Litestar SAQ, Litestar Queues, Litestar Vite, Litestar MCP, Litestar Email, and Litestar HTMX.
Status
v0.10.0 — early access. Multi-host plumbing, 20 skills, ~35,000 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 + agents/claude/*.md |
| Antigravity CLI | plugin.json + hooks.json + rules/litestar-antigravity.md + 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/sqlspec/SKILL.md |
| Hook and policy namespace | litestar:<skill-name>, e.g. litestar:sqlspec |
| 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:sqlspec for focused skills. Plugin policy uses Skill(litestar:<skill-name>). | /litestar:configure, /litestar:new-app, /litestar:new-domain, /litestar:review | Select litestar-reviewer from agents/claude/ where Claude exposes plugin subagents. |
| Antigravity CLI | Skills load from the litestar plugin or .agents/skills/; use the displayed skill/template name in Antigravity. PreInvocation hooks in root hooks.json and rules/litestar-antigravity.md 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
git clone --depth 1 https://github.com/litestar-org/litestar-skills ~/.config/antigravity/litestar
agy plugin install ~/.config/antigravity/litestar
Existing legacy Google CLI extension installs should migrate through Antigravity CLI's plugin import flow; fresh installs use the plugin.json path above.
Run agy plugin validate ~/.config/antigravity/litestar to confirm that skills, agents, commands, and hooks are all discovered.
Codex CLI
Codex CLI 0.125+ required. The marketplace lives at
.agents/plugins/marketplace.jsonand points at the committed generated package underplugins/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.
Antigravity workspace skills
Antigravity CLI reads workspace skills from .agents/skills/ and global skills from ~/.gemini/antigravity-cli/skills/. For skills-only workspace installs:
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/
For global installs across all workspaces:
mkdir -p ~/.gemini/antigravity-cli/skills
cp -r /tmp/litestar-skills/skills/* ~/.gemini/antigravity-cli/skills/
Use the full plugin install above when you want the reviewer subagent and SessionStart hook in addition to raw skills.
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
Cursor → Settings → Rules → Add Remote Rule → https://github.com/litestar-org/litestar-skills
VS Code / GitHub Copilot
git clone https:/
// HOW IT'S BUILT
KEY FILES