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 thescion_sdk.connectorentry 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:
- Skill catalog audit lists every canonical skill and its current structural or routing findings.
- Improvement roadmap explains category-level priorities, missing capabilities, package ownership, and proposed pure workflows.
- Architecture overview defines the skill and workflow contracts.
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¶
For an editable checkout:
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.