mrkeyoor.com_
Wed 30 Sept 06:11 UTC
AI Toolsevaluationupdated 30 Sept 2026

screenwriting-skills review

screenwriting-skills is a Chinese-language collection of 26 Agent Skills for film, television, and theatre writing; English, Japanese, Korean, and French READMEs explain the package, but the instruction bodies remain Chinese. Claude Code, Codex, and other skill-aware agents use the material to guide structure, character, dialogue, series development, adaptation, opera, workflow, and revision in the language of the user's question.

Verdict

Our lab did not run commit 357d134 because it has no supported executable target or Dockerfile, so we cannot measure whether its 26 skills improve a script. Use it as a large craft library if you read Chinese or accept runtime translation and can judge the resulting pages yourself. Skip it when instruction auditability, current industry advice, or clean redistribution rights matter more than breadth.

We ran it

Screenshot of screenwriting-skills (github.com/jtydhr88/screenwriting-skills)

Answers from our run

Did you run screenwriting-skills yourself?

No. Its code is Python, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use screenwriting-skills?

Non-Chinese readers who require direct audit of every instruction: the README admits that runtime translation does not make the Chinese source bodies readable.

What are the alternatives to screenwriting-skills?

Storyteller, Story-Film Skills. Use it as a large craft library if you read Chinese or accept runtime translation and can judge the resulting pages yourself.

Setup4/5Simple plugin or file-copy install, but no executable lab check
Docs5/5Clear map of 26 skills, sources, language policy, and boundaries
Community3/51,463 stars and a recent push, but no open discussion queue
Maturity3/5Version 2.0.0 has wide coverage, but no releases or lab run

Who it’s for

Screenwriters who want one agent pack spanning features, television, and selected stage traditions.
Claude Code and Codex users who work across sessions and want a story-bible workflow.
Chinese-reading writers who want to inspect the full instructions and source tables themselves.
Multilingual writers comfortable asking the agent to translate Chinese craft guidance at runtime.

Who it’s NOT for

Non-Chinese readers who require direct audit of every instruction: the README admits that runtime translation does not make the Chinese source bodies readable.
Writers focused on short-form vertical drama or AI comic drama: the roadmap explicitly says neither is planned.
Teams needing current legal, union, rate, platform, or policy advice: the repository marks such facts with source years rather than promising live accuracy.
Anyone planning to redistribute the quoted craft and script material under MIT: the NOTICE says quotations retain their authors', translators', and publishers' rights.
Buyers requiring executable lab proof: our sandbox did not run the repository, so we have no measured validation of skill loading or output quality.

Setup reality

We did not run commit 357d134 in our sandbox. Although GitHub labels the repository Python, our lab found no supported executable ecosystem target and no Dockerfile, so there is no measured install, build, test, dependency, or vulnerability result.

Claude Code can install it through the plugin marketplace or by copying skills into .claude/skills; Codex has a plugin marketplace path or uses .agents/skills. The package needs no service credential or database. Its value depends on an agent runtime that can discover SKILL.md files and on enough context budget to load the relevant references.

The main runtime gotcha is language. Prompts and outputs may be English or another supported language, but the authoritative skill bodies are Chinese, so non-Chinese users cannot independently audit them. The repository also contains copyrighted quotations outside the MIT grant.

Twenty-six skills cover craft, medium, trade, and case studies

Plugin version 2.0.0 divides screenwriting knowledge among 26 modules in 4 layers. General dramaturgy covers premise, structure, character, dialogue, scenes, formatting, genre, and workflow. A medium layer adds television series, writers' rooms, sitcoms, and Chinese opera. Tradition and trade modules address American, Japanese, Korean, French, and mainland-Chinese practice. The last layer studies Chekhov, Ozu, Succession, and published television scripts as working corpora.

That breadth comes from 47 craft books and 23 volumes of published scripts, scores, and plays, according to the plugin manifest. The source tree contains 26 SKILL.md files and 50 files whose paths include references. Modules pair operating instructions with tables or worked analyses. This is closer to a shelf of craft manuals than one prompt that says “write a compelling scene.”

The workflow skill gives long projects a durable spine

Version 2.0.0 uses sw-workflow as the practical entry point. It routes a feature, stage work, or series through different stages and names the skill to call for each deliverable. A story-bible.md convention carries project state across sessions. That matters because an agent can give good scene advice in isolation while forgetting the premise, character web, format, or season decision that made the scene necessary.

