Skip to content
Back to search

storyscope-rules

MarketplaceWorks with Claude CodeGitHub

Claude Code skill/plugin: pre-writing structural rules from the StoryScope study (COLM 2026) on narrative choices that distinguish AI from human text

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rustlanglatam--storyscope-rules/badge.svg)](/listings/rustlanglatam--storyscope-rules)

HTML

<a href="/listings/rustlanglatam--storyscope-rules"><img src="/api/listings/rustlanglatam--storyscope-rules/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Inside a Claude Code session:

/plugin marketplace add RustLangLatam/storyscope-rules
/plugin install storyscope-rules@storyscope-rules

Or from a terminal:

claude plugin marketplace add RustLangLatam/storyscope-rules
claude plugin install storyscope-rules@storyscope-rules

Start a new session afterwards so the skill is loaded. Pass `--scope project` to `install` to enable it only for the current repository (the setting is written to `.claude/settings.json`, so collaborators get it too).

**Without the plugin system**, copy the folder instead:

git clone https://github.com/RustLangLatam/storyscope-rules.git
cp -r storyscope-rules/skills/storyscope-rules ~/.claude/skills/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "storyscope-rules",
  3. "owner": { "name": "RustLangLatam" },
  4. "plugins": [
  5. {
  6. "name": "storyscope-rules",
  7. "source": "./",
  8. "description": "Pre-writing structural rules derived from the StoryScope study (arXiv:2604.03136)."
  9. }
  10. ]
  11. }
