Litestar Skills
litestar-org/litestar-skills
Skills e MCP servers do Litestar para todos os agentes de IA
Ver no GitHubColeção curada de skills, plugins e MCP servers de primeira parte para o framework Litestar, publicáveis em todos os principais agentes de IA (Claude Code, Gemini CLI, Cursor, VS Code) a partir de um único repositório. Ensina a agentes de IA como o time Litestar realmente constrói software, cobrindo o framework core e bibliotecas especializadas.
Instalação
npx convez-ai litestar-org/litestar-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolvimento com framework Litestar em múltiplos agentes de IA
- Integração de melhores práticas Litestar em Claude Code, Gemini CLI e VS Code
- Publicação de skills e agents em marketplaces de múltiplos hosts
Veredito

Recurso técnico legítimo para times que usam Litestar em múltiplos agentes de IA simultaneamente. Ainda em early access (v0.3.0), com bom volume de conteúdo canonical (~28.500 linhas) e suporte multiplataforma sólido, mas requer conhecimento prévio de Litestar e ecosistema de agentes.
README
A tradução para o português deste README ainda está na fila.
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.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.
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
Cursor → Settings → Rules → Add Remote Rule → https://github.com/litestar-org/litestar-skills
VS Code / GitHub Copilot
git clone https://github.com/litestar-org/litestar-skills ~/.copilot/litestar
Then in VS Code settings.json:
{
"chat.skillsLocations": {
"~/.copilot/litestar/skills": true
}
}
One-shot multi-host installer
Installs for every supported CLI detected on your system. Auto-installs for Gemini CLI, Codex CLI, and OpenCode; prints instructions for Claude Code, Cursor, and VS Code.
curl -fsSL https://raw.githubusercontent.com/litestar-org/litestar-skills/main/tools/install.sh | bash
Flags:
# Preview without executing
curl -fsSL https://raw.githubusercontent.com/litestar-org/litestar-skills/main/tools/install.sh | bash -s -- --dry-run
# Install for specific hosts only
curl -fsSL https://raw.githubusercontent.com/litestar-org/litestar-skills/main/tools/install.sh | bash -s -- --only gemini --only codex
# Also whitelist the Claude Code marketplace in ~/.claude/settings.json
curl -fsSL https://raw.githubusercontent.com/litestar-org/litestar-skills/main/tools/install.sh | bash -s -- --claude-settings
If you'd rather not pipe to bash, clone first:
git clone https://github.com/litestar-org/litestar-skills
cd litestar-skills
./tools/install.sh --help
Windows (PowerShell 7+ only): native install without WSL. Requires PowerShell 7+ and Git for Windows (for hook dispatch).
pwsh -File tools/install.ps1
# Preview:
pwsh -File tools/install.ps1 -DryRun
# Install for specific host(s):
pwsh -File tools/install.ps1 -Only gemini,codex
If PowerShell 7+ is not installed: winget install Microsoft.PowerShell. If Git for Windows is not installed: https://git-scm.com/download/win.
Optional: Google Developer Knowledge MCP
Google publishes an MCP server that returns fresh Firebase / Google Cloud / Android / Maps docs at developerknowledge.googleapis.com. Useful when a Litestar project depends on a Google-managed service. No manifest is shipped; users opt in per host.
# Claude Code
claude mcp add google-dev-knowledge --transport http \
https://developerknowledge.googleapis.com/mcp \
--header "X-Goog-Api-Key: YOUR_API_KEY"
# Gemini CLI
gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" \
google-developer-knowledge \
https://developerknowledge.googleapis.com/mcp --scope user
Generate the API key at https://console.cloud.google.com/apis/credentials and restrict it to the Developer Knowledge API. Full reference: skills/litestar-styleguide/references/google-developer-knowledge-mcp.md.
Discovery topics
This repo is tagged with GitHub topics so downstream registries and galleries auto-crawl it:
| Topic | Downstream effect |
|---|---|
gemini-cli-extension | Gemini CLI's extension gallery auto-indexes tagged repos. |
litestar | Framework discoverability — surfaces in Litestar-ecosystem GitHub searches. |
agent-skills | Generic agent-skills discoverability for Claude Code / Copilot CLI skill indexes. |
claude-code-plugin | Claude Code plugin discoverability (e.g., claudeskills.info). |
Topics are re-applied on every tagged release via .github/workflows/release.yml. The operation is idempotent; gh repo edit --add-topic is additive and deduplicates.
Vercel skills.sh
skills.sh ranks skill bundles by install volume from the npx skills CLI — there is no submission flow. To install via that path:
npx skills add litestar-org/litestar-skills
Each install increments the repo's ranking.
Uninstall
curl -fsSL https://raw.githubusercontent.com/litestar-org/litestar-skills/main/tools/uninstall.sh | bash
Or from a clone: ./tools/uninstall.sh --help. Same --only, --skip, --dry-run, --force, --claude-settings flags as the installer.
Per-host uninstall:
- Claude Code:
/plugin uninstall litestarinside Claude Code - Gemini CLI:
gemini extensions uninstall litestar - Codex CLI:
rm -rf ~/.codex/plugins/litestar - OpenCode:
rm ~/.config/opencode/plugins/litestar.js && rm -rf ~/.config/opencode/litestar - Cursor: remove the Remote Rule from Settings → Rules
- VS Code: remove the
chat.skillsLocationsentry + delete the clone
Troubleshooting
"No supported CLIs detected" — none of claude, gemini, codex, opencode, cursor, or code are on $PATH. Install at least one and re-run.
Symlink fails on Windows — run the installer under WSL or Git Bash. Native Windows support is backlog.
Permission denied on ~/.codex/plugins/ — do NOT run with sudo; the installer refuses root. Ensure your user owns ~/.codex/ and ~/.config/.
Gemini says extension already exists — the installer upgrades automatically. Use --force to re-install from scratch.
Claude Code can't find the marketplace — re-run with --claude-settings to whitelist, or inside Claude Code manually: /plugin marketplace add litestar-org/litestar-skills.
What's In This Repo
28 skills, focused references, ~28,500+ lines of canonical content:
| Category | Skills |
|---|---|
| Core | litestar |
| Litestar app surfaces | litestar-routing, litestar-dto-openapi, litestar-auth-guards, litestar-di, litestar-data-services, litestar-settings, litestar-exceptions, litestar-middleware, litestar-plugins, litestar-realtime, litestar-ai-serving |
| Foundation | litestar-styleguide |
| Data | advanced-alchemy, sqlspec, msgspec |
| Server | litestar-granian |
| Tasks | litestar-saq |
| Frontend | litestar-vite, litestar-inertia, litestar-htmx |
| Integrations | litestar-mcp, litestar-email |
| Packaging | litestar-build |
| Deployment | litestar-deployment |
| Testing | litestar-testing, pytest-databases, polyfactory |
Each skill includes a SKILL.md plus focused references.
Project documents
- Roadmap — v0.2 candidates and explicitly-deferred items with graduation triggers.
- Policy & permissions — per-host allow/ask/deny grammar, managed-settings paths, and the cross-host policy bootstrap pattern. Drop-in template at templates/managed-settings/claude-code.json.
Contributing
See CONTRIBUTING.md for skill authoring conventions, manifest update rules, and the release process.
License
MIT — see LICENSE. Matches Litestar upstream.