The series path uses 8 stages, labeled S0 through S7, from engine and character web through pilot structure, story breaking, drafting, and submission. Other skills cover act outs, story engines, document packages, room practice, and comedy mechanics. A user can invoke one of the 26 modules directly, or automatic discovery can load it when the prompt fits.

Across 26 modules, the project resists a single universal formula. Where sources disagree, it keeps both positions and explains when each may help. Truby's organic structure sits beside Field and Snyder page maps instead of replacing them. Film structure does not get copied wholesale into episodic television or Chinese opera. That makes the collection more useful than a rigid beat-sheet generator, provided the agent preserves the distinctions.

What happened when we ran it

We did not run commit 357d134 in our September 29 sandbox. GitHub classifies the repository as Python, but the lab found no supported executable ecosystem target and no Dockerfile. There is therefore no measured installation time, build result, test count, dependency footprint, or vulnerability audit for this review.

Repository inspection found 91 files, including 1 Python module, 2 plugin manifest files, and 26 skill files, but those facts are not a substitute for our missing run. We did not install the Claude Code or Codex plugin, trigger the skills with sample scenes, compare revisions, or grade output against a screenplay. The author lists source coverage and conventions; our lab block proves none of the creative claims.

That distinction matters for writing tools. A skill can load and still give dull, derivative, or genre-inappropriate advice. Test it on your own material: give it a real scene, inspect which module loaded, compare the revision with the stated objective, and keep the original. Do not score it by how confidently the agent names a famous framework.

Runtime translation trades auditability for one maintained source

Version 2.0.0 has READMEs in 5 languages, while the 26 skill bodies stay Chinese. Output follows the language of the user's question, and a terminology table maps translated craft vocabulary back to terms such as logline, act out, and beat sheet. The design avoids maintaining parallel instruction trees that drift. It also means an English-only user executes instructions they cannot read directly.

Issue 3 proposed an English plugin and described that exact trust problem. An English edition was built and later removed; the current README explains that supporting one translated tree would create pressure for many more. The maintenance reasoning is coherent, and the cost remains real. Runtime translation lets you use a method. It does not let you verify whether the agent skipped, softened, or mistranslated a source rule.

The language choice is easier to accept for brainstorming than for production or contractual advice. The repository dates industry facts because union rules, rates, platforms, and Chinese policy details change. Treat those sections as notes from named editions, not live professional guidance. The pack can structure a pitch document or explain a writers' room chain; a current lawyer, guild source, or commissioning editor must settle today's rules.

MIT covers the skills, not every quotation they contain

Among the 10 recent commits, one added an MIT license on September 15, 2026 and a NOTICE that separates original structures, checklists, and workflows from quoted material. Quotations remain under the rights of book authors, scriptwriters, translators, and publishers. Even public-domain originals may have copyrighted translations. Installing the pack for study and republishing its reference corpus are different decisions.

GitHub showed 1,463 stars, 0 open issues or pull requests, and no published release on September 30. The last push was September 22, and the 10 recent commits include new Truby modules, licensing work, multilingual README edits, and a corrected count. The activity is current, but an empty issue queue gives little evidence about support response or how many writers have tested full projects.

Use the library to question pages, not to surrender authorship

Across 26 modules, the strongest use is diagnostic. Ask why a second act sags, whether a series engine can generate another 20 episodes, where a scene's value turns, or which format convention applies. The modules provide vocabulary and checks, then your draft supplies the evidence. Their range is unusually wide, including opera systems that most Western screenwriting packs never address.

The weak use is asking the agent to produce a finished script while treating 26 skills as authority. The repository cannot decide what only this writer has seen, which contradiction belongs to this character, or whether a scene deserves to stay. Install it if you want more precise questions and a structured project memory. Keep judgment, source verification, rights review, and the final sentences with the human writer.

Alternatives

ProjectWhat it isPick it when
StorytellerA single Agent Skill that coaches writers through drafts, questions, and rewrites.pick this instead when you want an active writing coach rather than 26 reference-heavy craft modules.
Story-Film SkillsA local Agent Skills suite spanning story development through film production and delivery.pick this instead when directing, media generation, postproduction, and delivery matter as much as dramaturgy.

What people are saying

  1. [velocity-scout] jtydhr88/screenwriting-skills

Sources

  1. screenwriting-skills README
  2. Codex plugin manifest
  3. English edition discussion
  4. License and quotation boundary commit

More ai tools reviews

dream-loop · Codex-Minecraft-Gameplay · kun · holo-card-studio · microduck-replica · reef · the whole board →