Content
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured but hollow catalogue stub: organization and the upstream pointer are good, yet it provides no executable PptxGenJS guidance and only a vague meta-workflow for installing the real skill. Actionability is the clear weakness.
Suggestions
Replace or augment the redirect with at least one executable PptxGenJS example (e.g., a minimal node script creating a deck and saving .pptx) so the skill is actionable on its own.
Remove the verbatim repetition of the frontmatter description in 'What it does' or replace it with genuinely new detail.
If the skill is intentionally a stub, add an explicit validation step (e.g., confirm the upstream bundle installed and the 'slides' skill resolves) to the install workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and free of concept-explaining padding, but the 'What it does' section repeats the frontmatter description verbatim and the catalogue meta-explanation ('advertises the skill in Open Design so the agent discovers it during planning') could be tightened, so not every token earns its place. | 2 / 3 |
Actionability | There is no executable guidance for the skill's actual purpose: the only code block is 'open https://github.com/openai/skills' (a browser open, not a pptx command) and the rest ('install the upstream bundle', 'ask the agent to invoke') is abstract redirection rather than instruction, matching the 'vague/abstract; describes rather than instructs' anchor. | 1 / 3 |
Workflow Clarity | A loose meta-sequence exists (install upstream bundle, then invoke by name/trigger), but it describes acquiring the real skill rather than the pptx workflow itself and has no validation checkpoints, so it sits at 'steps listed but gaps' rather than a clear validated sequence. | 2 / 3 |
Progressive Disclosure | The skill is under 50 lines with no local bundle files (references/, scripts/, assets/ are empty) and is cleanly organized into 'What it does', 'Source', and 'How to use' sections with a single clearly-signaled one-level-deep upstream reference, which per the simple-skills guideline earns a 3. | 3 / 3 |
Total | 8 / 12 Passed |