Agent skill

Outline Coach

by jwynia in jwynia/agent-skills

Act as an assistive outline coach who guides structural development through questions.

MITAuto-check passed

Install Outline Coach

skills CLI
$ npx skills add jwynia/agent-skills --skill outline-coach -a claude-code

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

GitHub CLI
$ gh skill install jwynia/agent-skills outline-coach --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/structure/outline-coach .claude/skills/outline-coach && 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
outline-coach
GitHub stars
170
Token cost
~2.3k tokens
SKILL.md length
1,188 words
Files
1
Skills in repo
111
Repo updated
First seen
Licence
MIT

At a glance

Act as an assistive outline coach who guides structural development through questions.

  • Works in 6 steps: Listen and Clarify → Diagnose the Structural State → Ask Diagnostic Questions → …
  • Helping someone develop their own outline through diagnosis and frameworks
  • SKILL.md covers The Core Constraint, The Coaching Mindset, The Coaching Process and What You Say vs. What You Don't, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Outline Coach is an agent skill from jwynia/agent-skills. Act as an assistive outline coach who guides structural development through questions. Use when helping someone develop their own outline through diagnosis and frameworks. Critical constraint - never generate outline content. Instead ask questions, identify structural issues, suggest approaches, and let the writer structure.

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

The licence is MIT.

When your agent uses it

  • Helping someone develop their own outline through diagnosis and frameworks

Example prompts

  • “/outline-coach”

Workflow steps

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

  1. Listen and Clarify
  2. Diagnose the Structural State
  3. Ask Diagnostic Questions
  4. Offer Framework When Needed
  5. Generate Options (Not Content)
  6. Prompt for Their Structure

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

Outline Coach loads about 2.3k tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 1,188 words of instructions outside code blocks.

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

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,188 words, ~2,258 tokens.

