sora

Use when the user asks to generate, edit, extend, poll, list, download, or delete Sora videos, create reusable non-human Sora character references, or run local multi-video queues via the bundled CLI (`scripts/sora.py`); includes requests like: (i) generate AI video, (ii) edit this Sora clip, (iii) extend this video, (iv) create a character reference, (v) download video/thumbnail/spritesheet, and (vi) Sora batch planning; requires `OPENAI_API_KEY` and Sora API access.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./sora/SKILL.md

Quality

Content

57%Weight 40%Scale 1-3

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 overview with strong progressive disclosure and verified references, supported by a clear decision tree and workflow. It is held back by redundant reference listings, a lack of inline executable commands, and missing explicit feedback loops for batch/destructive operations.

Suggestions

Collapse the 'Guidance by asset type', 'CLI + environment notes', and 'Reference map' sections into a single annotated reference list to remove redundancy.

Add one or two inline executable CLI command examples (e.g. a minimal create and a create-and-poll invocation) so guidance is copy-paste ready without opening references/cli.md.

Add an explicit validate->fix->retry checkpoint for batch and delete operations (e.g. poll a batch job to terminal, surface errors from references/troubleshooting.md, and re-run only after the issue is resolved).

Dimension	Reasoning	Score
Conciseness	The core instructional content is lean and assumes Claude's competence, but references are listed redundantly across three sections ('Guidance by asset type', 'CLI + environment notes', and 'Reference map'), which could be tightened into one.	2 / 3
Actionability	Provides specific CLI flags (--use-case, --scene, --prompt-file, --no-augment), concrete defaults, and a usable augmentation template with examples, but no inline executable CLI commands — actual command syntax is deferred to references/cli.md rather than being copy-paste ready here.	2 / 3
Workflow Clarity	A clear numbered Workflow and Decision tree sequence the process, and polling-to-terminal plus download-before-expiry act as checkpoints; however batch (create-batch) and destructive (delete) operations lack an explicit validate->fix->retry feedback loop, which the rubric caps at 2.	2 / 3
Progressive Disclosure	SKILL.md is a well-organized overview pointing to one-level-deep references; every referenced path (cinematic-shots.md, cli.md, codex-network.md, prompting.md, sample-prompts.md, social-ads.md, troubleshooting.md, video-api.md, scripts/sora.py) exists in the bundle, and the Reference map signals each file's purpose.	3 / 3
	Total	9 / 12 Passed

Description

100%Weight 40%Scale 1-3

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

The description is highly specific, third-person, and explicitly answers both what the skill does and when to use it, with strong natural trigger terms and a distinct Sora-scoped niche. Its only weakness is mild verbosity from stating the action list both as a verb run and as an enumerated (i)-(vi) set, though no description dimension directly penalizes that.

Dimension	Reasoning	Score
Specificity	Lists many concrete actions ('generate, edit, extend, poll, list, download, or delete Sora videos, create reusable non-human Sora character references, or run local multi-video queues') rather than vague language, matching the 'lists multiple specific concrete actions' anchor.	3 / 3
Completeness	Explicitly answers both what (the verb list + enumerated request types) and when via an explicit 'Use when...' clause plus prerequisites ('requires OPENAI_API_KEY and Sora API access').	3 / 3
Trigger Term Quality	Covers natural phrasings a user would say ('generate AI video', 'edit this Sora clip', 'extend this video', 'create a character reference', 'download video/thumbnail/spritesheet', 'Sora batch planning'), giving good coverage of natural terms.	3 / 3
Distinctiveness Conflict Risk	Clearly scoped to Sora video operations with distinct triggers and an API-key/Sora-access prerequisite, making it unlikely to fire for unrelated skills.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: JetBrains/skills
Path: sora/SKILL.md
Commit: e0f258b

Reviewed: ~1 month ago

Table of Contents

Discovery Implementation Validation

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.