scitex-skills

# SciTeX Skills (`scitex-skills`)

<p align="center">
  <a href="https://scitex.ai">
    <img src="docs/scitex-logo-blue-cropped.png" alt="SciTeX" width="400">
  </a>
</p>

<p align="center"><b>Reusable AI agent skills for Claude Code and the SciTeX ecosystem</b></p>

<p align="center">
  <a href="https://badge.fury.io/py/scitex-skills"><img src="https://badge.fury.io/py/scitex-skills.svg" alt="PyPI version"></a>
  <a href="https://pypi.org/project/scitex-skills/"><img src="https://img.shields.io/pypi/pyversions/scitex-skills.svg" alt="Python Versions"></a>
  <a href="https://scitex-skills.readthedocs.io/"><img src="https://readthedocs.org/projects/scitex-skills/badge/?version=latest" alt="Documentation"></a>
  <a href="https://www.gnu.org/licenses/agpl-3.0"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg" alt="License: AGPL-3.0"></a>
</p>

<p align="center">
  <a href="https://scitex-skills.readthedocs.io/">Docs</a> &middot;
  <a href="https://scitex.ai">scitex.ai</a> &middot;
  <code>pip install scitex-skills</code>
</p>

---

Part of the [**SciTeX**](https://scitex.ai) ecosystem -- structured skill pages that help AI agents (Claude Code, MCP clients) discover and use SciTeX packages. Each skill is a focused Markdown document covering one capability -- API signatures, CLI commands, MCP tools, and usage patterns -- so agents can look up exactly what they need without reading source code.

## Features

- **130 skill pages** across 15 packages -- from statistics to manuscript compilation
- **Auto-updated daily** from PyPI via GitHub Actions -- always in sync with released versions
- **Four-interface coverage** -- every skill documents Python API, CLI, MCP tools, and skill discovery
- **Structured for AI agents** -- concise, machine-readable Markdown with frontmatter metadata
- **Browsable documentation** -- hosted on [Read the Docs](https://scitex-skills.readthedocs.io/)

## Skill Packages

| Package | Skills | Description |
|---------|--------|-------------|
| [crossref-local](skills/scitex/crossref-local/) | 17 | Local CrossRef database (167M+ papers) |
| [figrecipe](skills/scitex/figrecipe/) | 12 | Publication-ready matplotlib figures |
| [general](skills/scitex/general/) | 17 | Ecosystem-wide standards and conventions |
| [scitex-app](skills/scitex/scitex-app/) | 9 | Runtime SDK for custom research apps |
| [scitex-audio](skills/scitex/scitex-audio/) | 7 | Text-to-speech and audio processing |
| [scitex-clew](skills/scitex/scitex-clew/) | 5 | SHA-256 hash-chain provenance verification |
| [scitex-container](skills/scitex/scitex-container/) | 6 | Container management for HPC (Apptainer/Docker) |
| [scitex-dataset](skills/scitex/scitex-dataset/) | 5 | Scientific datasets (DANDI, OpenNeuro, PhysioNet) |
| [scitex-dev](skills/scitex/scitex-dev/) | 11 | Developer tools and ecosystem management |
| [scitex-io](skills/scitex/scitex-io/) | 9 | Universal file I/O (30+ formats) |
| [scitex-linter](skills/scitex/scitex-linter/) | 5 | Code convention checker with pluggable rules |
| [scitex-stats](skills/scitex/scitex-stats/) | 7 | Publication-ready statistics (23+ tests) |
| [scitex-tunnel](skills/scitex/scitex-tunnel/) | 6 | SSH reverse tunnels for NAT traversal |
| [scitex-ui](skills/scitex/scitex-ui/) | 7 | Workspace shell framework and UI components |
| [scitex-writer](skills/scitex/scitex-writer/) | 18 | LaTeX manuscript compilation |

## Installation

```bash
pip install scitex-skills
```

Skills are bundled as package data. AI agents and tools can query them programmatically:

```python
from scitex_skills import get_skill, list_skills

# List all available skills
skills = list_skills()

# Get a specific skill page
content = get_skill("scitex-io/save-and-load")
```

## How It Works

A daily GitHub Actions workflow keeps skills in sync with released packages:

1. Installs `scitex-dev` from PyPI
2. Calls `export_skills(source="pypi")` to download all SciTeX wheels
3. Extracts `_skills/` Markdown files from each wheel
4. Commits any changes to `skills/`

## Manual Update

```bash
pip install scitex-dev
python -c "from pathlib import Path; from scitex_dev.skills import export_skills; export_skills(source='pypi', dest=Path('skills'))"
```

## Browse Skills

- **Online**: [scitex-skills.readthedocs.io](https://scitex-skills.readthedocs.io/)
- **Local**: See the [`skills/`](skills/) directory

To build the docs locally:

```bash
pip install mkdocs
mkdocs serve
```

## Contributing

Skill pages are auto-generated from each SciTeX package. To contribute:

1. Add or edit `_skills/*.md` files in the source package (e.g., `scitex-io`, `figrecipe`)
2. Release a new version of that package to PyPI
3. The daily workflow will pick up the changes automatically

For ecosystem-wide standards, edit files under [`skills/scitex/general/`](skills/scitex/general/).

## License

AGPL-3.0 -- see [LICENSE](LICENSE) for details.

## Part of SciTeX

`scitex-skills` is part of [**SciTeX**](https://scitex.ai) -- a Python framework for scientific research automation.

<p align="center">
  <a href="https://scitex.ai"><img src="docs/scitex-icon-navy-inverted.png" alt="SciTeX" width="40"/></a>
</p>

<!-- EOF -->