convez.ai
MCP ServerDesenvolvimento WebIntermediário
litestar-org

Litestar Skills

litestar-org/litestar-skills

Skills e MCP servers do Litestar para todos os agentes de IA

Ver no GitHub
BomPluginScore · de 0 a 100

Coleçã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-skills

1 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

Estrelas
18
Forks
0
Acompanhando
1
Saúde
87%
Último commit
há 1 semana
Versão
—
Issues abertas
2
Contribuidores
3

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:

HostEntry Point
Claude Code.claude-plugin/plugin.json + marketplace metadata
Gemini CLIgemini-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 / CopilotRaw 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

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:

TopicDownstream effect
gemini-cli-extensionGemini CLI's extension gallery auto-indexes tagged repos.
litestarFramework discoverability — surfaces in Litestar-ecosystem GitHub searches.
agent-skillsGeneric agent-skills discoverability for Claude Code / Copilot CLI skill indexes.
claude-code-pluginClaude 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 litestar inside 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.skillsLocations entry + 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:

CategorySkills
Corelitestar
Litestar app surfaceslitestar-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
Foundationlitestar-styleguide
Dataadvanced-alchemy, sqlspec, msgspec
Serverlitestar-granian
Taskslitestar-saq
Frontendlitestar-vite, litestar-inertia, litestar-htmx
Integrationslitestar-mcp, litestar-email
Packaginglitestar-build
Deploymentlitestar-deployment
Testinglitestar-testing, pytest-databases, polyfactory

Each skill includes a SKILL.md plus focused references.

Project documents

Contributing

See CONTRIBUTING.md for skill authoring conventions, manifest update rules, and the release process.

License

MIT — see LICENSE. Matches Litestar upstream.

Ver o original no GitHub

Bom para

Relacionados