Agent skill

Sleep Story

by jwynia in jwynia/agent-skills

Write stories designed to help listeners fall asleep. An agent skill from jwynia/agent-skills.

MITAuto-check passedProductivity & Automation

Install Sleep Story

skills CLI
$ npx skills add jwynia/agent-skills --skill sleep-story -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jwynia/agent-skills sleep-story --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/creative/fiction/application/sleep-story .claude/skills/sleep-story && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sleep-story
GitHub stars
170
Token cost
~3.6k tokens
SKILL.md length
1,839 words
Files
1
Skills in repo
111
Repo updated
First seen
Licence
MIT

At a glance

Write stories designed to help listeners fall asleep. An agent skill from jwynia/agent-skills.

  • Works in 10 steps: Momentum Without Urgency → Description Over Action → Repetitive Comfort Patterns → …
  • Bedtime podcasts
  • SKILL.md covers Core Principle: The Gentle…, The Five Pillars, Story Templates and Language Techniques, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Sleep Story is an agent skill from jwynia/agent-skills. Write stories designed to help listeners fall asleep. Use for bedtime podcasts, meditation content, calming narratives, or any content where the goal is gentle cognitive engagement that fades naturally into rest.

Its SKILL.md is about 3.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Health and fitness tracking and Podcasting. The licence is MIT.

When your agent uses it

  • Bedtime podcasts
  • Meditation content
  • Calming narratives
  • Any content where the goal is gentle cognitive engagement that fades naturally into rest

Example prompts

  • “/sleep-story”

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Momentum Without Urgency
  2. Description Over Action
  3. Repetitive Comfort Patterns
  4. Present Tense Immersion
  5. The Fade Protocol
  6. Disguised Drama
  7. Engagement Habits
  8. Sensory Jarring
  9. Speed Creep
  10. Resolution Compulsion

What it can do on your machine

Read from SKILL.md and the folder at commit e02ec7e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sleep Story loads about 3.6k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 1,839 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jwynia/agent-skills at commit e02ec7e, republished under its MIT licence (© jwynia). 1,839 words, ~3,578 tokens.

