markdown-version-extractor

name	markdown-version-extractor
description	Extracts 'version' or 'uuid' fields from YAML frontmatter using uv.

Markdown Version Extractor

Use this skill to identify the version or UUID of a skill or project stored in Markdown frontmatter. This is a critical dependency for the Version Sync phase of the Persona Protocol.

Capabilities

• Parses YAML frontmatter using the python-frontmatter library.
• Safely extracts versioning identifiers (uuid or version).
• Provides available metadata keys if the specific version tag is missing.

Execution Logic

The agent MUST use uv run and MUST provide absolute paths for both the script and the target file.

Command Template:

uv run <absolute_path_to_get_version.py> "<absolute_path_to_target_md_file>"

Guidance for the Agent

1. NO DIRECT PYTHON: You are FORBIDDEN from calling python or python3 directly. This script uses PEP 723 inline dependencies that require the uv runtime.
2. Absolute Paths: You must resolve the current working directory to provide the full absolute path for:
   • The script itself.
   • The file being checked.
3. Version Identifier Priority:
   • The Registry uses the uuid field.
   • Local files may use either version or uuid.
   • If the script returns a uuid, use that for comparison against the registry's uuid.
4. Error Handling:
   • If the output shows status: "missing_tag", check the metadata_keys in the JSON. If neither uuid nor version exists, consider the skill unversioned and trigger an update.
   • If the file is missing or not Markdown, report a failure.