Migrating Prompts to Puzzlet

Migrating your prompts to Puzzlet is easy.

​

Already Using AgentMark?

If your prompts are already in AgentMark format (.prompt.mdx), migration is simple:

1. Make sure you have a puzzlet account with a connected git repository
2. Run npx @puzzlet/cli@latest init if you haven’t already
3. Move your .prompt.mdx files into your puzzlet/templates directory
4. Commit and push your changes to the connected git branch

mv existing/*.prompt.mdx puzzlet/templates/
git commit -am "Migrate prompts to Puzzlet"
git push origin main

Now load prompts via our local CDN instead of the file system. See: Development

​

Migrating from Other Formats

If you’re migrating from other formats (like OpenAI’s chat completions), first convert your prompts to AgentMark format following the AgentMark Migration Guide, then move them to your puzzlet/templates directory.

​

Best Practices

1. Organize prompts in logical subdirectories within puzzlet/templates
2. Use consistent naming conventions for your prompt files
3. Test prompts after migration using our VSCode Extension