app-icon-template-creator
Use when one or more Apple app icon references, generated concepts, screenshots, SVGs, or icon packages need to become a reusable app-icon-gen style template.
How do I install this agent skill?
npx skills add https://github.com/xzhih/app-icon-skill --skill app-icon-template-creatorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The app-icon-template-creator skill is a structured tool for generating app icon templates. It is generally safe and uses a local script with well-known dependencies for validation. The primary security consideration is the inherent risk of indirect prompt injection when processing user-provided icon references to drive image generation tools.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
App Icon Template Creator
Create a reusable app-icon-gen style template from reference icon artwork. The goal is not to copy a source icon. The goal is to extract a transferable design language that can generate different app icons with a consistent style and then package cleanly through app-icon-gen.
REQUIRED SUB-SKILLS: Use app-icon-gen and an available raster image-generation skill such as imagegen or codex-image-gen. If either capability is unavailable before the workflow can run, report dependency_blocked; do not call the template complete. Use needs_package_verification only when those capabilities are available but the selected migration candidate has not yet passed the package flow.
Hard Contract
- Inspect supplied references before asking questions: image files, SVGs, existing
.iconbundles, generated concepts, screenshots, or project assets. - Use one working root for each template creation run:
<delivery>/tmp/work/. - Preserve the selected source reference as
<delivery>/<template-name>.origin.pngor<delivery>/<template-name>.origin.svg. - Record the current analysis in
<delivery>/tmp/work/reference-analysis.md. - Record each reconstruction prompt in
<delivery>/tmp/work/reconstruction-prompt-<n>.txt. - Save reconstruction outputs under
<delivery>/tmp/work/reconstruction-<n>.png. - Record each migration-test prompt in
<delivery>/tmp/work/migration-<n>-prompt.txt. - Save migration-test outputs under
<delivery>/tmp/work/migration-<n>.png. - Record reconstruction and migration decisions in
<delivery>/tmp/work/reconstruction-review.mdand<delivery>/tmp/work/migration-review.md. - Write the final candidate template to
<delivery>/<template-name>.md. - Keep the final candidate template compatible with
app-icon-gen/examples/semantic-image-prompts/: do not embed reconstruction or migration evidence sections in the final template. - Do not call the template complete until reconstruction, migration, and package-readiness gates have all been checked.
- Do not create a template that preserves a proprietary logo, exact mascot identity, unique brand mark, or exact source arrangement unless the user explicitly owns it and asks for a private template.
Workflow
- Choose a delivery folder and template slug. Use a short lowercase hyphenated slug such as
black-stage-pane-cluster. - Read
references/reference-analysis-protocol.mdand analyze the source icon through that lens. - Read
references/reconstruction-gates.md, then write a reconstruction prompt that should reproduce the source style without naming a reusable template yet. - Use the available raster image-generation skill to generate one or more reconstruction images from the prompt. When a source image is supplied, pass it as a style/reference image and label its role in the prompt.
- Compare source and reconstruction with visual inspection and, when useful,
app-icon-genreference comparison reports. Repair the analysis and prompt until the reconstruction is style-equivalent or the limitation is documented intmp/work/reconstruction-review.md. - Before extracting the template, show the reconstruction candidates to the user when the user is actively reviewing the run. Continue with the selected/accepted reconstruction; if no live review is available, record the agent's acceptance basis in
tmp/work/reconstruction-review.md. - Read
references/template-extraction.mdand extract the reusable style grammar from the successful reconstruction: fixed style constraints, variant axes, app-specific subject slots, conversion flow, and drift guards. - Read
references/migration-tests.md, then generate at least three migration tests for different app contexts. Use contexts that change the app metaphor while keeping the style family. - Show migration outputs to the user when the user is actively reviewing the run. Continue with selected/accepted candidates; if no live review is available, record the agent's acceptance basis in
tmp/work/migration-review.md. - Judge whether the migration outputs still feel like the same template. If they diverge, repair the template constraints before continuing.
- Read
references/template-output-format.md, then write the final candidate template Markdown file. - Run
npm --prefix <skill-dir>/scripts ci, thennpm --prefix <skill-dir>/scripts run template-lint -- <candidate-template.md>, resolving<skill-dir>to this skill's installed directory. - For at least one user-selected or accepted migration output, run the
app-icon-genpackage flow and verification. Use the candidate template's conversion flow as the route. If the package cannot become a complete candidate, revise the template.
Reference Routing
references/reference-analysis-protocol.md: always read first; defines the image-analysis lens.references/reconstruction-gates.md: read before using the available raster image-generation skill to reproduce the source style.references/template-extraction.md: read after a reconstruction is accepted.references/migration-tests.md: read before testing the draft template across multiple app concepts.references/template-output-format.md: read before writing or linting the final template.
Completion Gate
Complete only when all applicable checks are true:
- A source evidence file exists at the delivery root.
tmp/work/reference-analysis.mdexists and names the style invariants and drift risks.- At least one reconstruction output was generated and inspected.
tmp/work/reconstruction-review.mddocuments the accepted reconstruction, reviewer basis, and any non-template-critical differences.- At least three migration outputs were generated and inspected.
tmp/work/migration-review.mddocuments at least three migration concepts and whether each preserved the same design language while changing app-specific subject semantics.- The final template contains all required sections from
template-output-format.md. template-lintpasses.- At least one generated migration candidate has been packaged through
app-icon-genand reachedcomplete_candidate. If packaging cannot run, returnneeds_package_verificationinstead of completing the template.
Final response must include the delivery path, final template path, source evidence path, reconstruction outputs inspected, migration outputs inspected, template-lint result, package verification result, and any accepted limitations.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/xzhih/app-icon-skill/app-icon-template-creator">View app-icon-template-creator on skillZs</a>