template-creator

Template Creator

Create or update a reference-backed template. Keep the source file inside the skill so later use can reproduce its structure, voice, and visual system precisely.

Routing

• Manage only personal skills under ${CODEX_HOME:-~/.codex}/skills.
• Create a new template by default. Use a numbered skill name instead of overwriting an existing template.
• Update only when the user explicitly asks to edit or update exactly one passed artifact-template skill. Treat that passed skill as the exact target; never choose a similarly named template.
• Do not modify an installed or bundled plugin cache. If the passed template is plugin-backed, explain that this skill can update only a personal template.
• Do not create, modify, upload, or publish a plugin. If the request also asks to share the template with a workspace, explain that this skill only manages personal templates.
• A gallery-backed template exists only after create-template-skill.mjs succeeds. Never hand-author, rename, or copy a normal skill and report it as an artifact template.

Create workflow

1. Require exactly one supported reference unless the user explicitly requests a batch. For a batch, complete this workflow separately for every reference:
   • Document: .docx
   • Presentation: .pptx
   • Spreadsheet: .xlsx
   • ImageGen or Product Design image: .png
   • Email or Slack message: .txt
   • When email or Slack content is pasted rather than attached, materialize the exact content as a temporary UTF-8 reference.txt without rewriting it.
2. Infer a concise display name and intended-use description from the reference and request. Infer document, presentation, spreadsheet, and image from the file extension. For an image, set its gallery kind to imagegen when the request originates from $imagegen, or product-design when it originates from @Product Design; ask which gallery should use the template when neither or both make the intended target clear. For .txt, determine whether the user requested email or slack; ask if the intended type is ambiguous.
3. Create preview.png before packaging:
   • DOCX: use Documents to render the reference and copy its first page PNG.
   • PPTX: use Presentations to render the reference and copy its first slide PNG.
   • XLSX: use Spreadsheets to render the used range of the first visible non-empty sheet.
   • PNG: copy the reference PNG unchanged.
   • Email or Slack: render a legible representative portion of the exact reference text on a neutral canvas. Do not paraphrase, decorate, or invent content.
4. Visually inspect the PNG. Stop if it is blank, clipped, corrupted, or not representative of the reference.
5. Do not create an intermediary request file or use a file-editing tool for script inputs. Set SKILL_DIR to the directory containing this SKILL.md, load the workspace dependency runtime, and pass the values directly. Before substituting real values into the command, shell-escape each value as one argument for the active shell. Never interpolate a raw path, display name, description, or skill name.