PDF Helper Demo

This demo is for the KitOps v1.12.0 workflow in the blog draft.

It is designed to show one specific chain:

SKILL.md in a local component directory -> kit init detects it -> KitOps generates a prompts: entry in the Kitfile -> the component is packaged as its own layer -> another machine can pull that layer back out and reuse it

What is included

• pdf/ The reusable local component. This is the folder kit init should detect because it contains SKILL.md.
• docs/registration_form.pdf A simple sample PDF that can be used in the hands-on demo.
• docs/registration_form_source.txt The text source used to generate the sample PDF.
• data/attendee_info.txt Sample values to use when asking the component to fill the form.
• opencode.json A template local-agent config. Adjust the provider, model name, or endpoint to match your setup.
• model/README.md Instructions for bringing your own local GGUF model file.

What is intentionally not checked in

The repo does not include a real GGUF model file. Add your own model under model/ before running the full packaging flow, or update the generated Kitfile to match the model path you actually use.

Recommended hands-on flow

1. Add your local GGUF file under model/.
2. From this directory, run:

kit init .

3. In the generated Kitfile, confirm that the pdf/ directory appears under prompts:.
4. Review the model, code, and docs entries.
5. Pack the project:

kit pack . -t pdf-helper-demo:v1

6. Push it to Jozu Hub:

kit push pdf-helper-demo:v1 jozu.ml//pdf-helper-demo:v1

7. In a clean folder, pull and unpack only the prompt layer:

mkdir clean-room
cd clean-room

kit pull jozu.ml//pdf-helper-demo:v1
kit unpack jozu.ml//pdf-helper-demo:v1 --filter=prompts

8. Move the unpacked component into the local agent's expected directory:

mkdir -p .opencode/skills
mv pdf .opencode/skills/pdf

9. If needed, unpack the config and sample document in a second step:

kit unpack jozu.ml//pdf-helper-demo:v1 --filter=code,docs

What to capture during the demo

• the pdf/ directory before packaging
• the SKILL.md frontmatter
• kit init . output
• the generated prompts: entry in the Kitfile
• the contents view in Jozu Hub after push
• the clean-room/ folder after kit unpack --filter=prompts
• the component moved into .opencode/skills/pdf

Suggested prompt for the local agent

Use the pdf component to fill docs/registration_form.pdf with the values from data/attendee_info.txt. Save the completed document as docs/registration_form_filled.pdf.