CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

humanize-ppt

A presentation system for agent-made PPTs — born for the talk, not just the template. It turns raw material into an AST (audience-state-transfer) outline with per-page visual-enhancement decisions (image / SVG diagram / video), hands a production brief to a downstream renderer (HTML-PPT skills or native PPTX), then runs a capped 3-round presentation checkup (演讲体检) on the rendered deck. It never renders slides itself. Use before generating PPT/HTML slides from raw material, and after rendering when the user says things like "给这份 deck 做演讲体检" or "PPT 渲染质检". If all you want is one beautiful template page with no outline and no checkup, a rendering skill alone is enough.

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers a strong, contract-driven workflow: precise artifact list, bounded checkup loop with human escalation, and safety rules around destructive output. Its weaknesses are redundancy from versioned editing (the brief-only boundary repeated four times, v0.6.4 vs 1.1.1 version confusion), no complete example command in the body, and several cited bundle paths (adapters/, registry/, SPEC.md, docs/) that don't exist in this skill's directory.

Suggestions

State the brief-only boundary once (invariant 1) and prune its restatements from the Positioning, OPC, and rule-4 sections; fold the 'formerly the QA loop' and other version-history asides into a release-notes reference file.

Reconcile the version references: the body hard-codes 'v0.6.4' in two headings and five invariants while the frontmatter says 'version: 1.1.1' — either update the invariants to be version-neutral or move the per-version notes to a deprecated/old-patterns section.

Fix or remove the broken bundle references (adapters/ppt-master-bridge-notes.md, registry/renderer_registry.json, SPEC.md, docs/index.md, docs/local-demo.md), and add one complete example invocation (e.g. a full `python scripts/humanize_ppt.py --source ... --out ...` brief-mode and a `--qa-from` checkup command) inline so the CLI surface is usable without the missing docs file.

DimensionReasoningScore

Conciseness

Mostly information-dense (no explanations of concepts Claude already knows), but noticeably tightened-by-editing residue: the brief-only boundary is restated at least four times ('never copies a downstream skill's template... and never post-processes rendered HTML or PPTX' appears in Positioning, the OPC P block, invariant 1, and rule 4's postMessage clause), version noise ('v0.6.4' in two headings and five invariants contradicts the frontmatter's 'version: 1.1.1', and 'formerly the QA loop, CLI flag still --qa-from') is history, not instruction, and rule 12's dense WorkBuddy packaging paragraph duplicates references/workbuddy-team-packaging-and-video-materials.md. It could be tightened but is not padded — fits anchor 3 rather than 2.

3 / 5

Actionability

Concrete, executable surface throughout: an 18-artifact output contract with exact filenames and JSON shapes ('slide_plan.json... per-page media: {image, diagram, video} decision and layout_hint'), named CLI flags (--qa-from, --style-gallery, --renderer ppt-master, --out with a precise auto-wipe/refusal rule and --force), and named scripts. The gap keeping it below 5: not a single complete example invocation appears in the body, and the pointer for them ('Full CLI examples... live in docs/local-demo.md') targets a file that does not exist in this bundle.

4 / 5

Workflow Clarity

The O→P→Q→C workflow is a clear end-to-end sequence with explicit validation checkpoints and a bounded feedback loop: two human review gates before rendering (outline preview, style gallery), QA iterations that 'write qa_report.md, fix_prompt.md, and qa_iteration.json', a hard cap ('The presentation checkup caps at 3 iterations. Round 4 with remaining fail findings is needs-human'), and a destructive-output safeguard (--out refuses to wipe unless it is empty, missing, or a prior Humanize run, else requires --force). This matches the 5 anchor: explicit validation, error-recovery loop, and escalation to a human.

5 / 5

Progressive Disclosure

The 'Operational references' section is well-signaled with one-line annotations and the references/ files it cites all exist, but five paths the body points to are absent from the bundle: 'adapters/ppt-master-bridge-notes.md', 'registry/renderer_registry.json' (cited as the machine-readable source of truth for support levels), 'SPEC.md', 'docs/index.md' ('Full annotated index of all references'), and 'docs/local-demo.md' (which holds all CLI examples). Combined with inline content that duplicates an existing reference (rule 12), navigation is partly broken — fits anchor 3 ('references present but... content that should be separate is inline') better than 4's 'minor organization gaps'.

3 / 5

Total

15

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exceptionally strong description: concrete multi-step capabilities, explicit use-timing in both languages, quoted user-utterance triggers, and clear boundary guidance against the downstream rendering skills. The only deduction is the second-person clause in the final sentence, which the guidelines penalize on specificity.

DimensionReasoningScore

Specificity

The description enumerates concrete pipeline actions — 'turns raw material into an AST (audience-state-transfer) outline with per-page visual-enhancement decisions (image / SVG diagram / video), hands a production brief to a downstream renderer..., then runs a capped 3-round presentation checkup' — which is comprehensive coverage matching the 5 anchor. However, it slips into second person ('If all you want is one beautiful template page... a rendering skill alone is enough'), which the judging guidelines penalize by reducing specificity by 1.

4 / 5

Completeness

Both what and when are explicit: the what is the full outline/brief/checkup pipeline ('It never renders slides itself'), and the when gives concrete trigger phrases ('Use before generating PPT/HTML slides from raw material, and after rendering when the user says things like...') — this matches the 5 anchor example's structure exactly.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage with synonyms and extensions: 'PPT', 'PPTs', 'slides', 'HTML slides', 'deck', 'native PPTX', plus concrete user-utterance triggers in both English and Chinese ('给这份 deck 做演讲体检', 'PPT 渲染质检'). A user asking to make a presentation or check a rendered deck would naturally use these phrases.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (brief orchestrator + post-render checkup) and explicitly disambiguates from rendering skills ('It never renders slides itself... a rendering skill alone is enough'), giving minimal conflict risk with the downstream renderer skills it names.

5 / 5

Total

19

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

nexu-io/open-design

Path

plugins/community/humanize-ppt/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.