Skip to content
SkillScript-led2,897 tokens in use

story-short-scan

Scans short web fiction listings from Dianzhong and Heiyan or your own lists, ranks reader emotions and genres, and matches topics to what you can write.

8,793 stars on the repository MIT Licensezenstory-ai/oh-story-claudecode · skills/story-short-scan
npx skills add zenstory-ai/oh-story-claudecode -y -g
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing story-short-scan costs

108tokens idle
2,897tokens in use
7,567tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/aggregate-rank.js, scripts/cdp-utils.js, scripts/dz-browse-scraper.js, scripts/heiyan-booklist-scraper.js.

Touches

shelldetectednetworkdetectedwrites filesdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure16/25
  • Examples9/15
  • Output0/15
  • Size15/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Fair
  • Hidden characters−20

    characters that render as nothing or reorder the text

    scripts/aggregate-rank.js, line 171
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/aggregate-rank.js, line 757
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    scripts/cdp-utils.js, line 11
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    scripts/heiyan-booklist-scraper.js, line 51

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance100
  • Community60
  • Maturity28
  • Momentum40

story-short-scan studies the short-story market. Scripts collect listings from Dianzhong and Heiyan, while Zhihu Yanyan, Fanqie and Qimao shorts come from screenshots, text or links you supply. The data is aggregated and reported as emotion ranking, genre hot spots, length ranges, synopsis and title patterns, endings and protagonist types.

The report states the sample date, coverage and confidence, and suggests when to rescan. A topic matching step then picks directions that fit your platform, materials and word budget.

What You Get

  • A dated scan folder with the collected listings and an aggregated summary
  • A report ranking reader emotions and genre hot spots with representative stories
  • Length, synopsis, ending and title pattern findings
  • A conclusion file with a topic matching section, ready for the short writing skill to read
  • A confidence note and a recommended rescan date

Common Use Cases

  • Choosing an emotion and genre for the next short story before writing
  • Checking a submission call’s genre and length conditions against current listings
  • Comparing this week’s scan with the previous one to see which genres rise

What Makes It Unique

Short-story trends move fast, so every report carries its sample date, coverage, confidence and a rescan date. The skill sorts genres into six reader emotions with a difficulty rating, treats shelf listings as listings and never as popularity, and keeps built-in knowledge labeled as unverified hypotheses.

Under The Hood

The skill reads one platform reference, then runs bundled Node scripts that open Dianzhong and Heiyan pages through a Chrome remote-debugging session (Heiyan needs your own logged-in account) and writes the listings to files. Another script aggregates them. All outputs go into a dated scan folder in your working directory. For other platforms it works from text, screenshots or links you provide.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers