bowerbot-skill-sketchfab 0.1.1

BowerBot skill that searches and downloads from the user's Sketchfab account

bowerbot-skill-sketchfab

Sketchfab provider skill for BowerBot.

Searches and downloads 3D models from the user's authenticated Sketchfab account in USDZ format.

---

What it does

This skill connects BowerBot to the authenticated user's own Sketchfab model library, not the public marketplace. It exposes three LLM-callable tools:

Tool	Description
search_my_models	Search your uploaded models by keyword
list_my_models	List every model in your account
download_model	Download a model in USDZ format into BowerBot's library cache

Downloaded models land under <assets_dir>/cache/sketchfab/ and are immediately searchable through BowerBot's search_assets / list_assets tools.

Install

Match the install method you used for BowerBot itself.

If you installed BowerBot with uv tool install, add the skill to the same tool environment:

uv tool install bowerbot --with bowerbot-skill-sketchfab --reinstall

If you installed BowerBot with pip (in a venv or system-wide), install the skill into the same Python environment:

pip install bowerbot-skill-sketchfab

BowerBot discovers the skill automatically via Python entry points (bowerbot.skills). No code changes required in BowerBot.

Configure

Add a sketchfab block to ~/.bowerbot/config.json:

{
  "skills": {
    "sketchfab": {
      "enabled": true,
      "config": { "token": "your-sketchfab-api-token" }
    }
  }
}

Get a token at https://sketchfab.com/settings/password.

Usage

Once installed and configured, the skill is just available to BowerBot. Talk to the agent normally:

You: search my Sketchfab for a round bistro table
BowerBot: Found "Round Bistro Table" (uid: abc123). Want me to download it?

You: yes please
BowerBot: Downloaded to assets/cache/sketchfab/Round_Bistro_Table.usdz

You: place it at the center of the room
BowerBot: Placed at /Scene/Furniture/Round_Bistro_Table_01 (5.0, 0.0, 4.0)

Architecture

This skill follows BowerBot's required FastAPI-style internal layout:

src/bowerbot_skill_sketchfab/
  skill.py          # Skill subclass. Tool registration + execute() dispatch only.
  SKILL.md          # Natural-language instructions injected into the LLM prompt.
  schemas/          # Pydantic models for Sketchfab API payloads
  services/         # One orchestrator per tool (search, download)
  tools/            # Tool definitions surfaced to the LLM
  utils/            # Pure-function primitives (HTTP, naming, response shaping)

The skill is hyper-isolated: it imports only from bowerbot.skills (the public SDK) and its own submodules. No reach into bowerbot.utils, bowerbot.services, or any other core internal.

Development

Default flow uses BowerBot from PyPI:

git clone https://github.com/binary-core-llc/bowerbot-skill-sketchfab.git
cd bowerbot-skill-sketchfab
uv sync --extra dev
uv run pytest

If you are also working on BowerBot itself and want an editable install of the core against your local checkout, run this after uv sync:

uv pip install -e ../bowerbot

That overrides the PyPI-resolved bowerbot with your local source.

License

Apache 2.0. See LICENSE.

---

Built with 🐦 by Binary Core LLC