Agent skill

Starlette

by simonw in simonw/research

Build async web applications and APIs with Starlette 1.0, the lightweight ASGI framework for Python.

No licenceAuto-check: notesBackend & APIs

Install Starlette

skills CLI
$ npx skills add simonw/research --skill starlette -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install simonw/research starlette --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/simonw/research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/starlette-1-skill .claude/skills/starlette && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
starlette
GitHub stars
781
Token cost
~8.6k tokens
SKILL.md length
563 words
Files
6
Skills in repo
3
Repo updated
First seen
Licence
None found

At a glance

Build async web applications and APIs with Starlette 1.0, the lightweight ASGI framework for Python.

  • Works in 12 steps: Application → Routing → Requests → …
  • A user wants to create an async Python web app
  • SKILL.md covers Installation, 1 · Application, 2 · Routing and 3 · Requests, plus 4 more sections
  • Runs Python scripts from its folder; calls pip and uvicorn; reaches httpbin.org; needs SECRET_KEY

What it does

Starlette is an agent skill from simonw/research. Build async web applications and APIs with Starlette 1.0, the lightweight ASGI framework for Python. Use this skill whenever a user wants to create an async Python web app, REST API, WebSocket server, or ASGI application using Starlette. Triggers include mentions of 'Starlette', 'ASGI', async Python web frameworks, or requests to build lightweight async APIs, WebSocket services, streaming responses, or middleware pipelines. Also use when the user is working with FastAPI internals (which is built on Starlette)…

Its SKILL.md is about 8.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `README.md`, `_summary.md` and `taskflow/database.py`).

It sits in Backend & APIs, covering Realtime and WebSockets, Backend development and LLM API integration. It works with Python and FastAPI.

When your agent uses it

  • A user wants to create an async Python web app
  • WebSocket server
  • ASGI application using Starlette
  • Include mentions of Starlette

Example prompts

  • “Starlette”
  • “/starlette”

Requirements

  • Python 3

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Application
  2. Routing
  3. Requests
  4. Responses
  5. WebSockets
  6. Class-Based Endpoints
  7. Middleware
  8. Lifespan (Startup & Shutdown)
  9. Background Tasks
  10. Templates (Jinja2)
  11. Static Files
  12. Exception Handling

What it can do on your machine

Read from SKILL.md and the folder at commit 4f5f23e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • pip
    • uvicorn

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • httpbin.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SECRET_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Starlette loads about 8.6k tokens when it runs. Until then it costs about 196 tokens; SKILL.md has 563 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~196
When it runs · the whole SKILL.md, loaded when a task matches
~8.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:941
    config = Config(".env")
  • NoteMentions a .env fileSKILL.md:953
    config = Config(".env", encoding="latin-1")
  • NoteMentions a .env fileSKILL.md:956
    `.env` file:
  • NoteMentions a .env fileSKILL.md:1212
    config = Config(".env")

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 563 words (~8,553 tokens).

“Starlette is a lightweight ASGI framework/toolkit for building high-performance async web services in Python. Version 1.0 was released on March 22, 2026 — the first stable release after nearly eight years of development. It requires Python 3.10+ and depends only…”

— opening of SKILL.md by simonw
name
starlette

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files in starlette-1-skill of simonw/research.

  • SKILL.md
  • README.md
  • _summary.md
  • taskflow/database.py
  • taskflow/main.py
  • taskflow/templates/index.html

Open the folder on GitHubat commit 4f5f23e

Compare with similar skills

Starlette next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Starlette compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Starlette this skillsimonw/research781—~8.6kAutomated safety check: NotesNone
FastAPI ExpertJeffallan/claude-skills12k—~1.8kAutomated safety check: PassMIT
API Route Designaiskillstore/marketplace430—~1.9kAutomated safety check: PassNone
Fastcrudbenavlabs/fastcrud1.6k—~5kAutomated safety check: PassMIT
FastAPI Project Templateswshobson/agents40k11 repos~901Automated safety check: PassMIT
Fastapi REST API Designopen-edge-platform/anomalib6.2k—~838Automated safety check: PassApache-2.0

