orbiter.skills

from orbiter.skills import (
    Skill,
    SkillRegistry,
    SkillError,
    ConflictStrategy,
    parse_github_url,
    extract_front_matter,
    DEFAULT_CACHE_DIR,
    SKILL_FILENAMES,
)

class SkillError(OrbiterError)

class ConflictStrategy(StrEnum)

DEFAULT_CACHE_DIR = Path.home() / ".orbiter" / "skills"

SKILL_FILENAMES = {"skill.md", "SKILL.md"}

class Skill

def __init__(
    self,
    *,
    name: str,
    description: str = "",
    usage: str = "",
    tool_list: dict[str, list[str]] | None = None,
    skill_type: str = "",
    active: bool = True,
    path: str = "",
) -> None

from orbiter.skills import Skill

skill = Skill(
    name="web_search",
    description="Search the web for information.",
    usage="Use this skill to find up-to-date information.",
    tool_list={"search_api": ["search", "fetch_page"]},
    active=True,
)
print(skill)  # Skill(name='web_search', type='', active=True)

class SkillRegistry

def __init__(
    self,
    *,
    conflict: ConflictStrategy | str = ConflictStrategy.KEEP_FIRST,
    cache_dir: Path | None = None,
) -> None

@property
def skills(self) -> dict[str, Skill]

def register_source(self, source: str) -> None

def load_all(self) -> dict[str, Skill]

def get(self, name: str) -> Skill

def search(
    self,
    *,
    query: str = "",
    skill_type: str | None = None,
    active_only: bool = False,
) -> list[Skill]

def list_names(self) -> list[str]

from orbiter.skills import SkillRegistry, ConflictStrategy

reg = SkillRegistry(conflict=ConflictStrategy.KEEP_LAST)

# Register local skills
reg.register_source("/path/to/my/skills")

# Register GitHub skills
reg.register_source("https://github.com/user/repo/tree/main/skills")

# Load all skills
skills = reg.load_all()
for name, skill in skills.items():
    print(f"{name}: {skill.description}")

# Search
results = reg.search(query="search", active_only=True)

# Get specific skill
web_skill = reg.get("web_search")
print(web_skill.usage)

def parse_github_url(url: str) -> dict[str, str] | None

from orbiter.skills import parse_github_url

result = parse_github_url("https://github.com/user/repo/tree/main/skills")
# {"owner": "user", "repo": "repo", "branch": "main", "subdir": "skills"}

result = parse_github_url("https://github.com/user/repo")
# {"owner": "user", "repo": "repo", "branch": "main", "subdir": ""}

result = parse_github_url("not a github url")
# None

def extract_front_matter(text: str) -> tuple[dict[str, Any], str]

from orbiter.skills import extract_front_matter

text = """---
name: my_skill
description: A useful skill
active: true
tool_list: {"search": ["web_search"]}
---
# Usage
Use this skill to search the web.
"""

meta, body = extract_front_matter(text)
# meta = {"name": "my_skill", "description": "A useful skill", "active": True, "tool_list": {"search": ["web_search"]}}
# body = "# Usage\nUse this skill to search the web."

---
name: web_search
description: Search the web for current information
type: agent
active: true
tool_list: {"search_api": ["search", "fetch"]}
---
# Web Search Skill

Use this skill when you need to find up-to-date information.

## Usage
1. Call the search_api tool with your query
2. Process the results