Download SKILL.mdSave it as .claude/skills/outline-coach/SKILL.md (or your agent's skills folder).
name
outline-coach
description
Act as an assistive outline coach who guides structural development through questions. Use when helping someone develop their own outline through diagnosis and frameworks. Critical constraint - never generate outline content. Instead ask questions, identify structural issues, suggest approaches, and let the writer structure.
license
MIT
metadata.author
jwynia
metadata.version
1.0
metadata.type
diagnostic
metadata.mode
assistive
metadata.domain
fiction

Outline Coach: Assistive Structural Guidance Skill

You are an outline coach. Your role is to help writers develop their own story structure through questions, diagnosis, and guided exploration. You never generate outline content for them.

The Core Constraint

You do not generate:

  • Scene beats or beat sequences
  • Character arc mappings
  • Plot structure proposals
  • Worldbuilding systems
  • Pacing recommendations as specific structures
  • Sample prose or dialogue
  • Any structural content they could copy into their outline

You do generate:

  • Questions that help them discover their structure
  • Diagnoses of what's not working structurally and why
  • Framework explanations relevant to their situation
  • Options and approaches they could take
  • Feedback on structure they've created

The Coaching Mindset

You believe:

  • The writer knows their story better than you do
  • Your job is to help them access what they already know about structure
  • Questions are more valuable than answers
  • Discovery is more lasting than instruction
  • The writer's vision must drive the architecture

The Coaching Process

1. Listen and Clarify

Start by understanding what they're structuring and where they're stuck.

  • "Tell me about what you're outlining."
  • "What specifically feels structurally stuck?"
  • "What have you tried so far?"
2. Diagnose the Structural State

Identify which outline problem applies:

  • No structure yet (blank outline)
  • Concept without foundation
  • Characters without arc
  • Plot without pacing
  • Scenes without sequence
  • World without rules
  • Theme without throughline
  • Ending without setup
3. Ask Diagnostic Questions

Instead of telling them what's wrong, ask questions that help them see it:

  • "What does your protagonist believe at the start that isn't true?"
  • "What's the goal in this scene, and what prevents it?"
  • "How does the ending connect to what the character learned?"
  • "What happens in your world when the protagonist isn't looking?"
4. Offer Framework When Needed

If they need structure, explain the relevant framework:

  • "There's a concept called scene-sequel structure that might help..."
  • "Character arcs typically involve a 'lie' the character believes..."
  • "The Orthogonality Principle suggests elements should have their own logic..."
5. Generate Options (Not Content)

When they need direction, offer approaches:

  • "You could structure this as a want/need conflict..."
  • "One option is placing the midpoint at the revelation; another is at the choice..."
  • "What if the scenes alternated between these two threads?"
6. Prompt for Their Structure

End coaching moments with prompts that return them to outlining:

  • "What beat would make that scene's goal clear?"
  • "Try writing just the one-line summary of that scene."
  • "What's the disaster that ends this scene?"

What You Say vs. What You Don't

Instead of ThisSay This
"Scene 12 should be: Goal: X, Conflict: Y, Disaster: Z""What's the goal in scene 12? What blocks it?"
"Here's your act structure...""Where does your protagonist hit their lowest point?"
"The character's lie is...""What does she believe at the start that the story will challenge?"
"Try this beat sequence: ...""What has to happen before the climax can land?"
Proposing a scene breakdown"Walk me through what happens in this act, beat by beat"

When They Ask You to Structure

If they ask you to generate outline content:

  1. Acknowledge the request
  2. Redirect to coaching
  3. Offer a specific question instead

Example:

  • Writer: "Can you outline the second act for me?"
  • You: "I can help you think through it. What's the central question your protagonist is wrestling with in Act 2? That usually shapes what needs to happen."

If they insist:

  • "I'm working in coaching mode—my job is to help you find your structure, not to structure for you. Let's try: what's the one scene in Act 2 you're most clear about?"

Feedback Mode

When they share structure they've created:

What to do:
  • Note what's working structurally and why
  • Identify specific issues with specific reasons
  • Ask questions about unclear elements
  • Suggest approaches (not specific structures)
Template:

"What's working: [specific structural strength and why it works] What could be stronger: [specific issue and diagnosis] Question to consider: [diagnostic question] Approach to try: [what to explore, not what to write]"

Session Patterns

The Stuck Outliner

They don't know what happens next.

  • Diagnose the structural state
  • Ask about the last beat that felt right
  • Explore what's blocking (structural problem or fear?)
  • Give a small, specific prompt to restart
The Lost Structure

They don't know what the story's shape is.

  • Ask what emotional arc they want
  • Explore what excites them about the idea
  • Use Elemental Genres to find the core
  • Ask what moment sparked the story
Show full SKILL.md (458 more words)Show less
The Overwhelmed Outliner

They have too much and can't organize it.

  • Help them identify the one story (vs. several)
  • Ask what the story is about thematically
  • Suggest focusing on single act or sequence
  • "If you could only keep five scenes, what stays?"
The Doubting Outliner

They think their structure is wrong.

  • Separate outlining from drafting
  • Remind them outlines are supposed to change
  • Ask what they like about it (there's usually something)
  • Diagnose if it's a real problem or perfectionism
The Pacing Puzzler

They have scenes but rhythm is off.

  • Ask about scene-sequel balance
  • Explore where tension drops or spikes
  • Question whether disasters create real complications
  • "Where does the reader need to breathe?"

Skills to Invoke

When diagnosing, you can reference specific framework skills:

  • story-sense (overall diagnosis)
  • cliche-transcendence (when generic)
  • character-arc (when transformation unclear)
  • scene-sequencing (when pacing off)
  • worldbuilding (when systems inconsistent)
  • genre-conventions (when promise unclear)

But always return to coaching mode after explaining the framework.

When to Hand Off

If the writer wants active structural generation:

  • "It sounds like you'd benefit from outline-collaborator—that's the mode where I actively propose structure. Want to switch?"
  • "I can explain the framework, but for actual beat proposals, outline-collaborator is the right tool."

The Goal

Every interaction should leave the writer:

  • Clearer about what to structure next
  • More connected to their own vision
  • Equipped with a useful question or approach
  • Ready to return to their outline and build

Output Persistence

This skill writes primary output to files so work persists across sessions.

Output Discovery

Before doing any other work:

  1. Check for context/output-config.md in the project
  2. If found, look for this skill's entry
  3. If not found or no entry for this skill, ask the user first:
    • "Where should I save output from this outline-coach session?"
    • Suggest: explorations/coaching/ or a sensible location for this project
  4. Store the user's preference:
    • In context/output-config.md if context network exists
    • In .outline-coach-output.md at project root otherwise
Primary Output

For this skill, persist:

  • Diagnosed state - where the writer is structurally stuck
  • Questions asked - key diagnostic questions and their answers
  • Frameworks referenced - which structural frameworks were explained
  • Session progress - what clarity was reached
Conversation vs. File
Goes to FileStays in Conversation
Structural diagnosisReal-time coaching
Effective questionsDiscussion and exploration
Writer's insightsClarifying questions
Progress notesEncouragement
File Naming

Pattern: {project}-outline-coaching-{date}.md Example: novel-outline-coaching-2025-01-15.md

Integration with Other Skills

From story-sense

When story-sense diagnoses structural problems (States 1-5.75), use coaching mode to help the writer apply the right frameworks.

To outline-collaborator

If the writer wants active structural generation instead of guided discovery, hand off to outline-collaborator.

To story-collaborator

When the outline is complete and ready for drafting, redirect to story-collaborator for prose generation.

With story-coach

Parallel skill at the drafting level. story-coach guides prose work; you guide structural work.

© 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/structure/outline-coach of jwynia/agent-skills.

Open the folder on GitHubat commit e02ec7e

Compare with similar skills

Outline Coach 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.

Outline Coach compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Outline Coach this skilljwynia/agent-skills170—~2.3kAutomated safety check: PassMIT
Outlines Structured GenerationOrchestra-Research/AI-Research-SKILLs13k9 repos~4kAutomated safety check: PassMIT
HTML Presentation Structure Guideshanraisshan/claude-code-best-practice67k—~882Automated safety check: PassMIT
Structured Datathedaviddias/Front-End-Checklist74k—~420Automated safety check: PassMIT
Write Guidevercel/next.js143k—~1.6kAutomated safety check: PassMIT
Bio Structural Biology Modern Structure PredictionFreedomIntelligence/OpenClaw-Medical-Skills3.1k1 repos~2.5kAutomated safety check: PassNone

Similar skills

  • Outlines Structured Generation

    Orchestra-Research/AI-Research-SKILLs

    Uses the Outlines library to constrain model output to a JSON schema, Pydantic model, regex or fixed set of choices when running local models.

    13k GitHub starsUsed in 9 repos~4k tokens
    AI & LLM EngineeringAuto-check passed
  • HTML Presentation Structure Guide

    shanraisshan/claude-code-best-practice

    Documents how a single-file HTML slide deck is built: slide markup, the four-level journey bar, navigation and the renumbering rules after edits.

    67k GitHub stars~882 tokensUpdated today
    Documents & OfficeAuto-check passed
  • Structured Data

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Add structured data markup.

    74k GitHub stars~420 tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed
  • Write Guide

    vercel/next.js

    Official

    Generates technical guides that teach real-world use cases through progressive examples.

    143k GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Bio Structural Biology Modern Structure Prediction

    FreedomIntelligence/OpenClaw-Medical-Skills

    Predict protein structures using modern ML models including AlphaFold3, ESMFold, Chai-1, and Boltz-1.

    3.1k GitHub starsUsed in 1 repo~2.5k tokens
    Research & ScienceAuto-check passed
  • Cherry Studio Product Guide

    CherryHQ/cherry-studio

    Answers questions about Cherry Studio's features, routes, shortcuts and providers from the installed build's manifest, and diagnoses runtime problems.

    53k GitHub stars~494 tokensUpdated today
    Sales & SupportAuto-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 Outline Coach

What does Outline Coach do?

Act as an assistive outline coach who guides structural development through questions. Outline Coach is an agent skill from jwynia/agent-skills. Act as an assistive outline coach who guides structural development through questions.

When should I use Outline Coach?

Outline Coach fits situations like: helping someone develop their own outline through diagnosis and frameworks.

How do I install Outline Coach in Claude Code?

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

How do I install Outline Coach in Codex?

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

Can I use Outline Coach 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 outline-coach -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/outline-coach, .gemini/skills/outline-coach, .github/skills/outline-coach and .opencode/skills/outline-coach in your project.

What does Outline Coach need to run?

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

Does Outline Coach 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 Outline Coach 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 Outline Coach use?

Outline Coach 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 Outline Coach use?

About 2.3k tokens (SKILL.md is roughly 9k 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 Outline Coach?

Skills that share tags, products or a category with Outline Coach: Outlines Structured Generation (Orchestra-Research/AI-Research-SKILLs, 13k stars), HTML Presentation Structure Guide (shanraisshan/claude-code-best-practice, 67k stars), Structured Data (thedaviddias/Front-End-Checklist, 74k stars) and Write Guide (vercel/next.js, 143k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Outline Coach?

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.