skill

AI Agent Skill Search and Management.

Simple usage:

from skill import search, install, create, list_skills, validate

# Search for skills
results = search('react best practices', local_only=True)

# Create a new skill locally
skill = create('my-skill', description='My custom skill')

# Validate a skill
issues = validate('/path/to/skill-dir')

Plugin registries:

from skill.install import agent_targets
from skill.translate import translators
from skill.search import backends
from skill.create import validators

Functions

list_skills(*[, agent_target, scope])	List locally installed skills, optionally filtered by agent target.
show(key)	Read and return a skill by its canonical key.
sources()	List registered search backends with their name, homepage, and status.

skill.list_skills(*, agent_target=None, scope='all')

List locally installed skills, optionally filtered by agent target.

Return type:

list[SkillInfo]

>>> isinstance(list_skills(), list)
True

skill.show(key)

Read and return a skill by its canonical key.

Raises KeyError if the skill is not found locally.

Return type:

Skill

skill.sources()

List registered search backends with their name, homepage, and status.

Return type:

list[dict]

>>> isinstance(sources(), list)
True

Modules

ai	Optional AI facade for semantic search and LLM-powered features.
backends	Backend protocols and local filesystem backend.
base	Core data model and SKILL.md parsing.
cli_format	Terminal-friendly formatting for CLI output.
completion	Shell completion setup and diagnostics.
config	Configuration management via platformdirs and TOML.
create(name, *[, description, body, owner, ...])	Create a new skill and store it locally.
install(key, *[, agent_targets, scope, ...])	Install a skill into one or more agent target directories.
registry	Generic plugin registry with entry point discovery.
search(query, *[, max_results, local_only, ...])	Search for skills across local index and remote backends.
stores	Storage layer: LocalSkillStore and SourcedSkillStore via dol.
translate	Format translators: SKILL.md <-> agent-specific formats.
util	Pure helpers with zero internal imports.