Guizang Ppt Skill

name: Feature request
description: Suggest a new layout, workflow, platform, or capability.
title: "feat: "
labels: ["enhancement"]
body:
  - type: textarea
    id: problem
    attributes:
      label: What problem would this solve?
      description: Please describe the real deck-making situation behind the request.
      placeholder: "When making product benchmark decks, I often need..."
    validations:
      required: true
  - type: textarea
    id: proposal
    attributes:
      label: What do you want the Skill to do?
      placeholder: "Add a layout for..."
    validations:
      required: true
  - type: textarea
    id: examples
    attributes:
      label: Examples or references
      description: Screenshots, links, rough sketches, or deck examples are welcome.
  - type: dropdown
    id: area
    attributes:
      label: Area
      options:
        - Layout / template
        - Image generation workflow
        - Data visualization
        - Installation / packaging
        - Documentation
        - Runtime interaction
        - Other
    validations:
      required: true


# Contributing

Thanks for helping improve `guizang-ppt-skill`.

This project is a Skill for AI agents that generate polished HTML slide decks. The most useful contributions are specific, reproducible, and tied to real deck output.

## Before Opening an Issue

Please check whether the problem belongs to one of these buckets:

- Layout fidelity: a page drifts away from the registered template.
- Content overflow: text, images, charts, or footers overlap.
- Image workflow: generated images do not match the target slot ratio or deck style.
- Runtime behavior: navigation, ESC overview, low-power mode, map interaction, or animations fail.
- Documentation: installation, prompt usage, layout selection, or examples are unclear.

Screenshots are much more useful than descriptions alone. If possible, include:

- The prompt or source content used to generate the deck.
- The generated `index.html`.
- A screenshot of the broken slide.
- Browser and OS information.

## Pull Request Guidelines

Keep PRs focused. A small fix with a screenshot is easier to review than a large rewrite.

For Swiss theme changes:

- Do not invent new default body layouts unless the change is explicitly discussed.
- Keep the registered layout system intact.
- Run the Swiss validator:

```bash
node scripts/validate-swiss-deck.mjs path/to/index.html
```

For template changes:

- Verify at least one dense text slide.
- Verify at least one image slide.
- Verify navigation, ESC overview, and low-power mode.

## Good PRs Usually Include

- A short summary of the problem.
- The exact files changed.
- Before / after screenshots when visual behavior changes.
- Validation or manual QA notes.

## Style Notes

This Skill is opinionated by design. It prefers constrained layout systems over unlimited customization, because constraints make AI-generated decks more reliable.

When in doubt, preserve the existing visual rules and improve the workflow around them.


blank_issues_enabled: true
contact_links:
  - name: Read the README
    url: https://github.com/op7418/guizang-ppt-skill#readme
    about: Start here for installation and usage.
  - name: English README
    url: https://github.com/op7418/guizang-ppt-skill/blob/main/README.en.md
    about: English installation and usage notes.


name: Bug report
description: Report a reproducible layout, rendering, or workflow bug.
title: "bug: "
labels: ["bug"]
body:
  - type: markdown
    attributes:
      value: |
        Thanks for reporting a bug. Screenshots and the generated HTML are the fastest way to make this actionable.
  - type: textarea
    id: summary
    attributes:
      label: What happened?
      description: Describe the issue clearly.
      placeholder: "The footer overlaps the final card on slide 6..."
    validations:
      required: true
  - type: textarea
    id: expected
    attributes:
      label: What did you expect?
      placeho