Check MTHDS bundles

Process

Step 0 — CLI Check (mandatory, do this FIRST)

mthds-agent --version

• If it succeeds: proceed to the next step.
• If it fails or the command is not found: STOP. Do not proceed with this skill. Tell the user:

The

mthds-agent

CLI is required but not installed. Install it with:

npm install -g mthds

Then re-run this skill.

.mthds

1. Read the .mthds file — Load and parse the method
2. Run CLI validation (use

   -L

   pointing to the bundle's own directory to avoid namespace collisions):
   bash

   mthds-agent pipelex validate pipe <file>.mthds -L <bundle-directory>/

3. Parse the JSON output:
   • If

     success: true

     — all pipes validated, report clean status
   • If error — see Error Handling Reference for error types and recovery
4. Cross-domain validation — when the bundle references pipes from other domains, use

   --library-dir

   (see Error Handling — Cross-Domain)
5. Analyze for additional issues (manual review beyond CLI validation):
   • Unused concepts (defined but never referenced)
   • Unreachable pipes (not in main_pipe execution path)
   • Missing descriptions on pipes or concepts
   • Inconsistent naming conventions
   • Potential prompt issues (missing variables, unclear instructions)
6. Report findings by severity:
   • Errors: Validation failures from CLI (with

     error_type

     and

     pipe_code

     )
   • Warnings: Issues that may cause problems (e.g., model availability)
   • Suggestions: Improvements for maintainability
7. Do NOT make changes — This skill is read-only

What Gets Checked

• TOML syntax validity
• Concept definitions and references
• Pipe type configurations
• Input/output type matching
• Variable references in prompts
• Cross-domain references
• Naming convention compliance
• Model preset resolution (dry run)

Reference

• Error Handling — read when CLI returns an error to determine recovery
• MTHDS Agent Guide — read for CLI command syntax or output format details
• MTHDS Language Reference — read when reviewing .mthds TOML syntax
• Native Content Types — read when checking

  $var.field

  references in prompts to verify the attribute exists on the content type