Architecture Intermediate 2 minute read Updated 2026-06-26 UTC

Skill manifest schema

A production-oriented manifest shape for small interchangeable model packages and their contracts.

Research statusImplementation pattern Publication statePublished Reviewed byMichael Kappel Source reports3

Purpose

A model-breeding system needs a common package format before it can safely create descendants. The manifest is the contract between the model package, router, evaluator, registry, release system, and human reviewer.

Minimum manifest sections

SectionPurpose
Identityunique package id, version, digest, owner
Lineageparents, operators, datasets, teacher models
Capability contractinput schema, output schema, task tags, abstention rules
Runtimeengine, hardware, memory, quantization, dependencies
Permissionstools, network, filesystem, credentials, data access
Evaluationsuites, scorecards, calibration, failure slices
Safetyrisk tier, hard gates, red-team findings, policy notes
Lifecyclecandidate, shadow, canary, champion, archived, retired

Pseudocode object

pseudocode
RECORD SkillManifest
    package_id
    package_version
    artifact_digest
    created_at_utc
    owner

    lineage:
        parent_package_ids
        variation_operator
        operator_config_digest
        data_sources
        teacher_models

    contract:
        input_schema
        output_schema
        task_tags
        confidence_field
        abstention_policy
        escalation_policy

    runtime:
        engine
        model_format
        tokenizer
        quantization
        memory_mb
        p95_latency_ms
        supported_hardware

    permissions:
        network
        filesystem
        tools
        credentials
        data_jurisdictions

    evaluation:
        suite_version
        scorecard_digest
        calibration_report
        known_failure_slices

    lifecycle:
        state
        rollback_target
        approval_record
END RECORD

Manifest validation gate

pseudocode
FUNCTION validate_manifest(manifest, policy)
    REQUIRE manifest.artifact_digest MATCHES HASH(manifest.artifacts)
    REQUIRE manifest.contract.input_schema IS VALID
    REQUIRE manifest.contract.output_schema IS VALID
    REQUIRE manifest.lifecycle.rollback_target EXISTS OR manifest.lifecycle.state == "candidate"
    REQUIRE manifest.permissions WITHIN policy.allowed_permissions
    REQUIRE manifest.evaluation.suite_version IN policy.approved_suites
    RETURN PASS
END FUNCTION

Why this matters

Interchangeability starts at the contract layer. Weight compatibility is optional and rare. Behavioral and operational compatibility are mandatory. A good manifest lets the ecology route, compare, replace, and retire modules without understanding every internal implementation detail.

Source reports used for this guide

These reports are preserved verbatim in the site archive. The guide above is an editorial synthesis and may narrow, qualify, or reorganize claims from the source material.