Metadata-Version: 2.4
Name: skillvault
Version: 0.1.1
Summary: Agent Skill Management System with self-growth capabilities
Project-URL: Homepage, https://github.com/yourusername/skillvault
Project-URL: Documentation, https://github.com/yourusername/skillvault#readme
Project-URL: Repository, https://github.com/yourusername/skillvault.git
Project-URL: Issues, https://github.com/yourusername/skillvault/issues
License: MIT
License-File: LICENSE
Keywords: agent,ai,knowledge-management,llm,skill,sqlite,vector-search
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: click>=8.0.0
Requires-Dist: openai>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: sqlite-vec>=0.1.0
Requires-Dist: tiktoken>=0.5.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: local-embed
Requires-Dist: sentence-transformers>=2.0.0; extra == 'local-embed'
Description-Content-Type: text/markdown

# Skill Manager

[![PyPI](https://img.shields.io/pypi/v/skillvault)](https://pypi.org/project/skillvault/)

Agent Skill Management System with self-growth capabilities.

Published on PyPI: **https://pypi.org/project/skillvault/**

## Features

- **Skill Storage**: SQLite + sqlite-vec for local storage with vector search
- **Semantic Query**: ANN retrieval + dependency expansion + token budget cropping
- **Self-Growth**: Automatically extract knowledge from conversations and tasks
- **Human-in-the-Loop**: Review queue for approving/rejecting draft skills
- **Permission Separation**: Agent code can only write drafts, humans control canonical
- **CLI Tool**: Command-line interface for skill management

## Installation

```bash
pip install skillvault
```

## Quick Start

```python
from skillvault import SkillManager
from skillvault.models import Skill, Chunk

# Initialize
sm = SkillManager("skills.db")

# Register a skill
skill = Skill(
    id="frontend-react",
    name="Frontend React",
    chunks=[
        Chunk(
            id="frontend-react::hooks",
            skill_id="frontend-react",
            section="React Hooks",
            content="## useEffect\n\nUse useEffect for side effects...",
            tokens=50,
        )
    ]
)
sm.register(skill)

# Query skills
context = sm.query("React hooks best practices", budget=2000)
print(context)

# Extract knowledge from conversation
draft_id = sm.extract(messages)

# Review queue
pending = sm.review_queue()

# Approve draft
sm.approve(draft_id)
```

## CLI Usage

```bash
# List skills
skill-cli list

# Review queue
skill-cli review-queue

# Approve/reject
skill-cli approve draft::skill-id
skill-cli reject draft::skill-id --reason "Not useful"

# Export/Import
skill-cli export frontend-react > react.json
skill-cli import react.json

# Statistics
skill-cli stats
```

## Architecture

```
Agent Code (Python)
    │
    ├── query()          → Read canonical skills
    ├── extract()        → Write draft skills
    │
Human (CLI)
    │
    ├── register()       → Write canonical skills
    ├── approve()        → Promote draft → canonical
    ├── reject()         → Archive draft
    └── delete()         → Remove skill
    │
SkillManager
    │
    ├── Storage (SQLite + sqlite-vec)
    ├── Query Engine (ANN + Dependencies + Budget)
    ├── Growth Engine (LLM extraction)
    └── Review System (Approve/Reject)
```

## Development

```bash
# Install dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run CLI
skill-cli --help
```

## License

MIT
