Skip to content

feat: add pptify plugin#1826

Open
kimtth wants to merge 5 commits into
github:stagedfrom
kimtth:add-pptify-plugin
Open

feat: add pptify plugin#1826
kimtth wants to merge 5 commits into
github:stagedfrom
kimtth:add-pptify-plugin

Conversation

@kimtth
Copy link
Copy Markdown

@kimtth kimtth commented May 25, 2026

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the staged branch for this pull request.

Description

Adds the pptify plugin for creating PowerPoint presentations from structured slide specifications.

PPTify includes a generated .agent runtime bundle with:

  • PPTX generation tooling
  • design context
  • deck-generation workflow
  • Copilot instructions
  • policy guidance
  • six runtime skills for context preparation, slide spec creation, deck generation, tooling, visual assets, and quality gates

The plugin source is maintained externally at:

https://github.com/kimtth/agent-pptify-kit

The submitted artifact was generated from that toolkit using its deploy artifact script and includes the runtime needed to create .pptx files, not only skill definitions.

Validation completed locally:

npm run plugin:validate
npm run build

Both commands completed successfully, and pptify was validated as a plugin.


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • Update to existing instruction, prompt, agent, plugin, skill, or workflow.
  • Other (please specify):

Additional Notes

  • The PR base branch has been updated from main to staged.
  • This plugin intentionally includes the .agent runtime artifact because the skills alone cannot create PowerPoint files.
  • Sample: pptify-kit-stress-demo.pptx — dense and intentionally overcomplicated layout used for stress testing PPTify output quality.
  • Optional image generation uses user-provided OpenAI or Azure OpenAI credentials via .env; no credentials are included in this submission.

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct (../CODE_OF_CONDUCT.md) and will be licensed under the MIT License.

 Add PPTify as an Awesome Copilot plugin with the full generated runtime artifact, including the .agent bundle, PPTX generation tools, design context, workflow, policy, instructions, and runtime skills.

 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@kimtth kimtth requested a review from aaronpowell as a code owner May 25, 2026 07:29
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ This PR targets main, but PRs should target staged.

The main branch is auto-published from staged and should not receive direct PRs.
Please close this PR and re-open it against the staged branch.

You can change the base branch using the Edit button at the top of this PR,
or run: gh pr edit 1826 --base staged

@github-actions github-actions Bot added new-submission PR adds at least one new contribution plugin PR touches plugins targets-main PR targets main instead of staged labels May 25, 2026
@kimtth kimtth changed the base branch from main to staged May 25, 2026 07:34
@github-actions github-actions Bot removed the targets-main PR targets main instead of staged label May 25, 2026
Copy link
Copy Markdown
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The structure does not match the repo design, please review how the repo is structured or consider submitting it as an external plugin

@github-actions github-actions Bot added skills PR touches skills skill-check-warning Skill validator reported warnings labels May 26, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 26, 2026

🔍 Skill Validator Results

✅ All checks passed

Scope Checked
Skills 6
Agents 1
Total 7
Severity Count
--- ---:
❌ Errors 0
⚠️ Warnings 0
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ Found 6 skill(s)
ℹ️ [pptify-context-prep] 📊 pptify-context-prep: 1,461 BPE tokens [chars/4: 1,789] (detailed ✓), 7 sections, 1 code blocks
ℹ️ [pptify-deck-generation] 📊 pptify-deck-generation: 1,992 BPE tokens [chars/4: 2,436] (detailed ✓), 11 sections, 1 code blocks
ℹ️ [pptify-quality-gates] 📊 pptify-quality-gates: 1,098 BPE tokens [chars/4: 1,286] (detailed ✓), 6 sections, 1 code blocks
ℹ️ [pptify-slide-spec] 📊 pptify-slide-spec: 1,652 BPE tokens [chars/4: 1,673] (detailed ✓), 10 sections, 1 code blocks
ℹ️ [pptify-tooling] 📊 pptify-tooling: 1,116 BPE tokens [chars/4: 1,199] (detailed ✓), 9 sections, 5 code blocks
ℹ️ [pptify-visual-assets] 📊 pptify-visual-assets: 1,177 BPE tokens [chars/4: 1,352] (detailed ✓), 7 sections, 1 code blocks
ℹ️ ✅ All checks passed (6 skill(s))
Full validator output ```text Found 6 skill(s) [pptify-context-prep] 📊 pptify-context-prep: 1,461 BPE tokens [chars/4: 1,789] (detailed ✓), 7 sections, 1 code blocks [pptify-deck-generation] 📊 pptify-deck-generation: 1,992 BPE tokens [chars/4: 2,436] (detailed ✓), 11 sections, 1 code blocks [pptify-quality-gates] 📊 pptify-quality-gates: 1,098 BPE tokens [chars/4: 1,286] (detailed ✓), 6 sections, 1 code blocks [pptify-slide-spec] 📊 pptify-slide-spec: 1,652 BPE tokens [chars/4: 1,673] (detailed ✓), 10 sections, 1 code blocks [pptify-tooling] 📊 pptify-tooling: 1,116 BPE tokens [chars/4: 1,199] (detailed ✓), 9 sections, 5 code blocks [pptify-visual-assets] 📊 pptify-visual-assets: 1,177 BPE tokens [chars/4: 1,352] (detailed ✓), 7 sections, 1 code blocks ✅ All checks passed (6 skill(s)) ```

@kimtth kimtth force-pushed the add-pptify-plugin branch from c350817 to 123cf85 Compare May 26, 2026 02:06
@github-actions github-actions Bot removed the skill-check-warning Skill validator reported warnings label May 26, 2026
@kimtth
Copy link
Copy Markdown
Author

kimtth commented May 26, 2026

@aaronpowell
Thank you. I’ve updated the structure to better align with the repository design and modified the pptify-plugin definition

Check out this sample PPTX about awesome-copilot created using the plugin (+graphify).

The validate-readme workflow failed because npm start regenerated
docs/README.instructions.md with a different row order on the Ubuntu
GitHub Actions runner.

The root cause was OS-dependent default locale behavior in
String.prototype.localeCompare. On Windows, the generated README sorted
the Japanese C# instruction before the Korean C# instruction. On Ubuntu,
the same generator sorted the Korean row before the Japanese row, causing
git diff --exit-code to fail after the build step.

This patch makes the generator deterministic by passing an explicit "en"
locale to localeCompare for instruction title sorting, then commits the
regenerated README output expected by CI.
@kimtth kimtth force-pushed the add-pptify-plugin branch from c00176a to 06b1f35 Compare May 26, 2026 03:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-submission PR adds at least one new contribution plugin PR touches plugins skills PR touches skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants