SciTeX Skills (`scitex-skills`)
Reusable AI agent skills for the SciTeX ecosystem, enabling efficient scientific research automation.
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> ·
<a href="https://scitex.ai">scitex.ai</a> ·
<code>pip install scitex-skills</code>
</p>
Part of the SciTeX 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
Skill Packages
| Package | Skills | Description |
|---|---|---|
| crossref-local | 17 | Local CrossRef database (167M+ papers) |
| figrecipe | 12 | Publication-ready matplotlib figures |
| general | 17 | Ecosystem-wide standards and conventions |
| scitex-app | 9 | Runtime SDK for custom research apps |
| scitex-audio | 7 | Text-to-speech and audio processing |
| scitex-clew | 5 | SHA-256 hash-chain provenance verification |
| scitex-container | 6 | Container management for HPC (Apptainer/Docker) |
| scitex-dataset | 5 | Scientific datasets (DANDI, OpenNeuro, PhysioNet) |
| scitex-dev | 11 | Developer tools and ecosystem management |
| scitex-io | 9 | Universal file I/O (30+ formats) |
| scitex-linter | 5 | Code convention checker with pluggable rules |
| scitex-stats | 7 | Publication-ready statistics (23+ tests) |
| scitex-tunnel | 6 | SSH reverse tunnels for NAT traversal |
| scitex-ui | 7 | Workspace shell framework and UI components |
| scitex-writer | 18 | LaTeX manuscript compilation |
Installation
pip install scitex-skills
Skills are bundled as package data. AI agents and tools can query them programmatically:
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:
- Installs
scitex-devfrom PyPI - Calls
export_skills(source="pypi")to download all SciTeX wheels - Extracts
_skills/Markdown files from each wheel - Commits any changes to
skills/
Manual Update
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
- Local: See the
skills/directory
To build the docs locally:
pip install mkdocs
mkdocs serve
Contributing
Skill pages are auto-generated from each SciTeX package. To contribute:
- Add or edit
_skills/*.mdfiles in the source package (e.g.,scitex-io,figrecipe) - Release a new version of that package to PyPI
- The daily workflow will pick up the changes automatically
For ecosystem-wide standards, edit files under skills/scitex/general/.
License
AGPL-3.0 -- see LICENSE for details.
Part of SciTeX
scitex-skills is part of SciTeX -- a Python framework for scientific research automation.