skillos-core 0.1.0

Core abstractions for SkillOS

skillos-core

Core abstractions for SkillOS.

SkillRepo

SkillRepo is a read-only abstraction over a directory of skills, backed by fsspec. The backend is selected from the URL protocol, so the same code works against local disk, S3, GCS, Azure, in-memory test fixtures, and anything else fsspec supports.

A skill is any immediate subdirectory of the repo root that contains a SKILL.md file. The SKILL.md may have YAML frontmatter; everything else in the directory is treated as bundled resources.

from skillos_core import SkillRepo

repo = SkillRepo("/path/to/skills")          # local
repo = SkillRepo("s3://bucket/skills")       # S3 (pip install skillos-core[s3])
repo = SkillRepo("gs://bucket/skills")       # GCS (pip install skillos-core[gcs])

for skill in repo:
    print(skill.name, "-", skill.description)

skill = repo.read("hello")
print(skill.body)
for path in skill.list_resources():
    data = skill.read_resource(path)