Skip to main content

aip-spec

The Agent Instruction Protocol format as a Python package: the pydantic models that define a procedure, the validator (aip-spec validate), the JSON Schema generated from the models (aip-spec schema), the runtime block every skill carries (aip-spec runtime), and the commands that copy the authoring skill and the bundled example out of an install (aip-spec skill install, aip-spec example).

The format is specified in docs/specification.md: the skill folder, the SKILL.md frontmatter and body, the procedure's data model and its YAML, the state rules, the type vocabulary, and everything the validator checks. The pydantic models in src/aip_spec/models.py are the source of truth; the JSON Schema is generated from them.

This is a workspace member of zach-blumenfeld/aip; the repository's README covers installation and the walkthrough. The files the wheel bundles live once, at the repository root: the aip-compile skill at skills/aip-compile/ and the example at examples/billing-support/.

aip_spec imports only pydantic and pyyaml:

from aip_spec import validate_skill, ProcedureSpec, json_schema, runtime_text, example_dir, skill_dir

loaded, issues = validate_skill("./billing-support")   # LoadedSkill | None, list[Issue]

Tests run from the repository root with uv run pytest -q, which covers both packages.

Metadata

Release files for aip-spec 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aip-spec 0.7.0
File Size Uploaded Provenance Actions
aip_spec-0.7.0.tar.gz 62.8 kB With provenance Details for aip_spec-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aip-spec 0.7.0
File Interpreter ABI Platform Actions
aip_spec-0.7.0-py3-none-any.whl Python 3 none any Details for aip_spec-0.7.0-py3-none-any.whl

Total release size: 123.0 kB

Release files / aip_spec-0.7.0.tar.gz

Download URL aip_spec-0.7.0.tar.gz
Size 62.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ee4df9c8e045d6bd85eb0fb0f692d6882f3d7388ddd60ab4e16e068f9fed566a
BLAKE2b-256 checksum
How to use checksums
0d07e150a367e7ef35ac3c7d94a9979ff9c5c585bda5a1332b3973b61b0c758a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / aip_spec-0.7.0-py3-none-any.whl

Download URL aip_spec-0.7.0-py3-none-any.whl
Size 60.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
53b74039899a145805643a216ec3bc24eb8c5c98d1283219f396fdf0ef832920
BLAKE2b-256 checksum
How to use checksums
1a5e0ba1d70747a4285f455a0d8b944a5800e790ba5b4c2629a9ec41c81c4f5e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for aip-spec 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aip_spec-0.7.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.7.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page