Metadata-Version: 2.4
Name: langchain-ai-skills-framework
Version: 1.0.78
Summary: ai-skills-framework
Author-email: Imran Qureshi <imran.qureshi@bwell.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/icanbwell/ai-skills
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: pydantic<3.0.0,>=2.0
Requires-Dist: fsspec>=2026.2.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: simple-container>=1.0.2
Requires-Dist: skillkit>=0.4.0
Requires-Dist: aiofiles>=25.1.0
Requires-Dist: uv>=0.11.0
Requires-Dist: anyio>=4.12.1
Requires-Dist: motor>=3.7.1
Requires-Dist: skills-ref>=0.1.1
Requires-Dist: py-key-value-aio>=0.4.4
Provides-Extra: langchain
Requires-Dist: langchain-core>=1.0.0; extra == "langchain"
Requires-Dist: langchain>=1.0.0; extra == "langchain"
Requires-Dist: langgraph>=0.2.0; extra == "langchain"
Dynamic: license-file

# langchain-ai-skills-framework

## Overview
- langchain-ai-skills-framework loads Agent Skills from `SKILL.md` files and serves them via LangChain tools.
- Skills come from two sources:
  - **Plugin marketplace** (`MarketplaceDirectoryLoader`) — shared skills loaded from filesystem or GitHub, organized as `plugins/<plugin>/skills/<skill>/SKILL.md`.
  - **User-persisted skills** (`MongoPluginSkillLoader`) — stored in MongoDB across three collections (`plugin_skills`, `plugin_references`, `plugin_scripts`).
- `CompositeSkillLoader` merges both sources with precedence: user → shared DB → marketplace.
- All skill tools are scoped by `plugin_name`.

## Skill authoring
- See `docs/skill-authoring.md` for required frontmatter, naming rules, and examples.

## GitHub authentication for remote plugins
- When `PLUGINS_MARKETPLACE` uses `github://...`, provide a token via `SKILLS_GITHUB_TOKEN` (preferred) or `GITHUB_TOKEN` (fallback).
- Expected GitHub directory format: `github://<owner>/<repo>/<path>?ref=<branch>` (for example: `github://my-org/ai-plugin-marketplace/plugins?ref=main`).
- Supported token types: fine-grained Personal Access Token (PAT) and GitHub App installation token.
- Recommended usage:
  - Local development: fine-grained PAT scoped to the required repositories.
  - CI (GitHub Actions): workflow `GITHUB_TOKEN` when permissions are sufficient.
  - Long-running services: short-lived GitHub App installation tokens.

## Quick start
- `make init` – initialize the local dev environment.
- `make up` – start the dev container.
- `make run-pre-commit` – run lint/type/security suite.
- `make tests` – run dockerized pytest.
- `make build` – build sdist/wheel packages.
