Metadata-Version: 2.4
Name: skills-ref-rs
Version: 0.3.3
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Dist: click>=8.0
Summary: Validate and manage Agent Skill definitions (SKILL.md frontmatter) – Rust core with Python bindings via PyO3
Keywords: agent,skills,skill-validate,frontmatter
Author-email: me-v2 <hi@me-v2.com>
License-Expression: Apache-2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/me-v2/skills-ref-rs
Project-URL: Issues, https://github.com/me-v2/skills-ref-rs/issues
Project-URL: Repository, https://github.com/me-v2/skills-ref-rs

# skills-ref-rs

[![CI](https://github.com/me-v2/skills-ref-rs/actions/workflows/ci-skills-ref-rs.yml/badge.svg)](https://github.com/me-v2/skills-ref-rs/actions/workflows/ci-skills-ref-rs.yml)

Reference library for Agent Skills – Rust core with Python bindings via PyO3.

This is a Rust reimplementation of [agentskills](https://github.com/agentskills/agentskills), distributed as a PyPI package built with [maturin](https://github.com/PyO3/maturin) and [PyO3](https://pyo3.rs).

## Installation

```bash
pip install skills-ref-rs
```

## Usage

```python
from skills_ref_rs import read_properties, validate, to_prompt

# Read skill properties
props = read_properties("path/to/skill-dir")
print(props.name, props.description)

# Validate a skill directory
errors = validate("path/to/skill-dir")

# Generate XML prompt block
xml = to_prompt(["path/to/skill-a", "path/to/skill-b"])
```

## CLI

```bash
skills-ref validate path/to/skill-dir
skills-ref read-properties path/to/skill-dir
skills-ref to-prompt path/to/skill-a path/to/skill-b
```


## Acknowledgments

This project is based on the [agentskills](https://github.com/agentskills/agentskills) standard.

Special thanks to the [agentskills](https://github.com/agentskills/agentskills) repository.