README.md · README · 184 lines
  1. # storyscope-rules
  2. An [Agent Skill](https://agentskills.io/specification) that changes **what an agent decides to write and in what order**, before it writes a word. It works in Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, OpenCode and any other client that reads `SKILL.md` folders.
  3. The rules come from the StoryScope study (Russell et al., COLM 2026; [paper](https://jenna-russell.github.io/assets/pdf/storyscope.pdf), [arXiv:2604.03136](https://arxiv.org/abs/2604.03136)). Its main finding: narrative structure alone separates human from AI fiction at 93.2 macro-F1. In its one editing test, rewriting 278 Gemini stories to strip clichés and purple prose lowered detection by only 1.6 points (95.5 → 93.9).
  4. So the skill works on the outline, not on the wording of a finished draft.
  5. > This is an independent, unofficial adaptation. It is not affiliated with or endorsed by the StoryScope authors.
  6. ## Contents
  7. - [Install in Claude Code (plugin)](#install-in-claude-code-plugin)
  8. - [Using the plugin](#using-the-plugin)
  9. - [Install in other clients](#install-in-other-clients)
  10. - [What it does](#what-it-does)
  11. - [What it does not do](#what-it-does-not-do)
  12. - [Documentation](#documentation)
  13. ## Install in Claude Code (plugin)
  14. Inside a Claude Code session:
  15. ```
  16. /plugin marketplace add RustLangLatam/storyscope-rules
  17. /plugin install storyscope-rules@storyscope-rules
  18. ```
  19. Or from a terminal:
  20. ```bash
  21. claude plugin marketplace add RustLangLatam/storyscope-rules
  22. claude plugin install storyscope-rules@storyscope-rules
  23. ```
  24. Start a new session afterwards so the skill is loaded. Pass `--scope project` to `install` to enable it only for the current repository (the setting is written to `.claude/settings.json`, so collaborators get it too).
  25. **Without the plugin system**, copy the folder instead:
  26. ```bash
  27. git clone https://github.com/RustLangLatam/storyscope-rules.git
  28. cp -r storyscope-rules/skills/storyscope-rules ~/.claude/skills/
  29. ```
  30. ## Using the plugin
  31. ### Automatic use (the default)
  32. You do not need to call it. The skill's description tells the agent to load it **before any task that produces text for people**: reports, proposals, emails, documentation, PR descriptions, interface copy, fiction, long messages. It also loads when you ask for text that "doesn't sound like AI" or has "less filler". In coding tasks it only affects comments, commit messages, PR text and the final summary. The code itself is left alone.
  33. ### Explicit use
  34. Call it by name when you want to be sure it runs:
  35. | Installed as | Command |
  36. |---|---|
  37. | Plugin | `/storyscope-rules:storyscope-rules` |
  38. | Plain skill (`~/.claude/skills/`) | `/storyscope-rules` |
  39. Examples:
  40. ```
  41. /storyscope-rules:storyscope-rules write the release announcement for v2.3 from CHANGELOG.md
  42. /storyscope-rules:storyscope-rules review this proposal draft and restructure what fails the audit
  43. ```
  44. ### What you will see
  45. Before drafting, the agent outlines in its reasoning what will be told, in what order and what stays open. After drafting it runs the final audit. If it breaks a rule because you asked for something specific or because the truth required it, it says so in one line. Expect result-first openings, no closing "lesson" paragraph, named sources instead of vague allusions, and explicit costs and open issues.
  46. ### Managing it
  47. | Task | Command |
  48. |---|---|
  49. | Check that it is installed | `claude plugin list` |
  50. | Update to the latest version | `claude plugin marketplace update storyscope-rules` then `claude plugin update storyscope-rules@storyscope-rules` |
  51. | Turn off temporarily | `claude plugin disable storyscope-rules@storyscope-rules` |
  52. | Turn back on | `claude plugin enable storyscope-rules@storyscope-rules` |
  53. | Uninstall | `claude plugin uninstall storyscope-rules@storyscope-rules` |
  54. Inside a session, `/plugin` opens the same options interactively.
  55. ## Install in other clients
  56. The skill is one standard folder, `skills/storyscope-rules/`, with only `name`, `description` and `license` in its frontmatter. It uses no Claude-specific variables or tools, so the same file works everywhere. The plugin manifests in `.claude-plugin/` are only read by Claude Code; other clients ignore them.
  57. **One copy covers most clients.** Codex, Gemini CLI, Cursor and OpenCode all read `~/.agents/skills/`:
  58. ```bash
  59. git clone https://github.com/RustLangLatam/storyscope-rules.git
  60. mkdir -p ~/.agents/skills
  61. cp -r storyscope-rules/skills/storyscope-rules ~/.agents/skills/
  62. ```
  63. To install for a single repository instead, copy it to `<repo>/.agents/skills/`. To receive updates with `git pull`, use `ln -s "$(pwd)/storyscope-rules/skills/storyscope-rules" ~/.agents/skills/` instead of `cp`.
  64. | Client | User directory | Project directory | How it is invoked |
  65. |---|---|---|---|
  66. | **Claude Code** | `~/.claude/skills/` (or the plugin) | `.claude/skills/` | Automatic, or `/storyscope-rules` |
  67. | **OpenAI Codex** | `~/.agents/skills/` | `.agents/skills/` | Automatic, or `$storyscope-rules`; `/skills` lists them |
  68. | **Gemini CLI** | `~/.gemini/skills/` or `~/.agents/skills/` | `.gemini/skills/` or `.agents/skills/` | Automatic (asks to activate); `/skills list` to check |
  69. | **Cursor** | `~/.cursor/skills/` or `~/.agents/skills/` (also reads `~/.claude/skills/`) | `.cursor/skills/` or `.agents/skills/` | Automatic, or `/storyscope-rules` in Agent chat |
  70. | **GitHub Copilot** (VS Code) | `~/.copilot/skills/` | `.github/skills/` | Automatic, or `/storyscope-rules` |
  71. | **OpenCode** | `~/.config/opencode/skills/` or `~/.agents/skills/` (also reads `~/.claude/skills/`) | `.opencode/skills/` or `.agents/skills/` | Automatic, or `@storyscope-rules` |
  72. Client-specific notes:
  73. - **Gemini CLI** can install straight from GitHub:
  74. ```bash
  75. gemini skills install https://github.com/RustLangLatam/storyscope-rules.git --path skills/storyscope-rules
  76. ```
  77. Google's documentation states that Gemini CLI was succeeded by Antigravity CLI in June 2026; check that client's docs for its current path.
  78. - **GitHub Copilot** does not read `~/.agents/skills/` in its own harness. Copy the folder to `~/.copilot/skills/` or `.github/skills/`.
  79. - **Cursor and OpenCode** already read `~/.claude/skills/`. If you installed the plain skill for Claude Code there, they pick it up with no extra step. The Claude Code *plugin* install lives elsewhere, so those clients do not see it.
  80. - **Several clients on one machine**: install once in `~/.agents/skills/`, and add a copy in `~/.claude/skills/` (or the plugin) for Claude Code and in `~/.copilot/skills/` for Copilot. Avoid having two copies visible to the same client, or it may list the skill twice.
  81. **On non-Claude models**, group E of the rules (Claude's own writing habits) is marked optional, and the skill gives the habits the study measured for GPT, Gemini, DeepSeek and Kimi instead. All other rules apply to every model.
  82. These paths are taken from each client's documentation as of November 2026 ([Agent Skills spec](https://agentskills.io/specification), [Codex](https://developers.openai.com/codex/skills), [Gemini CLI](https://geminicli.com/docs/cli/skills/), [Cursor](https://cursor.com/docs/context/skills), [VS Code Copilot](https://code.visualstudio.com/docs/copilot/customization/agent-skills), [OpenCode](https://opencode.ai/docs/skills)). Clients change quickly. If a path stops working, check the linked page and open an issue.
  83. ## What it does
  84. 1. **Classifies** the task as narrative, non-narrative or code-only.
  85. 2. **Outlines in reasoning** what will be told, in what order, what stays unresolved and which real references it carries.
  86. 3. **Checks the outline** against 31 rules in six groups:
  87. | Group | Targets | Example |
  88. |---|---|---|
  89. | A. Meaning | Explaining the moral | End on the decision, not the lesson |
  90. | B. Body & atmosphere | Embodied emotion, mood-weather | Say "she was afraid" (29% human vs. 8% AI) |
  91. | C. Pipeline | Single tidy causal line | Include what was tried and failed |
  92. | D. Absent moves | Techniques AI avoids | Open with the result, then go back |
  93. | E. Model habits | Claude's fingerprints (others listed) | Do not keep intensity flat |
  94. | F. Rarity | The first idea every model has | Discard it if another serves equally |
  95. 4. **Drafts**, then runs an 8-question **audit**. Any "yes" sends it back to restructure. Word swaps don't count.
  96. **Truth comes first.** The skill never invents a reference, figure or anecdote to satisfy a rule. An explicit user request or a mandatory format (contracts, specs, forms) overrides it, and the agent says so in one line when that happens.
  97. ## What it does not do
  98. - It does **not** make text undetectable. Trained text-based detectors score 99.7–99.9 on the same corpus, and this skill doesn't touch that layer.
  99. - The evidence is **English fiction**. Transfer to reports, emails or other languages is a documented hypothesis, not a result.
  100. - It is **not** for hiding AI authorship where disclosure is required.
  101. ## Documentation
  102. - [`docs/TECHNICAL_REPORT.md`](docs/TECHNICAL_REPORT.md): source study, how features became rules, register transfer, execution protocol, portability, threats to validity, and a rule–evidence index.
  103. - [`skills/storyscope-rules/SKILL.md`](skills/storyscope-rules/SKILL.md): the skill itself.
  104. - [`CHANGELOG.md`](CHANGELOG.md): release history and corrections.
  105. ## Repository layout
  106. ```
  107. .claude-plugin/
  108. plugin.json Claude Code plugin manifest
  109. marketplace.json single-plugin marketplace (enables /plugin marketplace add)
  110. skills/storyscope-rules/
  111. SKILL.md the skill (Agent Skills standard, client-neutral)
  112. docs/
  113. TECHNICAL_REPORT.md
  114. CITATION.cff citation metadata (GitHub "Cite this repository")
  115. CHANGELOG.md
  116. LICENSE
  117. ```
  118. ## Citation
  119. If you use this in research, cite the source study:
  120. ```bibtex
  121. @inproceedings{russell2026storyscope,
  122. title = {StoryScope: Investigating idiosyncrasies in AI fiction},
  123. author = {Russell, Jenna and Rajendhran, Rishanth and Pham, Chau Minh and Iyyer, Mohit and Wieting, John},
  124. booktitle = {Conference on Language Modeling (COLM)},
  125. year = {2026},
  126. eprint = {2604.03136},
  127. archivePrefix = {arXiv}
  128. }
  129. ```
  130. ## License
  131. MIT for this skill and its documentation. The StoryScope paper and data belong to their authors.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.