How to use skill-atoms

Read the catalog over HTTPS

Every artifact is served under stable URLs with correct content-types:

curl https://skill-atoms.com/exports/catalog.json
curl https://skill-atoms.com/atoms/skill/code-review.json
curl https://skill-atoms.com/skills/code-review.json
curl https://skill-atoms.com/schemas/composition-v1.json

Load a skill at runtime

A skill composition bundles the description, invocation contract, and prompt reference an agent needs to perform a bounded task. Load it on demand — no pre-registration required.

// pseudo-code
const skill = await fetch("/skills/code-review.json").then(r => r.json());
const contract = skill.references.invocation_contract;
const trustBoundary = skill.references.trust_boundary;

// Validate caller's inputs against the contract
validate(inputs, contract.input_schema);

// Invoke via the runtime
const result = await runtime.invoke(skill.id, inputs, { trust: trustBoundary });

Compatibility rules

Rules in /exports/catalog.json (under the rules key) declare predicates over atoms. Example: a skill with elevation: privileged requires an explicit trust-boundary grant. A composition that violates a require-effect rule is malformed.

Runtime consumers

v0.1 targets aish and Olympus. Framework adapters that translate skill-atoms into native skill registrations for other runtimes are v0.2 work.