Download SKILL.mdSave it as .claude/skills/sleep-story/SKILL.md (or your agent's skills folder).
name
sleep-story
description
Write stories designed to help listeners fall asleep. Use for bedtime podcasts, meditation content, calming narratives, or any content where the goal is gentle cognitive engagement that fades naturally into rest.
license
MIT
metadata.author
jwynia
metadata.version
1.0
metadata.type
generator
metadata.mode
generative
metadata.domain
fiction

Sleep Story: Calming Narrative Skill

You help writers create stories specifically designed to accompany listeners into sleep. These are verbal lullabies disguised as narratives—occupying the mind just enough to prevent racing thoughts while naturally fading as attention wavers.

Core Principle: The Gentle Cognitive Load

Sleep stories occupy the mind just enough to prevent racing thoughts while naturally fading as attention wavers. The goal is not to entertain but to accompany someone into sleep. The best sleep story is one the listener never hears the end of.

The Five Pillars

1. Momentum Without Urgency

Stories should move forward but never rush. Each sentence flows like a slow river.

Instead of: "Sarah rushed to the market before it closed."

Write: "Sarah walked along the cobblestone path toward the market square, her basket swaying gently with each step. The afternoon sun cast long shadows between the buildings."

2. Description Over Action

Paint scenes rather than chronicle events. Linger on sensory details without dramatic purpose.

3. Repetitive Comfort Patterns

Use recurring elements that create familiarity:

  • Counting things (steps, breaths, items)
  • Listing similar objects with slight variations
  • Returning to the same sensory anchors
  • Circular routes that end where they began
4. Present Tense Immersion

Present tense creates a dreamlike quality where the listener exists in the moment.

Example: "You are walking through the garden. The gravel crunches softly beneath your feet. To your left, lavender plants release their fragrance into the evening air."

5. The Fade Protocol

Structure stories to naturally decrease in interest and complexity.

  • Beginning: Mildly intriguing setup
  • Middle: Gentle exploration
  • End: Infinite possibility for continuation without resolution

Story Templates

Template A: The Wandering Observer
  1. Character arrives at a peaceful location
  2. Slow exploration with detailed observations
  3. Small, satisfying tasks performed
  4. Gradual settling into rest
Template B: The Gentle Routine
  1. Character begins a calming routine
  2. Each step described in loving detail
  3. Sensory focus on textures, temperatures, sounds
  4. Natural conclusion in rest or contemplation

Example activities: Making tea, tending houseplants, organizing a collection, preparing a reading nook

Template C: The Infinite Journey
  1. Travel through a peaceful landscape
  2. No destination or arrival necessary
  3. Focus on the journey itself
  4. Can continue indefinitely

Example: "The train moves steadily through the countryside. Fields of wheat stretch to the horizon. Occasionally, a small farmhouse appears in the distance. The rhythmic sound of the rails: click-clack, click-clack."

Language Techniques

Softening Words

Use words with soft consonants and flowing sounds:

  • Gentle, slowly, quietly, softly
  • Drifting, floating, wandering, meandering
  • Warm, smooth, peaceful, calm
Avoid Harsh Sounds

Replace jarring words:

  • "Crash" → "settle"
  • "Bright" → "gentle glow"
  • "Quick" → "unhurried"
  • "Excited" → "content"
The Power of "And"

Connect thoughts with "and" rather than "but" or "however":

"The path winds through the forest, and the trees create a canopy overhead, and somewhere a stream babbles over smooth stones, and the air carries the scent of pine."

Sensory Layering Guide

Visual
  • Soft, warm lighting (amber, golden, gentle)
  • Muted colors (dusty rose, sage green, warm gray)
  • Gentle movement (swaying, drifting, floating)
  • Comfortable distances (cozy, enclosed, intimate)
Auditory
  • Natural rhythms (rain, waves, breathing)
  • Soft mechanical sounds (clock ticking, fan humming)
  • Muffled distant sounds (faraway train, muted voices)
  • Gentle nature sounds (rustling leaves, quiet birds)
Tactile
  • Soft textures (velvet, wool, smooth wood)
  • Comfortable temperatures (warm but not hot)
  • Gentle pressure (heavy blanket, soft cushion)
  • Smooth surfaces (polished stone, worn leather)
Olfactory
  • Comforting scents (baking bread, lavender, vanilla)
  • Natural aromas (rain, earth, wood)
  • Subtle fragrances (old books, clean linen)

Common Settings

Indoor Sanctuaries
  • Libraries after closing
  • Cozy bookshops
  • Quiet museums
  • Empty cafes at dusk
  • Candlelit churches
  • Artist's studios
  • Greenhouse conservatories
Natural Spaces
  • Moonlit gardens
  • Misty forests
  • Quiet beaches at dawn
  • Mountain meadows
  • Desert under stars
  • Gentle riversides
  • Snow-covered landscapes
Transitional Spaces
  • Night trains
  • Boats on calm water
  • Hot air balloons
  • Cable cars
  • Quiet airports at night
  • Walking paths

Pacing Guidelines

Sentence Structure
  • Mix medium and long sentences
  • Avoid short, punchy statements
  • Use flowing punctuation (commas over periods)
  • Create natural breathing spaces
Paragraph Flow
  • 3-5 sentences per paragraph
  • Each paragraph one complete micro-scene
  • Gentle transitions between paragraphs
  • No sudden scene changes
Story Arc
  • 10-15 minutes for complete stories
  • No climax or resolution needed
  • Can stop at any point without frustration
  • Each section self-contained
Reading Speed

Test at 120-140 words per minute (slower than normal reading)

Example Opening

The lighthouse keeper's cottage sits at the edge of the world, where the land meets the endless sea. You approach along the winding path, wild grasses brushing against your legs with each step. The late afternoon sun warms your shoulders while a gentle breeze carries the salt-sweet scent of the ocean.

The cottage itself is small and sturdy, built from weathered gray stones that have stood against countless storms. Roses climb the eastern wall, their pink blooms nodding in the breeze. The red painted door stands slightly ajar, and through the gap, you can see the warm glow of lamplight.

Writing Exercises

Exercise 1: The Five-Sense Room

Describe a room using all five senses, at least two sentences per sense. Focus on comfort and safety.

Exercise 2: The Infinite List

Create a list of collection items (shells, books, tea cups) with gentle variations. Aim for 10+ items without tension.

Exercise 3: The Routine Ritual

Describe making tea in 300+ words, focusing on each micro-action and sensation.

Exercise 4: The Journey Nowhere

Write about traveling through landscape with no destination. Focus on what passes, not where you're going.

Quick Reference Checklist

  • Present tense or second person perspective
  • Soft consonants and flowing language
  • Rich sensory details without drama
  • Repetitive, predictable patterns
  • No cliffhangers or mysteries
  • Gentle pacing throughout
  • Comfortable, safe settings
  • Natural fade potential
  • Tested at 120-140 wpm reading speed
  • No sudden sounds or harsh words

Output Persistence

Output Discovery
  1. Check for context/output-config.md in the project
  2. If found, look for this skill's entry
  3. If not found, ask user: "Where should I save sleep story drafts?"
  4. Suggest: stories/sleep/ or explorations/stories/
Primary Output
  • Template used - Wandering observer, gentle routine, or infinite journey
  • Setting choice - Indoor sanctuary, natural space, or transitional
  • Sensory layers - Visual, auditory, tactile, olfactory details
  • Story draft - Complete narrative (10-15 minutes at 120-140 wpm)
File Naming

Pattern: {setting}-sleep-{date}.md

Verification (Oracle)

What This Skill Can Verify
  • Pacing test - Read at 120-140 wpm without rushing? (High confidence)
  • Language softness - Harsh consonants/sudden words absent? (High confidence)
  • Stakes absence - No tension, urgency, or mystery? (High confidence)
What Requires Human Judgment
  • Calming quality - Does it actually feel restful?
  • Sensory balance - Are layers appropriate for sleep induction?
  • Personal resonance - Will target audience connect with setting?
Oracle Limitations
  • Cannot assess whether story induces sleepiness
  • Cannot predict individual response to calming content

Feedback Loop

Show full SKILL.md (737 more words)Show less
Session Persistence
  • Output location: See context/output-config.md
  • What to save: Template, setting, sensory layers, final draft
  • Naming pattern: {setting}-sleep-{date}.md
Cross-Session Learning
  • Check for prior sleep stories to avoid repetition
  • Listener feedback on what worked/didn't
  • Failed calming attempts inform anti-patterns

Design Constraints

This Skill Assumes
  • Goal is sleep induction, not entertainment
  • Listener is trying to fall asleep
  • Audio or read-aloud delivery
This Skill Does Not Handle
  • Meditation scripts - Different structure and purpose
  • Regular fiction - Route to: prose-style
  • Ambient soundscapes - Not narrative-based
Degradation Signals
  • Hidden tension (deadline, mystery, stakes)
  • Engagement habits (hooks, rising action)
  • Resolution compulsion (need for ending)

Reasoning Requirements

Standard Reasoning
  • Single template selection
  • Basic sensory layer design
  • Simple pacing check
Extended Reasoning (ultrathink)
  • Full story development - [Why: all elements must sustain calming quality]
  • Custom setting creation - [Why: novel environments need complete design]
  • Series consistency - [Why: multiple stories in same world]

Trigger phrases: "write the complete sleep story", "create a new setting", "design a series"

Execution Strategy

Sequential (Default)
  • Template selection before setting
  • Setting before sensory layers
  • Layers before drafting
Parallelizable
  • Developing multiple settings
  • Creating sensory layer lists for different environments
Subagent Candidates
TaskAgent TypeWhen to Spawn
Setting researchgeneral-purposeWhen creating authentic real-world locations
Pacing analysisgeneral-purposeWhen testing reading speed and flow

Context Management

Approximate Token Footprint
  • Skill base: ~2.5k tokens (pillars + templates + techniques)
  • With settings: ~3.5k tokens
  • With exercises: ~4k tokens
Context Optimization
  • Focus on active template and setting
  • Sensory guide is reference
  • Exercises optional for learning
When Context Gets Tight
  • Prioritize: Five pillars, active template
  • Defer: Full settings list, all sensory layers
  • Drop: Writing exercises, example opening

Anti-Patterns

1. Disguised Drama

Pattern: Creating what appears to be a calming story but embedding subtle tension—a journey with an arrival deadline, a task with failure stakes, a mystery to solve. Why it fails: The human brain detects narrative tension even when it's mild. Listeners engage to see the outcome, which is the opposite of what sleep requires. Any "will they/won't they" question activates alertness. Fix: Eliminate all stakes. The journey has no destination. The task has no consequence. Nothing depends on anything. The story describes what is happening, not what might happen.

2. Engagement Habits

Pattern: Using techniques from regular fiction—plot hooks, character development, rising action—because they're what you know how to write. Why it fails: Good fiction keeps readers awake to find out what happens. Sleep stories must deliberately avoid what makes regular fiction work. Writing on autopilot produces the wrong kind of story. Fix: Consciously invert your instincts. If a sentence makes you want to know what happens next, that's a signal to revise. The best sleep story is one you'd never finish if you were trying to stay awake.

3. Sensory Jarring

Pattern: Including harsh sounds, sudden actions, or intense sensory descriptions even in otherwise calm narratives. Why it fails: A single "the door slammed" or "bright light flooded" can trigger alertness. Harsh consonants and sudden verbs create acoustic and mental disruption. Fix: Read aloud and listen for jarring moments. Replace every sudden word with a gradual one. Soften every hard consonant cluster. The acoustic texture should be as smooth as the content.

4. Speed Creep

Pattern: Unconsciously accelerating pacing as you write, sentences getting shorter, events moving faster. Why it fails: Faster pacing signals importance, which signals attention needed. The listener's nervous system responds to rhythm even when content is calm. Fix: Set a timer and read aloud. Aim for 120-140 words per minute—significantly slower than normal reading speed. If you're rushing, the listener's attention will follow.

5. Resolution Compulsion

Pattern: Feeling you must end the story properly, with conclusion and satisfaction. Why it fails: Endings create a wake-point. The listener who's drifting realizes "oh, it's ending" and snaps back to attention. The goal is for the story to continue forever or fade imperceptibly. Fix: Write stories that have no natural endpoint. The train journey continues. The garden walk goes on. The tea is always brewing. Structure the story so stopping at any point feels complete.

Integration

Inbound (feeds into this skill)
SkillWhat it provides
prose-styleSentence-level craft for flow and rhythm
worldbuildingCalm, safe settings to describe in detail
Outbound (this skill enables)
SkillWhat this provides
(specialized format - primarily terminal)Sleep stories are end products rather than inputs to other skills
Complementary
SkillRelationship
prose-styleSleep-story applies prose techniques with specific constraints; prose-style provides the underlying craft
voice-analysisUnderstanding voice patterns helps maintain consistent, calming tone throughout

© jwynia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/creative/fiction/application/sleep-story of jwynia/agent-skills.

Open the folder on GitHubat commit e02ec7e

Compare with similar skills

Sleep Story next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sleep Story compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sleep Story this skilljwynia/agent-skills170—~3.6kAutomated safety check: PassMIT
Coachfelixrieseberg/claude-coach1991 repos~4.9kAutomated safety check: PassMIT
Fitness Analyzerhuifer/WellAlly-health9605 repos~1.3kAutomated safety check: PassMIT
Master Ajahn Chahxr843/Master-skill4471 repos~2kAutomated safety check: PassCC-BY-NC-SA-4.0
Mental Health Analyzerhuifer/WellAlly-health9605 repos~3.2kAutomated safety check: PassMIT
Nutrition Analyzerhuifer/WellAlly-health9605 repos~3.3kAutomated safety check: PassMIT

Similar skills

  • Coach

    felixrieseberg/claude-coach

    Create personalized triathlon, marathon, and ultra-endurance training plans.

    199 GitHub starsUsed in 1 repo~4.9k tokens
    Productivity & AutomationAuto-check passed
  • Fitness Analyzer

    huifer/WellAlly-health

    分析运动数据、识别运动模式、评估健身进展,并提供个性化训练建议。支持与慢性病数据的关联分析. An agent skill from huifer/WellAlly-health.

    960 GitHub starsUsed in 5 repos~1.3k tokens
    Productivity & AutomationAuto-check passed
  • Master Ajahn Chah

    xr843/Master-skill

    A skill your agent uses when user asks about 南传佛教, 上座部, Theravada, 巴利经典, 正念 sati, 放下, 三法印, 四念处, 出入息念 anapanasati, 戒定慧, 毗婆舍那, 森林禅林派, 巴蓬寺, 阿姜查, 杜多行, 中道, or wants teaching in 阿姜查 Ajahn Chah's voice.

    447 GitHub starsUsed in 1 repo~2k tokens
    Productivity & AutomationAuto-check passed
  • Mental Health Analyzer

    huifer/WellAlly-health

    分析心理健康数据、识别心理模式、评估心理健康状况、提供个性化心理健康建议。支持与睡眠、运动、营养等其他健康数据的关联分析。

    960 GitHub starsUsed in 5 repos~3.2k tokens
    Productivity & AutomationAuto-check passed
  • Nutrition Analyzer

    huifer/WellAlly-health

    分析营养数据、识别营养模式、评估营养状况,并提供个性化营养建议。支持与运动、睡眠、慢性病数据的关联分析. An agent skill from huifer/WellAlly-health.

    960 GitHub starsUsed in 5 repos~3.3k tokens
    Productivity & AutomationAuto-check passed
  • Ghealth

    Google-Health-API/google-health-cli

    Query Google Health API v4 — steps, heart rate, exercise, sleep, weight, SpO2, HRV, ECG, blood glucose, nutrition, and 40 total data types

    266 GitHub stars~2.3k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed

More from jwynia/agent-skills

All 111 skills in this repo
  • Devcontainer

    jwynia/agent-skills

    Diagnose devcontainer configuration problems and guide development environment setup.

    170 GitHub stars~1.2k tokensUpdated 7 mo ago
    Auto-check: notes
  • Frontend Design

    jwynia/agent-skills

    Create distinctive, production-grade frontend interfaces with high design quality.

    170 GitHub stars~3.2k tokensUpdated 7 mo ago
    Auto-check passed
  • Gitea Workflow

    jwynia/agent-skills

    Orchestrate agile development workflows for Gitea repositories using the tea CLI.

    170 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Godot Asset Generator

    jwynia/agent-skills

    Generate game assets using AI image generation APIs (DALL-E, Replicate, fal.ai) and prepare them for Godot.

    170 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Mastra Hono

    jwynia/agent-skills

    Develop AI agents, tools, and workflows with Mastra v1 Beta and Hono servers.

    170 GitHub stars~2.9k tokensUpdated 7 mo ago
    Auto-check passed
  • PPTX Generator

    jwynia/agent-skills

    Create and manipulate PowerPoint PPTX files programmatically.

    170 GitHub stars~3.1k tokensUpdated 7 mo ago
    Auto-check passed

Questions about Sleep Story

What does Sleep Story do?

Write stories designed to help listeners fall asleep. An agent skill from jwynia/agent-skills. Sleep Story is an agent skill from jwynia/agent-skills. Write stories designed to help listeners fall asleep.

When should I use Sleep Story?

Sleep Story fits situations like: bedtime podcasts; meditation content; calming narratives; any content where the goal is gentle cognitive engagement that fades naturally into rest.

How do I install Sleep Story in Claude Code?

Run `npx skills add jwynia/agent-skills --skill sleep-story -a claude-code`. Or copy the skill folder (skills/creative/fiction/application/sleep-story in jwynia/agent-skills) into .claude/skills/sleep-story in your project. Claude Code loads it when a task matches its description.

How do I install Sleep Story in Codex?

Run `npx skills add jwynia/agent-skills --skill sleep-story -a codex`. Or copy the skill folder (skills/creative/fiction/application/sleep-story in jwynia/agent-skills) into .agents/skills/sleep-story in your project. Codex loads it when a task matches its description.

Can I use Sleep Story in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jwynia/agent-skills --skill sleep-story -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sleep-story, .gemini/skills/sleep-story, .github/skills/sleep-story and .opencode/skills/sleep-story in your project.

What does Sleep Story need to run?

SKILL.md names no scripts, command-line tools or credentials: Sleep Story is instructions for the agent only.

Does Sleep Story access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sleep Story safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sleep Story use?

Sleep Story is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sleep Story use?

About 3.6k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sleep Story?

Skills that share tags, products or a category with Sleep Story: Coach (felixrieseberg/claude-coach, 199 stars), Fitness Analyzer (huifer/WellAlly-health, 960 stars), Master Ajahn Chah (xr843/Master-skill, 447 stars) and Mental Health Analyzer (huifer/WellAlly-health, 960 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sleep Story?

jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 170 GitHub stars. The repository holds 111 skills in this directory. The repository was last updated on February 24, 2026.

Source: jwynia/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.