Explain MTHDS bundles
Analyze and explain existing MTHDS method bundles in plain language.
This skill is read-only: it reads a bundle and explains it. It never modifies the .mthds file.
Process
Step 1: Read the .mthds File
Read the entire bundle file to understand its structure.
Step 2: Identify Components
List all components found in the bundle:
- Domain: the top-level
domainkey (bundle header, not a[domain]section) - Concepts: all
[concept.*]blocks — note which are custom vs references to native concepts - Pipes: all
[pipe.*]blocks — identify the main pipe and sub-pipes - Main pipe: the top-level
main_pipekey (bundle header, not a[bundle]section)
Step 3: Trace Execution Flow
Starting from the main pipe, trace the execution path:
- For PipeSequence: follow the
stepsarray in order - For PipeBatch: identify
batch_overandbatch_as, then the inner pipe - For PipeParallel: list all branches
- For PipeCondition: map condition → pipe for each branch
- For PipeLLM / PipeExtract / PipeImgGen / PipeSearch / PipeFunc: these are leaf operations
Step 4: Present Explanation
Structure the explanation as:
- Purpose: one-sentence summary of what the method does
- Inputs: list each input with its concept type and expected content
- Output: the final output concept and what it contains
- Step-by-step flow: walk through execution in order, explaining what each pipe does
- Key concepts: explain any custom concepts defined in the bundle
Step 5: Generate Flow Diagram
Create a text diagram showing the execution flow. Example:
main_sequence
1. step_one (PipeLLM) -> intermediate_result
2. step_two (PipeExtract) -> final_output
Inputs: input_a, input_b
Output: final_output
Adapt the format to the method structure (linear, branching, batched).
Reference
- MTHDS Language Reference — read for concept definitions and syntax
- Native Content Types — read when explaining what data flows through pipes (e.g., what attributes Page or Image content carries)