Metadata-Version: 2.4
Name: skillgarden
Version: 0.0.1
Summary: A portable, index-now-load-later runtime for agent skills.
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# SkillGarden (Python)

Ported line-for-line from the TypeScript implementation. See the
[root README](../README.md) for the pitch, the prior-art landscape, and
the scope decisions — this file only covers what's specific to running
the Python code.

## Install

```bash
pip install -e ".[dev]"
```

## Quickstart

```bash
PYTHONPATH=src python3 examples/quickstart.py
```

```python
from skillgarden import SkillGarden

garden = SkillGarden(dirs=["examples/skills"])
result = garden.build_index()

print(garden.invoke("greet", "world"))
# -> "Hello, world!"

eligible = garden.eligible_for(result.included, ["apps/web/index.tsx"])
# -> includes "deploy:web", since its `paths` glob matches
```

## Test

```bash
pytest
```

## Status

Loader, budget-aware index, directory discovery with colon-namespacing,
and path-conditional activation are real and tested. Not yet published to
PyPI.
