student-presentation-suite

Student Presentation Suite

中文 | English

Student Presentation Suite is a local plugin marketplace for building university presentation workflows in both Codex and Claude Code.

It ships one plugin, student-presentation-suite, with three skills:

• student-presentation: plan topics, outlines, scripts, transitions, handoffs, and Q&A.
• student-presentation-ppt: generate editable PPTX decks with speaker notes, visual styles, Slide Spec handoff, and delivery QA.
• student-presentation-review: review PPTX/PDF/screenshots/specs for logic, readability, rubric fit, AI-writing risk, and static PPTX issues.

Why This Exists

University presentation work usually needs more than slide generation. This plugin keeps planning, PPTX production, and review as separate skills while sharing classroom readability, source-use, anti-AI wording, timing, and group-presentation standards.

The repository is structured as a marketplace root so others can clone it and install the plugin directly.

Repository Layout

.
├── marketplace.json
├── .claude-plugin/
│   └── marketplace.json
├── plugins/
│   └── student-presentation-suite/
│       ├── .codex-plugin/plugin.json
│       ├── .claude-plugin/plugin.json
│       ├── skills/
│       ├── scripts/
│       ├── shared/
│       ├── references/
│       └── tests/
└── .github/workflows/validate.yml

Compatibility

Runtime	Entry point	PPTX route
Codex	marketplace.json	Default Presentations skill/plugin + artifact-tool + imagegen
Claude Code	.claude-plugin/marketplace.json	document-skills plugin, using its pptx skill

Claude Code PPTX generation expects document-skills@anthropic-agent-skills to be installed.

Installation

Codex

Clone this repository into your local plugin marketplace location:

git clone https://github.com/YFan945/student-presentation-suite.git `
  "$env:USERPROFILE\.agents\plugins"

The Codex marketplace manifest is at:

marketplace.json

The plugin source path is:

"./plugins/student-presentation-suite"

Claude Code

Clone the same repository, then add/install the marketplace from Claude Code according to your local plugin workflow. The Claude Code marketplace manifest is:

.claude-plugin/marketplace.json

Install Anthropic document skills before using PPTX generation:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

Usage

Use the plugin by asking for one of the three workflows:

• Plan a class presentation from a topic.
• Generate an editable PPTX from an outline or Slide Spec.
• Review an existing deck, PDF export, screenshot, or Slide Spec.

For full plugin-level details, see:

• Plugin README
• 中文文档
• Example presentation brief

Development

Install validation dependencies:

python -m pip install -r plugins/student-presentation-suite/requirements.txt

Run tests and release checks from the repository root:

python -m pytest -q plugins/student-presentation-suite/tests
python plugins/student-presentation-suite/scripts/check_plugin_release.py
python plugins/student-presentation-suite/scripts/check_claude_pptx_env.py --json

Validate plugin manifests:

python "$env:USERPROFILE\.codex\skills\.system\plugin-creator\scripts\validate_plugin.py" `
  .\plugins\student-presentation-suite
claude plugin validate .\plugins\student-presentation-suite
claude plugin validate .

Notes

• Generated PPTX, PNG, PDF, and cache files are ignored by default.
• The root marketplace.json is for Codex.
• The root .claude-plugin/marketplace.json is for Claude Code.
• The plugin package lives under plugins/student-presentation-suite.

License

MIT. See LICENSE.