Soliplex Skills¶

soliplex-skills is shared infrastructure for releasing and upgrading versioned filesystem skills (agentskills.io style: a directory with a SKILL.md plus references/, scripts/, and assets/) across the Soliplex projects:

Repository	Skills it publishes
`soliplex`	`soliplex-docs`
`soliplex-template`	`soliplex-template`
`soliplex-concierge`	`soliplex-concierge-installer`, `soliplex-concierge-room`, `soliplex-concierge-admin`

See the Skills catalog for what each skill does, where it runs (inside Soliplex or in an external coding agent), its source repo, and its latest release.

Status

This site documents the mechanisms these projects use and the library API that provides them. The library is implemented and tested (100% branch coverage).

What it provides¶

One importable, tested Python package holding the release/upgrade machinery a versioned filesystem skill needs:

versions — list / diff / upgrade a published skill against its GitHub releases, driven by a per-skill SkillSpec.
install — download, install / upgrade a published or local skill into a stack, and defang it for room-agent use (see Installing and upgrading skills).
build — assemble a skill into dist/<name>/: copy the source tree, stamp SKILL.md with the source commit, and validate it (with an optional generator hook for build-time content).
releases / manifest / metadata / _archive — GitHub release access, the version.json schema, reading/stamping SKILL.md's source_commit, and the download/verify/extract primitives the others build on.

Where to start¶

I maintain a skill / this libraryI have a skill installed and want to manage itI want to publish a skill from my own repo

Read the Overview for the vocabulary and the release model, then the Mechanisms section for how building, publishing, and installation map onto the library API. The API reference is the full surface.

Go straight to Managing an installed skill: how to list published versions, diff your installed copy against a published one, and upgrade (or downgrade) in place.

Follow Adopt in a new repo: a step-by-step setup with copy-paste-ready skill_versions.py, build_skill.py, and GitHub Actions workflow examples.

How the skills use it¶

Each skill bundles a thin skill_versions.py. Because an installed skill runs in an environment where soliplex_skills is not installed, it is a small PEP 723 script that declares # dependencies = ["soliplex-skills>=…"] in its inline metadata, letting uv provision the library at run time. It fills in a SkillSpec and delegates to SkillVersions.
Build scripts call soliplex_skills.build. soliplex-template and soliplex-concierge build via build.build_skill (discover_skills plus a loop for the multi-skill concierge repo); the soliplex-docs builder passes a generator hook to build_skill for its nav-derived documentation map. All reuse metadata.stamp_metadata and in-process skills_ref validation.
Publishing lives in each repo's GitHub Actions workflow — dual-mode releases, the version.json manifest, and prune-to-KEEP_ROLLING — and the build step it runs is the part that calls this library.