Skip to content

Universal Skills

Universal Skills is a catalog of reusable agent capabilities. Atomic skills describe one capability; skill workflows contain only a dependency graph that composes atomic skills or exact MCP tools.

The catalog is intentionally split by ownership:

  • Cross-platform capabilities live under universal_skills/<domain>/.
  • Ordered or parallel compositions live under universal_skills/<domain>-workflows/.
  • Platform and package operations live with their provider under agent-packages/agents/<package>/<module>/skills/ and are discovered through the scion_sdk.connector entry point.

This prevents a universal skill from quietly depending on one deployment, service, or private filesystem layout.

Architecture Explorer

Open the Architecture Explorer to see where these skills sit in the ecosystem. It zooms from the whole runtime into each part and lists the spec rows that govern it.

Catalog review

The catalog has a checked-in, reproducible structural review:

Run the same audit locally:

python universal_skills/skills/skill-catalog-auditor/scripts/audit_catalog.py \
  universal_skills --format markdown

The audit excludes nested assets/ templates and generated skill_graphs/; those are package resources rather than installable catalog entries.

Install

pip install universal-skills
install-skills --all-detected --symlink

For an editable checkout:

pip install -e '.[test]'
install-skills --all-detected --symlink

Authoring

Use skill-builder for one atomic capability and skill-workflow-builder for a pure DAG. For ecosystem specifications, follow the contribution workflow and its links to the shared Spec Kit skills. Before proposing a change, run:

python scripts/check_atomicity.py --strict
pytest -q tests/test_workflows_compile.py
pre-commit run --all-files

The builders reject stale paths and generate only the resources explicitly requested.