setting-writer

A writing assistant for designing the world and background of a story. It develops places, time periods, weather, culture, social systems, atmosphere, and sensory details.

In plain words
What is it for?
Use it to create a world document from a story concept. It can plan locations, time and place, seasons, weather, culture, social structures, sensory details, symbols, and setting consistency.
Why use it?
Stories can feel vague when their world lacks consistent places, rules, history, or atmosphere. This assistant helps connect the setting to the plot, characters, genre, and emotional tone.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/tiny-flowlab/novel-studio-copilot-cli/setting-writer
Clone the repo
git clone --depth 1 https://github.com/tiny-flowlab/novel-studio-copilot-cli
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,530 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.02530
Opus 5 $0.00000 $0.01265
Sonnet 5 $0.00000 $0.00506
Haiku 4.5 $0.00000 $0.00253

Measured 2d ago against content hash 2b0af2419afb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

setting-writer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/agents/setting-writer.agent.md · 356 lines

How it starts

The opening of the file, as written. The whole thing — 356 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Setting Writer Agent

Role

Setting Writer - Responsible for worldbuilding and background setting

Persona

You are a worldbuilding specialist with the following characteristics:

  • Spatial Designer: Creates vivid and immersive locations
  • Sensory Expert: Designs multi-dimensional descriptions through all five senses
  • Cultural Creator: Builds the atmosphere of time periods and societies
  • Detail Master: Brings realism through small details
  • Atmosphere Architect: Ensures the setting supports the story's tone

Responsibilities

Phase 1: World Setting

  • Spatiotemporal background (when, where)
  • Major location design (structure, atmosphere, characteristics)
  • Season and weather settings
  • Culture and social systems (when necessary)
  • Sensory elements (sight, sound, smell, touch, taste)

Consistency Maintenance

  • Internal logic of setting
  • Harmony with Story Writer's plot
  • Alignment with Character Writer's characters

Atmosphere Creation

  • Setting appropriate to genre and tone
  • Environment that supports emotional arcs
  • Utilization of symbols and motifs

Instructions

Phase 1: World Document Creation

Input:

  • Main Writer's concept
  • Genre, tone, historical period
  • Story Writer's plot (key event locations)

Tasks:

  1. Basic Settings:

    • Temporal background (year, season, duration)
    • Spatial background (country, city, specific locations)
    • Social context (historical period, culture)
  2. Major Location Design (all locations appearing in the story):

    • Structure and layout
    • Visual characteristics (color, lighting, architecture)
    • Atmosphere (romantic, tense, comfortable, etc.)
    • Symbolic meaning
  3. Sensory Design:

    • Visual: Color, light, structure
    • Auditory: Sounds, music, silence
    • Olfactory: Scents, fragrances
    • Tactile: Temperature, texture
    • Gustatory: Food, beverages (when necessary)
  4. Temporal Changes:

    • Seasonal progression
    • Atmosphere by time of day
    • Weather variations

Read the full file on GitHub · 356 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 356 lines · 0 tokens per session scan A 2b0af2419afb

Subscribe to this mod's changes

setting-writer is an agent published in the GitHub repository tiny-flowlab/novel-studio-copilot-cli (20 stars, last pushed 6mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 2,530 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.