A deterministic, cross-platform agent skill publisher.
Project description
Suphia
Suphia is a compatibility layer for AI agent ecosystems.
It provides a set of tools that allow developers to work with multiple, fast-evolving AI agents using a single source of truth for context and configuration — without duplication.
Suphia is designed to keep context close to your code, while adapting that context to many different agents and formats.
The Problem Suphia Solves
AI development today rarely involves just one agent.
Developers often experiment with:
- Claude
- Gemini
- Copilot
- OpenCode
- Codex
- new or experimental agents
- changing formats and conventions
Each agent introduces:
- different discovery rules
- different configuration formats
- different expectations about layout
Without Suphia, developers end up:
- copying context files again and again
- restructuring repos for each tool
- losing alignment between code and context
Suphia exists so you adapt once, not agent-by-agent.
Suphia’s Core Idea
Keep one canonical source of context, close to your code, and project it outward to any agent that needs it.
Suphia does not enforce a single format. It provides adapters and tooling so agents can coexist.
What Suphia Is
- A CLI toolset
- A Python module library
- An adapter layer between agent ecosystems
Suphia can be:
- used directly via CLI
- integrated into other frameworks
- embedded in automation or CI
What Suphia Is Not
- An agent runtime
- A prompt framework
- A vendor-specific solution
Suphia complements agents — it does not replace them.
Initial Focus: Skills
Suphia v1 starts with skills as a practical, high-impact use case.
It allows you to:
- Place skills anywhere in your repo
- Keep them near relevant code
- Discover them recursively
- Publish them into agent-specific discovery roots
- Avoid copying or rewriting skill files
This enables skill reuse across:
- Claude-style agents
- Copilot-style agents
- OpenCode and others
Installation
Suphia uses uv for Python tooling.
Install:
uv pip install suphia
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file suphia-0.1.0.tar.gz.
File metadata
- Download URL: suphia-0.1.0.tar.gz
- Upload date:
- Size: 35.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b3de6f4668351352818515e056efbc5fea7d5e9186a093f5dd70bf89a0bdff36
|
|
| MD5 |
b288c55b13c39a2ec52be9c2cd42e929
|
|
| BLAKE2b-256 |
0b4106e3af1630870b66fae78a348216e994ae18cef82b50bea7a26e93485e27
|
File details
Details for the file suphia-0.1.0-py3-none-any.whl.
File metadata
- Download URL: suphia-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3b0b0d96e6a29ce5545a4ea8b96703451c686d624ba10746318516740a397cca
|
|
| MD5 |
c6c5dc22acf46c972dfe5c704fd7b913
|
|
| BLAKE2b-256 |
15b05d99ac03c7355eee63c8b00387b42ec8e84bf6f72c34cecf0db50e111572
|