Similar skills

  • FastAPI Expert

    Jeffallan/claude-skills

    Builds async Python APIs with FastAPI and Pydantic V2, covering endpoints, JWT authentication, async SQLAlchemy, WebSockets and pytest checks against the OpenAPI docs.

    12k GitHub stars~1.8k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • API Route Design

    aiskillstore/marketplace

    A skill your agent uses when designing RESTful API endpoints in FastAPI or Python projects.

    430 GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Fastcrud

    benavlabs/fastcrud

    A skill your agent uses when building or modifying CRUD endpoints with FastCRUD (the fastcrud PyPI package) in a FastAPI project — covers FastCRUD, crudrouter, EndpointCreator, FilterConfig…

    1.6k GitHub stars~5k tokensUpdated 12 days ago
    Backend & APIsAuto-check passed
  • Scaffolds FastAPI projects with a layered app layout, dependency injection through Depends, async handlers and database access, middleware and pytest setup.

    40k GitHub starsUsed in 11 repos~901 tokens
    Backend & APIsAuto-check passed
  • Fastapi REST API Design

    open-edge-platform/anomalib

    Designs and reviews REST APIs for FastAPI services using consistent resource naming, HTTP semantics, validation, security, and error handling patterns.

    6.2k GitHub stars~838 tokensUpdated today
    Backend & APIsAuto-check passed
  • Fastapi Pro

    davila7/claude-code-templates

    Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2.

    32k GitHub starsUsed in 7 repos~1.6k tokens
    Backend & APIsAuto-check passed

More from simonw/research

  • Guide for writing Datasette plugins. An agent skill from simonw/research.

    781 GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed
  • CSV Insights

    simonw/research

    Summarize a CSV, compute basic stats, and produce a markdown report + a plot image.

    781 GitHub stars~154 tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Starlette

What does Starlette do?

Build async web applications and APIs with Starlette 1.0, the lightweight ASGI framework for Python. Starlette is an agent skill from simonw/research.0, the lightweight ASGI framework for Python.

When should I use Starlette?

Starlette fits situations like: A user wants to create an async Python web app; webSocket server; ASGI application using Starlette; include mentions of Starlette.

How do I install Starlette in Claude Code?

Run `npx skills add simonw/research --skill starlette -a claude-code`. Or copy the skill folder (starlette-1-skill in simonw/research) into .claude/skills/starlette in your project. Claude Code loads it when a task matches its description.

How do I install Starlette in Codex?

Run `npx skills add simonw/research --skill starlette -a codex`. Or copy the skill folder (starlette-1-skill in simonw/research) into .agents/skills/starlette in your project. Codex loads it when a task matches its description.

Can I use Starlette in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add simonw/research --skill starlette -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/starlette, .gemini/skills/starlette, .github/skills/starlette and .opencode/skills/starlette in your project.

What does Starlette need to run?

Going by SKILL.md and its folder, Starlette needs Python for the scripts in its folder, the command-line tools its instructions call (pip and uvicorn) and credentials named SECRET_KEY. Our summary lists: Python 3.

Does Starlette access the network?

SKILL.md names 1 domain. In commands or code: httpbin.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Starlette safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Starlette use?

No licence was found for Starlette or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Starlette use?

About 8.6k tokens (SKILL.md is roughly 34k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Starlette?

Skills that share tags, products or a category with Starlette: FastAPI Expert (Jeffallan/claude-skills, 12k stars), API Route Design (aiskillstore/marketplace, 430 stars), Fastcrud (benavlabs/fastcrud, 1.6k stars) and FastAPI Project Templates (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Starlette?

simonw (a GitHub user) maintains it in simonw/research, which has 781 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 4, 2026.

Source: simonw/research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.