SciTeX Skills (scitex-skills)

Aggregated AI-agent skill pages for the SciTeX ecosystem — 230+ markdown trigger pages, hourly auto-refreshed from PyPI wheels.

Docs · scitex.ai · pip install scitex-skills

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.

Problem and Solution

Features

• 130+ skill pages across 15+ packages -- from statistics to manuscript compilation
• Auto-updated hourly from PyPI via GitHub Actions -- always ≤60 min behind 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

233 skill pages across 32 packages (regenerated hourly from PyPI wheels)

Installation

pip install scitex-skills

1 Interfaces

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

An hourly 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

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:

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 hourly workflow will pick up the changes automatically (within 60 min)

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. Install via the umbrella with pip install scitex[skills] to use as scitex.skills (Python) or scitex skills ... (CLI).

Four Freedoms for Research

1. The freedom to run your research anywhere — your machine, your terms.
2. The freedom to study how every step works — from raw data to final manuscript.
3. The freedom to redistribute your workflows, not just your papers.
4. The freedom to modify any module and share improvements with the community.

AGPL-3.0 — because we believe research infrastructure deserves the same freedoms as the software it runs on.