albucore-public-api
Controls the public API surface area and star-exports for the Albucore library.
Install
mkdir -p .claude/skills/albucore-public-api && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12988" && unzip -o skill.zip -d .claude/skills/albucore-public-api && rm skill.zipInstalls to .claude/skills/albucore-public-api
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Albucore star-exported API (__all__), routers vs albucore.functions shims, and dependents such as Albumentations. Use when changing exports, documenting API, or deciding what belongs in package __all__.Key capabilities
- →Manage `__all__` exports for star-import compatibility
- →Re-export router functions from `albucore/functions.py`
- →Document router classification in `docs/public-api.md`
- →Add new exports to the appropriate submodule
- →Ensure new exports are exposed via `functions.py`
- →Update `docs/public-api.md` if classification changes
How it works
The skill defines how to expose functions in Albucore's public API by managing `__all__` lists, re-exporting through `functions.py`, and documenting classifications.
Inputs & outputs
When to use albucore-public-api
- →Update API exports
- →Document public library functions
- →Maintain package __all__
- →Add shim functions
About this skill
Albucore Public API
Star Import
from albucore import * follows albucore/__init__.py, which merges __all__ from functions, decorators, geometric, and utils, plus metadata.
Most routers live in albucore/functions.py __all__, re-exported from arithmetic, lut, normalize, convert, ops_misc, and stats. Geometric routers live in albucore/geometric.py __all__ and are separately merged by package __init__; resize3d is one such router.
Classification Doc
Use docs/public-api.md for router classification and explicit from albucore.functions import ... shims such as *_opencv, *_numpy, NumKong helpers, and LUT plumbing.
Dependents
If Albumentations or another downstream package imports a symbol, it must be either:
- On package
__all__for star-import compatibility, or - Documented with an explicit import path such as
albucore.functions.
Example: sz_lut and apply_uint8_lut are public routers on __all__ and are implemented in albucore/lut.py.
Adding an Export
- Implement in the appropriate submodule (
arithmetic.py,lut.py,geometric.py, etc.). - For a regular router, ensure
from submodule import *infunctions.pyexposes the name and append it tofunctions.__all__, sorted or grouped with peers. - For a geometric router, append it to
geometric.__all__; do not add a compatibility shim tofunctions.pyunless there is a separate public-API decision. - Confirm
from albucore import <name>succeeds and that the name occurs once in package__all__. - Update
docs/public-api.mdif classification changes.
When not to use it
- →When a symbol is not intended for public API exposure
- →When a symbol is not imported by a downstream package like Albumentations
Limitations
- →The skill requires symbols to be on `__all__` for star-import compatibility
- →The skill requires explicit import paths for symbols not on `__all__`
- →The skill assumes `albucore/__init__.py` merges `__all__` from specific submodules
How it compares
This workflow provides a structured process for adding and documenting public API exports, ensuring consistency and compatibility for dependents, unlike ad-hoc exposure.
Compared to similar skills
albucore-public-api side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| albucore-public-api (this skill) | 0 | 2mo | No flags | Intermediate |
| fastapi-templates | 520 | 2mo | No flags | Intermediate |
| mcp-builder | 136 | 3mo | Review | Advanced |
| fastapi-pro | 79 | 4mo | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
fastapi-templates
wshobson
Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.
mcp-builder
anthropics
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
fastapi-pro
sickn33
Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns. Use PROACTIVELY for FastAPI development, async optimization, or API architecture.
telegram-bot-builder
davila7
Expert in building Telegram bots that solve real problems - from simple automation to complex AI-powered bots. Covers bot architecture, the Telegram Bot API, user experience, monetization strategies, and scaling bots to thousands of users. Use when: telegram bot, bot api, telegram automation, chat bot telegram, tg bot.
stripe-integration
wshobson
Implement Stripe payment processing for robust, PCI-compliant payment flows including checkout, subscriptions, and webhooks. Use when integrating Stripe payments, building subscription systems, or implementing secure checkout flows.
billing-automation
wshobson
Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.