New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Celeste Python

by withceleste in withceleste/celeste-python

A skill your agent uses whenever writing, modifying, reviewing, or debugging code involving Celeste, celeste-ai, celeste-python, import celeste, src/celeste, or withceleste app integrations.

MITAuto-check passedDevelopment

Install Celeste Python

skills CLI
$ npx skills add withceleste/celeste-python --skill celeste-python -a claude-code

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

GitHub CLI
$ gh skill install withceleste/celeste-python celeste-python --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/withceleste/celeste-python.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/celeste-python .claude/skills/celeste-python && 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
celeste-python
GitHub stars
221
Token cost
~1.1k tokens
SKILL.md length
479 words
Files
7 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses whenever writing, modifying, reviewing, or debugging code involving Celeste, celeste-ai, celeste-python, import celeste, src/celeste, or withceleste app integrations.

  • Works in 5 steps: Current source code in src/celeste/ → Current tests and templates for existing… → README examples and public exports → …
  • Debugging code involving Celeste
  • SKILL.md covers First Step, Source-Of-Truth Order, Route The Task and App Integration Rules, plus 3 more sections
  • Calls make

What it does

Celeste Python is an agent skill from withceleste/celeste-python. Use whenever writing, modifying, reviewing, or debugging code involving Celeste, celeste-ai, celeste-python, import celeste, src/celeste, or withceleste app integrations. This includes providers, modalities, models, artifacts, MIME types, parameters, tools, multimodal messages, streaming, structured outputs, protocol/base URL support, and tests. Always use this skill before inventing Celeste types, registries, model catalogs, provider abstractions, request/response shapes, or syntax.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `evals/evals.json`, `references/anti-patterns.md` and `references/public-api.md`). Compatibility notes: Local celeste-python repository skill; no network required.

It sits in Development, covering Structured output and tool calling, Debugging and Type safety. It works with Python. The repository describes itself as: Open source, type-safe primitives for multi-modal AI. All modelities, all providers, one interface 🌟. The licence is MIT.

When your agent uses it

  • Debugging code involving Celeste
  • Withceleste app integrations

Example prompts

  • “/celeste-python”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Local celeste-python repository skill; no network required.

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Current source code in src/celeste/
  2. Current tests and templates for existing behavior
  3. README examples and public exports
  4. Notes such as common_agent_mistakes.md
  5. Model memory

What it can do on your machine

Read from SKILL.md and the folder at commit 6f7016b. 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

    Shell commands in SKILL.md call:

    • make

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

  • Compatibility

    Local celeste-python repository skill; no network required.

    From compatibility in the SKILL.md frontmatter.

Context cost

Celeste Python loads about 1.1k tokens when it runs, and up to ~8.1k if it reads all its reference files. Until then it costs about 126 tokens; SKILL.md has 479 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~126
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.1k

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from withceleste/celeste-python at commit 6f7016b, republished under its MIT licence (© withceleste). 479 words, ~1,098 tokens.

Download SKILL.mdSave it as .claude/skills/celeste-python/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
celeste-python
description
Use whenever writing, modifying, reviewing, or debugging code involving Celeste, celeste-ai, celeste-python, import celeste, src/celeste, or withceleste app integrations. This includes providers, modalities, models, artifacts, MIME types, parameters, tools, multimodal messages, streaming, structured outputs, protocol/base URL support, and tests. Always use this skill before inventing Celeste types, registries, model catalogs, provider abstractions, request/response shapes, or syntax.
compatibility
Local celeste-python repository skill; no network required.

Celeste Python Coding

Use this skill to stay aligned with the actual Celeste SDK in this repository. Celeste is evolving, so current source and tests are more reliable than model memory.

First Step

Read references/repo-map.md before making Celeste-related code changes or review claims. It gives the current public API, internal layering, extension seams, templates, and canonical tests.

Then read only the references relevant to the task:

  • App-side integration: references/public-api.md
  • SDK-internal provider, modality, model, parameter, protocol, streaming, or tool work: references/sdk-architecture.md
  • Review/debugging or suspicious Celeste code: references/anti-patterns.md
  • Test selection or final checks: references/verification.md

Source-Of-Truth Order

When sources disagree, follow this order:

  1. Current source code in src/celeste/
  2. Current tests and templates for existing behavior
  3. README examples and public exports
  4. Notes such as common_agent_mistakes.md
  5. Model memory

Treat common_agent_mistakes.md as advisory. Verify every warning against current code and the task context.

Route The Task

Classify the task before coding:

  • App integration: code outside the SDK consuming Celeste. Prefer public namespaces and public exports. Keep the boundary thin.
  • SDK internals: changes inside src/celeste, templates, or tests. Follow existing modality, provider, protocol, model, mapper, and streaming patterns.
  • Review/debugging: identify whether issues are app-side duplication, SDK pattern drift, unsupported model/parameter assumptions, or test gaps.

App Integration Rules

Use the public API first:

  • celeste.text.*
  • celeste.images.*
  • celeste.audio.*
  • celeste.videos.*
  • celeste.documents.*

Use create_client(...) when explicit client reuse or explicit modality, operation, provider, protocol, base_url, or auth configuration is needed.

Do not create app-local duplicates for Celeste-owned concepts unless the user explicitly asks for a temporary compatibility layer. Import and use Celeste types for roles, providers, modalities, operations, artifacts, MIME types, tools, and model discovery.

Show full SKILL.md (211 more words)Show less

SDK Internal Rules

Do not flatten Celeste into a single invented abstraction. The SDK intentionally separates:

  • provider auth registration
  • modality provider maps
  • provider API mixins
  • modality-specific provider clients
  • per-modality model aggregation
  • parameter enums and ParameterMappers
  • constraints and optional input type inference
  • protocol clients for compatible APIs

