agentskills-langchain 0.1.0

LangChain integration for the Agent Skills format (https://agentskills.io)

agentskills-langchain

LangChain integration for the Agent Skills SDK — turn a skill registry into LangChain tools.

Generates a set of LangChain StructuredTool instances from a SkillRegistry, ready to be passed to any LangChain agent.

Installation

pip install agentskills-langchain

Requires Python 3.12+. Installs agentskills-core and langchain-core as dependencies.

Usage

from agentskills_core import SkillRegistry
from agentskills_fs import LocalFileSystemSkillProvider
from agentskills_langchain import get_tools, get_tools_usage_instructions

# Set up registry
provider = LocalFileSystemSkillProvider(Path("./skills"))
registry = SkillRegistry()
await registry.register("incident-response", provider)

# Build tools + system prompt
tools = get_tools(registry)
catalog = await registry.get_skills_catalog(format="xml")
instructions = get_tools_usage_instructions()
system_prompt = f"{catalog}\n\n{instructions}"

Pass tools to your LangChain agent and inject system_prompt into the system message. The catalog tells the agent what skills exist; the usage instructions tell it how to use the tools.

Generated Tools

Tool	Parameters	Description
get_skill_metadata	skill_id	Get structured metadata (name, description, etc.)
get_skill_body	skill_id	Load the full markdown instructions
get_skill_reference	skill_id, name	Read a reference document
get_skill_script	skill_id, name	Read a script
get_skill_asset	skill_id, name	Read an asset

All tools are async-compatible (StructuredTool with coroutine).

API

get_tools(registry: SkillRegistry) -> list[StructuredTool]

Returns a list of LangChain structured tools bound to the given registry.

get_tools_usage_instructions() -> str

Returns a markdown string explaining the progressive-disclosure workflow — read metadata, then body, then fetch resources on demand. Designed for system-prompt injection alongside the skill catalog.

Example

See examples/langchain/ for a full working demo.

License

MIT