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.