Start from nearby existing providers/modalities and templates. Use focused tests as executable documentation.

Common Failure Modes

Before adding new local code, check whether Celeste already owns the concept. Watch for:

  • raw provider, role, MIME, modality, operation, or input-type strings where Celeste exposes enums
  • app-side model allowlists where list_models(...) or the host app's existing Celeste discovery flow should be used
  • runtime registry patching from app code
  • provider SDK request shapes copied directly into app code
  • new parameter names without modality enums, TypedDict fields, model constraints, and provider mappers
  • provider registration changes that update one seam but miss auth, modality maps, model aggregation, or tests

Verification

Pick focused tests from references/verification.md based on the seam touched. For broader read-only checks, use the repo commands:

  • make lint
  • make typecheck
  • make test

For finalization commands that may rewrite files, use them only when mutation is intended:

  • make format
  • make ci (runs lint-fix and format internally)

If you cannot run a relevant command, say so and explain the remaining risk.

© withceleste, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in .agents/skills/celeste-python of withceleste/celeste-python.

  • SKILL.md
  • evals/evals.json
  • references/anti-patterns.md
  • references/public-api.md
  • references/repo-map.md
  • references/sdk-architecture.md
  • references/verification.md

Open the folder on GitHubat commit 6f7016b

Compare with similar skills

Celeste Python 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.

Celeste Python compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Celeste Python this skillwithceleste/celeste-python221—~1.1kAutomated safety check: PassMIT
Pydantic AIdavila7/claude-code-templates32k4 repos~2.9kAutomated safety check: PassMIT
Outlines Structured GenerationOrchestra-Research/AI-Research-SKILLs13k10 repos~4kAutomated safety check: PassMIT
Pydanticaimagnus919/agent-skills111—~4kAutomated safety check: PassMIT
The Art of Debuggingstas00/the-art-of-debugging1.7k—~6.1kAutomated safety check: NotesCC-BY-SA-4.0
ExecuTorch on Zephyrpytorch/executorch5.1k—~1.9kAutomated safety check: PassCustom licence

Similar skills

  • Pydantic AI

    davila7/claude-code-templates

    Build production-ready AI agents with PydanticAI — type-safe tool use, structured outputs, dependency injection, and multi-model support.

    32k GitHub starsUsed in 4 repos~2.9k tokens
    AI & LLM EngineeringAuto-check passed

  • Outlines Structured Generation

    Orchestra-Research/AI-Research-SKILLs

    Uses the Outlines library to constrain model output to a JSON schema, Pydantic model, regex or fixed set of choices when running local models.

    13k GitHub starsUsed in 10 repos~4k tokens
    AI & LLM EngineeringAuto-check passed

  • Pydanticai

    magnus919/agent-skills

    Build type-safe AI agents and graph-based workflows with PydanticAI and PydanticGraph.

    111 GitHub stars~4k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

  • The Art of Debugging

    stas00/the-art-of-debugging

    Condensed debugging method and tool recipes for Unix, Python and PyTorch programs: crashes, hangs, segfaults, wrong output, CUDA OOM, NaN values and slowness.

    1.7k GitHub stars~6.1k tokensUpdated today
    DevelopmentAuto-check: notes

  • ExecuTorch on Zephyr

    pytorch/executorch

    Sets up ExecuTorch as a Zephyr RTOS module, adds board support and debugs west build failures such as linker memory overflow on embedded boards.

    5.1k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed

  • Debug Session

    ai-dynamo/dynamo

    Sets up a structured debugging session for a Dynamo bug — pull the report from a Linear ticket, GitHub issue, or pasted text, capture the environment, create a persistent worklog markdown file, and…

    8.2k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed

Works with

Categories

Questions about Celeste Python

What does Celeste Python do?

A skill your agent uses whenever writing, modifying, reviewing, or debugging code involving Celeste, celeste-ai, celeste-python, import celeste, src/celeste, or withceleste app integrations. Celeste Python is an agent skill from withceleste/celeste-python. Use whenever writing, modifying, reviewing, or debugging code involving Celeste, celeste-ai, celeste-python, import celeste, src/celeste, or withceleste app integrations.

When should I use Celeste Python?

Celeste Python fits situations like: debugging code involving Celeste; withceleste app integrations.

How do I install Celeste Python in Claude Code?

Run `npx skills add withceleste/celeste-python --skill celeste-python -a claude-code`. Or copy the skill folder (.agents/skills/celeste-python in withceleste/celeste-python) into .claude/skills/celeste-python in your project. Claude Code loads it when a task matches its description.

How do I install Celeste Python in Codex?

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

Can I use Celeste Python 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 withceleste/celeste-python --skill celeste-python -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/celeste-python, .gemini/skills/celeste-python, .github/skills/celeste-python and .opencode/skills/celeste-python in your project.

What does Celeste Python need to run?

Going by SKILL.md and its folder, Celeste Python needs the command-line tools its instructions call (make). Our summary lists: Python 3. Compatibility (from SKILL.md): Local celeste-python repository skill; no network required..

Does Celeste Python access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Celeste Python safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Celeste Python use?

Celeste Python is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Celeste Python use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7k tokens, read only when the agent opens those files.

What are the alternatives to Celeste Python?

Skills that share tags, products or a category with Celeste Python: Pydantic AI (davila7/claude-code-templates, 32k stars), Outlines Structured Generation (Orchestra-Research/AI-Research-SKILLs, 13k stars), Pydanticai (magnus919/agent-skills, 111 stars) and The Art of Debugging (stas00/the-art-of-debugging, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Celeste Python?

withceleste (a GitHub organization) maintains it in withceleste/celeste-python, which has 221 GitHub stars. The repository was last updated on October 7, 2026.

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