agentleFS
Sign inStart free
AIPMAndyAIPMAndy/PPTskill/CLAUDE.md

PPTskill

CLAUDE.md57 starsChanged 4 months agoMITView on GitHub

This file provides a project overview for Claude Code. Before executing PPT generation tasks, you MUST first read skills/ppt-master/SKILL.md for the complete workflow and rules. PPT Master is an AI-driven presentation generation system. Through multi-role collaboration (Strategist → Image_Generator → Executor), it converts source documents (PDF/DOCX/URL/Markdown) into natively editable PPTX with real PowerPoint shapes (DrawingML). Core Pipeline: Source Document → Create Project → Template Option → Strategist Eight Confirmations → [Image_Generator] → Executor → Post-processing → Export PPTX Banned features:…

We split this CLAUDE.md into the rules it gives an agent

3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    NEVER: use cp as a substitute for finalize_svg.py

    line 77
  2. Very specific:

    Do NOT add extra flags like --only to the post-processing commands

    line 79
  3. Distinctive:

    NEVER: run the three post-processing steps in a single code block or single shell invocation

    line 80

≈ “Common” is an estimate: at least 1 in 5 of the 25,680 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
CLAUDE.md

CLAUDE.md

This file provides a project overview for Claude Code. Before executing PPT generation tasks, you MUST first read skills/ppt-master/SKILL.md for the complete workflow and rules.

Project Overview

PPT Master is an AI-driven presentation generation system. Through multi-role collaboration (Strategist → Image_Generator → Executor), it converts source documents (PDF/DOCX/URL/Markdown) into natively editable PPTX with real PowerPoint shapes (DrawingML).

Core Pipeline: Source Document → Create Project → Template Option → Strategist Eight Confirmations → [Image_Generator] → Executor → Post-processing → Export PPTX

Common Commands

# Source content conversion
python3 skills/ppt-master/scripts/pdf_to_md.py <PDF_file>
python3 skills/ppt-master/scripts/doc_to_md.py <DOCX_or_other_file>   # Requires: pandoc (DOCX/EPUB/HTML/LaTeX/RST/etc.)
python3 skills/ppt-master/scripts/web_to_md.py <URL>
node skills/ppt-master/scripts/web_to_md.cjs <URL>

# Project management
python3 skills/ppt-master/scripts/project_manager.py init <project_name> --format ppt169
python3 skills/ppt-master/scripts/project_manager.py import-sources <project_path> <source_files_or_URLs...> --move
python3 skills/ppt-master/scripts/project_manager.py validate <project_path>

# Image tools
python3 skills/ppt-master/scripts/analyze_images.py <project_path>/images
python3 skills/ppt-master/scripts/image_gen.py "prompt" --aspect_ratio 16:9 --image_size 1K -o <project_path>/images

# SVG quality check
python3 skills/ppt-master/scripts/svg_quality_checker.py <project_path>

# Post-processing pipeline (MUST run sequentially, one at a time — NEVER batch)
python3 skills/ppt-master/scripts/total_md_split.py <project_path>
# ✅ Confirm no errors before running the next command
python3 skills/ppt-master/scripts/finalize_svg.py <project_path>
# ✅ Confirm no errors before running the next command
python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final
# Default: generates two files — native shapes (.pptx) + SVG reference (_svg.pptx)
# Use --only native  to skip SVG reference version
# Use --only legacy  to only generate SVG image version

Architecture

  • skills/ppt-master/references/ — AI role definitions and technical specifications
  • skills/ppt-master/scripts/ — Runnable tool scripts
  • skills/ppt-master/scripts/docs/ — Topic-focused script docs
  • skills/ppt-master/templates/ — Layout templates, chart templates, 640+ vector icons
  • examples/ — Example projects
  • projects/ — User project workspace

SVG Technical Constraints (Non-negotiable)

Banned features: clipPath | mask | <style> | class | external CSS | <foreignObject> | textPath | @font-face | <animate*> | <script> | marker-end | <iframe> | <symbol>+<use> (id inside <defs> is a legitimate reference and is NOT banned)

PPT compatibility alternatives:

BannedAlternative
rgba()fill-opacity / stroke-opacity
<g opacity>Set opacity on each child element individually
<image opacity>Overlay with a mask layer
marker-end arrows<polygon> triangles

Canvas Format Quick Reference

FormatviewBox
PPT 16:90 0 1280 720
PPT 4:30 0 1024 768
Xiaohongshu (RED)0 0 1242 1660
WeChat Moments0 0 1080 1080
Story0 0 1080 1920

Post-processing Notes

  • NEVER use cp as a substitute for finalize_svg.py
  • NEVER export directly from svg_output/ — MUST export from svg_final/ (use -s final)
  • Do NOT add extra flags like --only to the post-processing commands
  • NEVER run the three post-processing steps in a single code block or single shell invocation

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free