AI Skill: Validate OKF Bundles with Python Checker

AI Skill: Validate OKF Bundles with Python Checker

This AI skill assists software developers in verifying the conformance of Open Knowledge Format (OKF) bundles to version 0.2 specifications by using a deterministic Python checker. It is designed for automated syntax validation, linting, and migration of OKF bundles from version 0.1 to version 0.2.

What this skill does

• Runs a deterministic conformance checker against a specified OKF bundle to ensure it adheres to §11 of the OKF v0.2 specification.
• Defaults to checking the project's .okf/ directory if no specific path is provided.
• Allows migration of OKF v0.1 bundles to v0.2 using the --migrate option, modifying the bundle in place.
• Handles errors such as unparseable frontmatter, missing or empty type declarations, and unreadable files.
• Reports errors for files like AGENTS.md or README.md within the bundle root that lack the required frontmatter.

Who it is for

• Developers and development teams using AI coding agents such as Claude Code, Cursor, and Codex who manage and work with OKF bundles.
• Organisations seeking to improve the accuracy and consistency of their OKF bundle management.

Use cases

• Validating OKF bundles before committing changes to ensure they meet the latest specification standards.
• Automating the linting process in a continuous integration pipeline to maintain compliance.
• Updating projects to ensure backward compatibility with older versions of OKF bundles.
• Integrating with existing workflows to reduce manual validation efforts.

Technical details

• Uses Python and requires the pyyaml library for processing YAML frontmatter.
• The skill operates through a script located in the ${CLAUDE_SKILL_DIR}/scripts/ directory and can be executed with the following commands:
  • Via the uv command: uv run "${CLAUDE_SKILL_DIR}/scripts/okf_validate.py" $ARGUMENTS
  • If uv is not available, using Python directly: python3 -m pip install --quiet pyyaml && \ python3 "${CLAUDE_SKILL_DIR}/scripts/okf_validate.py" $ARGUMENTS
• Seamlessly available alongside the skill, whether it is installed as part of the okf plugin or standalone via tools such as npx skills add.

Source & Licence

This package is built on open-source work published by scaccogatto (scaccogatto/okf-skills) and distributed under MIT. The original licence text and copyright notice are included in your download.

Personal and commercial use, modification and redistribution are permitted, provided the original copyright and licence notice are retained.

Your purchase covers curation, licence verification, packaging, documentation and instant delivery. It does not grant exclusive rights to the underlying open-source code, which remains available under its original licence.

Delivery & Support

• Delivery: instant — a secure download link is emailed to you as soon as payment is confirmed.
• Format: ZIP archive containing the skill files, documentation and the original licence.
• Support: support@mcpcart.com — we aim to reply within 2 business days.
• Updates: updates are included only where stated on this page.

Refunds

This is a digital product delivered immediately after purchase. By completing your order you request immediate delivery and acknowledge that, once the download has been accessed, the statutory right to cancel no longer applies to the extent permitted by law. Refund requests are handled in accordance with our published Refund Policy.

Claude, Codex, Gemini and Cursor are trademarks of their respective owners. MCP Cart is an independent marketplace and is not affiliated with, endorsed by, or sponsored by any of them. Compatibility references describe interoperability only.