Ckokoski/Fibb

# Market Research Skill

Help authors understand their market and position their books for success.

## Comp Title Analysis
- Find 3-5 comparable titles in the same genre/subgenre
- Analyze: cover style, blurb structure, pricing, reviews, ranking
- Identify what readers love and hate about comps
- Find the gap your book fills

## Genre Trend Analysis
- Current bestseller patterns in the target genre
- Emerging subgenres and tropes
- What's oversaturated vs. underserved

# Promotion & Marketing Copy Skill

Help authors write compelling marketing copy that sells books.

## Blurb / Book Description
- **Hook Line**: One sentence that creates immediate curiosity
- **Setup**: Introduce the protagonist and their world (2-3 sentences)
- **Conflict**: What goes wrong? What's at stake? (2-3 sentences)
- **Escalation**: Why can't they just walk away? (1-2 sentences)
- **Cliffhanger**: End with a question or tension that demands the reader buy the book
- **Comp Line**: "Perfect for fans of [Author A] and [Author B]"

## Amazon/KDP Description
- Use HTML formatting (bold, italic, line breaks)

# Query Letter Skill

Help authors write query letters that get requests from literary agents.

## Query Letter Structure (250-400 words total)

### 1. Hook (1-2 sentences)
Your strongest logline. Make the agent NEED to know more.

### 2. Story Summary (150-200 words)
- Introduce protagonist with a defining trait
- What's their normal world?
- What disrupts it? (inciting incident)
- What must they do? (goal)

# Series Bible Skill

Manage continuity across multiple books in a series.

## Series-Level Tracking

### Overarching Series Arc
- Series premise and central conflict
- How the series-level stakes escalate across books
- Series-level theme that deepens with each book
- Planned number of books and role of each

### Character Arcs Across Books
- Where each character starts (Book 1) and ends (final book)

# Full Novel Pipeline

You are orchestrating the creation of a complete novel. This is a multi-phase process that takes a seed idea and produces a full manuscript.

## Pipeline Phases

When planning steps for a full novel, use ALL of these phases in order:

### Phase 1: Premise Development
- Develop the seed concept into a strong premise
- Create a compelling logline (1-2 sentences)
- Identify core conflict, stakes, theme, and tone
- Skill: `premise`

# Preference Learner — Core Skill

Every author is different. This skill builds a living profile of the user's preferences, habits, and working style — then applies it to every interaction so AuthorClaw feels increasingly personalized.

## What Gets Learned

### Writing Preferences
```yaml
writing:
  # Detected from user revisions and feedback
  dialogue_tags: "simple (said/asked only)"
  description_density: "moderate (1-2 sensory details per scene)"
  paragraph_length: "short (2-4 sentences)"
  chapter_length: "2500-3500 words"

# Skill Acquisition

You are AuthorClaw's self-learning module. When the user says "go learn about X" or
"add a skill for Y", you research the topic using the Research Gate, draft a new
SKILL.md file, and present it for the user's review before saving.

## Workflow

### Step 1: Understand the Request
Parse what the user wants you to learn. Clarify if needed:
- **Topic**: What capability should the new skill provide?
- **Category**: Is this a `core`, `author`, or `marketing` skill?
- **Scope**: What specific tasks should the skill handle?

# Email List Marketing Skill

Help authors build and nurture their email list.

## Welcome Sequence (5-7 emails)
1. **Delivery** — Here's your free book/bonus + personal intro
2. **Story** — Your origin story as a writer (build connection)
3. **Value** — Exclusive content, sneak peek, or reading rec
4. **Engagement** — Ask a question, invite to reply
5. **Soft sell** — Introduce your books naturally
6. **Social proof** — Reader testimonials and reviews
7. **Direct ask** — "If you've been curious about [book], now's the time"

## Launch Sequence (7-10 emails over 2 weeks)

# Social Media Marketing Skill

Create platform-specific promotional content for authors.

## Platform-Specific Content

### Twitter/X (280 chars)
- Hook + micro-pitch + link
- Quote from book (under 15 words) + "From my upcoming [genre]"
- Engagement: "What's your favorite [trope]?"
- Behind-the-scenes: Writing stats, process reveals

### Instagram / Bookstagram
- Aesthetic flat-lay caption ideas

# Book Launch Machine — Premium Skill

A complete book launch system that generates everything you need from 30 days before launch to 30 days after.

## The 60-Day Launch Timeline

### Phase 1: Pre-Launch (Days -30 to -7)

**Week 1 (Days -30 to -24)**
Auto-generates:
- [ ] Cover reveal social posts (Twitter, Instagram, Facebook, TikTok script)
- [ ] Cover reveal email to list
- [ ] Pre-order setup checklist (platform-specific)
- [ ] ARC team recruitment email

# Comp Title Finder — Premium Skill

Find perfect comparable titles for query letters, Amazon categories, marketing copy, and positioning strategy. Stop guessing — know exactly where your book fits in the market.

## Comp Title Discovery

Feed it your manuscript details and get strategic comp title recommendations:

### Input
```yaml
book:
  title: "The Silent Hour"
  genre: "Psychological Thriller"
  subgenre: "Domestic Suspense"

# Dictation Cleanup — Premium Skill

Transform messy speech-to-text output into polished, publish-ready prose. Built for authors who dictate their drafts — because dictation is the fastest way to write, but cleaning it up shouldn't take longer than typing it would have.

## The Problem

Speech-to-text gives you something like this:
```
so she walked into the room and um the light was kind of flickering you know
like one of those old fluorescent lights and she could smell something weird
like copper maybe or no more like rust and old pennies and she knew comma she
just knew that something was wrong period new paragraph Marcus was sitting in
the corner but he wasn't really sitting he was more like slumped and his eyes
were open but they weren't seeing anything quote hello question mark close

# First Chapter Hook — Premium Skill

Analyze, score, and rewrite your first chapter to maximize reader retention. Because if your first page doesn't hook them, they never see page two.

## Hook Score Analysis

Paste your first chapter and get a detailed hook assessment:

```
First Chapter Hook Score: "The Silent Hour" — Chapter 1

Overall Hook Score: 72/100

╔══════════════════════════════════════════════════╗

# Ghostwriter Pro — Premium Skill

Advanced AI co-writing tools that go far beyond basic drafting.

## Scene Generator

Generate complete scenes with cinematic precision:

### Input
```yaml
scene:
  chapter: 12
  pov_character: "Elena"
  location: "The Compound - Server Room"

# Narrative Voice Coach — Premium Skill

Your personal writing coach focused entirely on voice — the thing that makes YOUR writing unmistakably yours. Analyzes your prose at the sentence level, identifies your natural strengths, spots inconsistencies, and helps you develop a voice so distinctive that readers recognize you by paragraph two.

## The 47-Marker Voice Analysis

Goes far beyond basic readability scores. Analyzes 47 distinct markers of writing voice:

### Rhythm & Cadence (12 markers)
```
Voice Rhythm Analysis: "The Silent Hour"
Sample: Chapters 1-5 (22,000 words)

Avg Sentence Length:     14.3 words  (Genre avg: 16.2)

# Read Aloud — Premium Skill

Turn your manuscript into speech using free, open-source text-to-speech. Hear your prose the way a reader would — because the ear catches what the eye misses.

## Why Read Aloud?

Every professional editor will tell you: **read your work aloud.** It reveals:
- Awkward phrasing that looks fine on screen
- Sentences that are too long to speak in one breath
- Repeated words your eye skips but your ear catches
- Dialogue that sounds unnatural when spoken
- Pacing problems that only rhythm reveals
- Tongue-twisters and consonant clusters

# Sensitivity Reader — Premium Skill

AI-assisted sensitivity review that flags potential representation issues, cultural inaccuracies, stereotypes, and reader-concern areas before publication. Not a replacement for human sensitivity readers — but a powerful first pass that catches the obvious issues and helps you ask the right questions.

## Important Disclaimer

This tool is an AI assistant, not a cultural authority. It can identify patterns and flag potential concerns, but it cannot fully replicate the lived experience of a human sensitivity reader. For published works, we strongly recommend also working with human readers from relevant communities.

## What It Catches

### Representation Patterns
- **Stereotyping** — Characters reduced to cultural/racial/gender tropes
- **Token representation** — Single diverse character without depth
- **White savior patterns** — Majority-group character "saving" minority characters

# Series Architect — Premium Skill

The complete system for planning, tracking, and maintaining multi-book series.

## Series Planning Wizard

Interactive step-by-step series creation:

### Step 1: Series Concept
- Series premise (the overarching "what if")
- Genre and subgenre
- Target audience
- Planned number of books
- Series type: sequential, standalone-connected, or anthology

# Deep Voice Analysis — Premium Skill

Advanced writing voice analysis that goes far beyond the free style-clone skill. Analyzes your writing across 47 markers to create a forensic-level Voice Profile.

## What Makes This Different From the Free Style-Clone Skill

The free `style-clone` skill does a basic voice analysis (~10 markers). This premium skill runs a **47-marker deep analysis** that captures the invisible patterns that make YOUR writing yours — the kind of patterns that fool AI detectors because they encode genuine human writing habits.

## The 47 Markers

### Rhythm Markers (12)
1. Average sentence length (words)
2. Sentence length variance (burstiness)
3. Short sentence frequency (1-5 words)

# Book Bible Engine Bridge

Seamlessly import data from Writing Secrets' Book Bible Engine into AuthorClaw's memory system.

## Supported Import Formats

This skill reads the JSON export from Book Bible Engine and maps it directly into AuthorClaw's book-bible memory structure.

## JSON Schema Expected

```json
{
  "title": "Book Title",
  "characters": [

# Author Workflow Engine Bridge

Import prompt sequence JSON files from the Author Workflow Engine and execute them as AuthorClaw automations.

## What This Does

The Author Workflow Engine (AWE) lets you build multi-step prompt chains — like "research → premise → outline → write chapter 1." This bridge imports those chains and runs them inside AuthorClaw with full access to your book bible, voice profile, and memory.

## JSON Schema Expected

```json
{
  "name": "Novel Outline Generator",
  "description": "Takes a premise and generates a complete outline",

# Beta Reader Simulation Skill

Provide feedback from simulated reader perspectives. Not a replacement for real beta readers, but useful for catching issues early.

## Reader Perspectives

### The Genre Fan
- Reads 50+ books/year in this genre
- Knows all the tropes and expectations
- Will notice if conventions are broken (for better or worse)
- Cares about: pacing, payoff, satisfying ending

### The Casual Reader
- Reads 10-15 books/year across genres

# Book Bible Skill

Maintain a living reference document for the book's world. Every fact, character detail, and timeline event goes here so nothing contradicts itself.

## Book Bible Sections

### Characters
For each character track:
- **Name** (full, nicknames, aliases)
- **Physical**: Age, appearance, distinguishing features
- **Personality**: Core traits, flaws, quirks, speech patterns
- **Background**: History, education, occupation, family
- **Motivation**: What they want (surface), what they need (deep)
- **Arc**: How they change from beginning to end

# Continuity Check Skill

Scan a manuscript (or set of chapters) for internal inconsistencies. This is not a style review — the goal is to catch factual contradictions within the text itself.

## What to Check

### 1. Character Consistency
- **Physical descriptions**: Eye color, hair, height, scars, tattoos — flag if described differently in two places.
- **Age and aging**: Does a character's stated age match the timeline? Do children age appropriately between scenes set years apart?
- **Abilities and limitations**: A character who can't swim in chapter 3 shouldn't be diving in chapter 12 without explanation.
- **Personality and knowledge**: Flag moments where a character suddenly knows something they shouldn't, or behaves in a way that contradicts established traits without narrative justification.
- **Relationships**: If two characters are introduced as strangers, they shouldn't reference shared history later (unless a reveal is intended).

### 2. Timeline and Chronology

# Cover Designer

Generate a coordinated set of book covers in the standard sizes an author
needs to ship across every retail platform — all from one visual brief, so
the ebook, print, audiobook, and social-banner versions look cohesive.

## Sizes produced

| Variant | Dimensions | What it's for |
|---|---|---|
| **Ebook** | 1024×1536 (2:3) | Amazon Kindle / KDP listings, BookBub thumbnails, Goodreads |
| **Print** | 1024×1536 (2:3) | Front cover for paperback / hardcover (6×9 trim). Spine + back wrap added separately in your designer. |
| **Audiobook** | 1024×1024 (1:1) | ACX / Findaway / Spotify. Upscale to 2400×2400 before submitting. |
| **Social** | 1536×1024 (3:2) | Twitter / X cards, Facebook OG, BookBub feature graphics, newsletter headers |

# Dialogue Skill

Help authors write dialogue that sounds like real people talking — each character distinct, every line doing double duty.

## Dialogue Principles

1. **Every character sounds different** — vocabulary, rhythm, pet phrases, education level, regional speech
2. **Subtext over text** — People rarely say exactly what they mean
3. **Dialogue is action** — Each line should advance plot, reveal character, or build tension
4. **Less is more** — Cut greetings, small talk, and filler unless they serve a purpose
5. **Read it aloud** — If it sounds wrong spoken, it reads wrong too

## Character Voice Differentiation

# Formatting & Export Skill

Convert manuscripts into publication-ready formats.

## Supported Formats

### Standard Manuscript Format (for agents/editors)
- 12pt Times New Roman or Courier
- Double-spaced, 1-inch margins
- Header: Author Name / Title / Page #
- Scene breaks: centered # or ***
- Chapter breaks: new page, centered title

### EPUB (for ebook distribution)

# Tool Ingestion — Code to Skill Converter

Read source code of any external tool and generate a proper AuthorAgent SKILL.md file.

## Process

1. **Read the source code** provided by the user (file path or pasted code)
2. **Analyze the tool**:
   - Purpose and domain (writing, formatting, marketing, analysis)
   - Inputs: arguments, config files, stdin
   - Outputs: files, stdout, formats
   - Language: Python, JavaScript, HTML, etc.
   - CLI interface and flags (if any)
   - Dependencies required

# Manuscript Hub

Central command for managing writing projects.

## New Project Setup
When starting a new project, create:
```
projects/[project-name]/
├── premise.md
├── outline/
├── chapters/
├── characters/
├── research/
├── submissions/

# Nonfiction Research Skill

Comprehensive research support for nonfiction authors.

## Source Management
- Track all sources with full citation data
- Organize by chapter/topic
- Flag primary vs. secondary sources
- Note source reliability and potential bias

## Citation Formats
Support: APA, MLA, Chicago (Notes & Bibliography), Chicago (Author-Date), Harvard
Auto-generate bibliography/works cited in the author's preferred format.

# Outline Skill

Help authors create detailed, actionable outlines for their books.

## Available Frameworks

### Save the Cat! (Blake Snyder)
15 beats: Opening Image, Theme Stated, Setup, Catalyst, Debate, Break into Two, B Story, Fun & Games, Midpoint, Bad Guys Close In, All Is Lost, Dark Night of the Soul, Break into Three, Finale, Final Image

### Three-Act Structure
Act 1 (25%): Setup, Inciting Incident, First Plot Point
Act 2A (25%): Rising Action, Fun & Games, Midpoint
Act 2B (25%): Complications, All Is Lost, Dark Moment
Act 3 (25%): Climax, Resolution, Denouement

# Premise Development

Help authors develop compelling premises that hook readers and sell books.

## Premise Formula

**A [CHARACTER] must [GOAL] before [STAKES], but [OBSTACLE] stands in the way.**

## Development Process

1. **The Seed** — Start with the author's initial idea
2. **The "What If"** — Crystallize into a powerful what-if question
3. **Character + Want** — Who is the protagonist and what do they desperately need?
4. **Stakes** — What happens if they fail? (Make it personal AND universal)

# Research Skill

You are a research assistant for authors. Help them gather accurate information for their writing.

## Research Types

### Fiction Research
- Historical period details (clothing, language, technology, social norms)
- Location details (geography, culture, climate, architecture)
- Technical details (weapons, vehicles, medical procedures, legal processes)
- Cultural details (customs, food, religion, daily life)

### Nonfiction Research
- Academic sources (Google Scholar, PubMed, JSTOR)

# Revision Skill

Provide multi-layer editing support. Each pass serves a different purpose.

## Revision Passes

### Pass 1: Developmental Edit (Big Picture)
- Does the story arc work?
- Are character motivations clear and consistent?
- Is the pacing right? (Too slow? Too rushed?)
- Do the stakes escalate properly?
- Are subplots resolved?
- Is the theme woven through the narrative?
- Are there plot holes or contradictions?

# Style Clone Skill

Analyze the author's writing to create a quantitative Voice Profile, then use it
to match their style.

> **Use the gateway's analyzer — do NOT hand-roll a freeform analysis.**
> AuthorAgent already ships a 47-marker voice analyzer as a first-class service
> (`StyleCloneService`). It is deterministic, cheap (no AI call), and returns a
> structured `StyleProfile` plus an AI system prompt you can apply to every
> drafting/revision task. This skill's job is to CALL that service and save the
> result — not to re-describe the analysis in prose. A parallel markdown-only
> pass would drift from the real analyzer and produce a worse, unquantified
> profile.

# Writing / Drafting Skill

Draft text that matches the author's voice, serves the story, and follows the style guide.

## Before Writing, Always Check
1. **Voice Profile** — Match their sentence patterns, vocabulary, rhythm
2. **Style Guide** — Follow their rules (POV, tense, word avoidance list)
3. **Book Bible** — Maintain consistency with established facts
4. **Outline** — Follow the planned beats for this scene/chapter
5. **Character voices** — Each character speaks differently

## Drafting Approach
- Write in the author's voice, not a generic AI voice
- Focus on sensory details and emotional truth

# After-Action Review — Core Skill

A structured reflection process that runs after every completed goal. Extracts concrete lessons, evaluates output quality, identifies what worked and what didn't, and feeds everything into the self-improvement loop.

## When It Runs

- **Automatically** after any goal completes (all steps done)
- **On request** when the user says "review goal" or "what went well"
- **Periodically** as part of a weekly self-assessment (if autonomous mode is enabled)

## The Review Process

### Step 1: Gather Context

# Error Recovery — Core Skill

When things go wrong, AuthorAgent doesn't just report the error — it diagnoses the root cause, attempts automatic recovery, and remembers the fix for next time.

## Error Categories

### 1. AI Provider Errors

**Symptoms**: API timeouts, rate limits, auth failures, model unavailability
```
Error Detected: Gemini API returned 429 (rate limited)

Diagnosis: Too many requests in short period (>60/min)
Recovery Strategy:

# Preference Learner

Track user preferences across writing habits, communication style, and working patterns.

## How Preferences Are Learned

1. **Explicit statements** (highest priority):
   - "I prefer first person POV"
   - "I never want adverbs"
   - "I always want short chapters"

2. **Observed patterns**:
   - User consistently shortens chapters → learn "short chapters preferred"
   - User always removes dialogue tags → learn "minimal dialogue tags"

# Prompt Optimizer — Core Skill

AuthorAgent's prompts are its most important tool. This skill continuously optimizes them based on what actually produces good results — not guesswork, but measured outcomes.

## The Problem

Every skill, goal step, and system prompt contains prompts. Some work great. Some produce mediocre results. Without measurement, you're flying blind. The Prompt Optimizer tracks which prompt formulations produce the best outputs and evolves them over time.

## How It Works

### Prompt Tracking

Every prompt sent to an AI provider is logged with its outcome:

# Self-Improvement Loop — Core Skill

AuthorAgent gets better every time it works. This skill creates a persistent learning loop where the agent tracks what works, what fails, and what the user prefers — then applies those lessons to future tasks.

## How It Works

### The Loop

```
  ┌─────────────────────────────┐
  │                             │
  │    1. DO THE WORK           │
  │    (goal step, writing,     │
  │     research, etc.)         │

# Skill Acquisition

AuthorAgent's self-learning module. Research topics, draft new SKILL.md files,
and present them for user review before saving.

## Workflow

### Step 1: Understand the Request
- Parse: What topic? What category (core/author/marketing/ops)?
- Assess: Is this genuinely new or does an existing skill cover it?

### Step 2: Research
- Use the Research Gate to gather information from allowlisted domains
- Maximum 5 web fetches per skill acquisition session

# Ad Copy Skill

Write high-converting ad copy for book advertising.

## Amazon AMS Ads
- **Headline**: 150 chars max. Lead with genre hook or social proof.
- **Custom text**: 150 chars. Benefit or curiosity gap.
- Target: genre keywords, comp author names, trope keywords

## BookBub Featured Deal
- 500 chars max description
- Must match BookBub's tone (enticing, professional)
- Include genre-appropriate hooks
- End with intrigue, not resolution

# Blurb Writer

Craft blurbs that make readers click "Buy Now."

## Blurb Formula (Fiction)
1. **Hook** — One explosive sentence
2. **Character** — Who are we rooting for? What makes them relatable?
3. **Setup** — What's their world? What do they want?
4. **Inciting Incident** — What goes catastrophically wrong?
5. **Stakes** — What happens if they fail? (Personal + universal)
6. **Cliffhanger** — End with a question that DEMANDS the reader buy the book
7. **Social Proof** — Comp line or review quote

## Blurb Formula (Nonfiction)

# Marketing Research

Surfaces concrete book-marketing opportunities for an author's specific
genre / subgenre / book. Built on top of AuthorAgent's existing
`research-lookup` (Perplexity Sonar Pro via direct or OpenRouter), so
every result comes back with verified live-web citations the author can
cross-check before pitching.

## What this skill researches

The skill takes a structured query and turns it into a real research
request:

| Type | What gets surfaced |

# Website Publisher

The management layer on top of AuthorAgent's static-site builder. Generates
your site, keeps it in sync with your books, drafts blog posts from your
project artifacts, and pushes the rendered site to your host.

This skill is **deliberately not a CMS**. AuthorAgent is for producing books
— shipping a working site is part of that, but maintaining a fully
interactive web property isn't. Authors who need comments, forms, ESP
integration UIs, or deep analytics should keep using the WordPress /
Squarespace / Ghost they already have.

## What it does

# Browser Automation

AuthorAgent is a **planner-first** agent. It builds the plan, surfaces it
through the confirmation gate, and lets a human-supervised browser executor
do the actual clicking. AuthorAgent itself does NOT drive a browser
directly — that responsibility lives in whichever browser MCP the user has
connected (typically `Claude in Chrome`).

## How a real-world automation flow works

1. User asks AuthorAgent to do something irreversible: "publish my book on
   KDP", "kick off the AMS campaign", "submit to BookBub"
2. AuthorAgent plans the action and emits a **ConfirmationRequest** with:
   - Risk level + reversibility

# Decision Maker

Help the user make structured decisions by evaluating options systematically.

## Workflow

### Step 1: Frame the Decision
- Identify the decision clearly: "Which X should I choose?"
- List all available options (2-5 options ideal)
- Identify the criteria that matter most to the user

### Step 2: Build a Decision Matrix
Evaluate each option against these dimensions:
- **Impact**: How much does this move the needle? (1-5)

# Orchestrator Management

Manage scripts and background processes through AuthorAgent's built-in orchestrator.

## Capabilities

- **Start/Stop/Restart** individual scripts or all scripts
- **Health Monitoring** with automatic PID checks every 30 seconds
- **Auto-Restart** for scripts configured with autoRestart (up to maxRestarts times)
- **Log Viewing** — last 500 lines of stdout/stderr in a ring buffer
- **Dynamic Configuration** — add, update, or remove scripts via dashboard or API

## Script Configuration

# Task Planner

Break complex tasks into actionable, ordered steps with effort estimates.

## Workflow

### Step 1: Understand the Goal
- Identify the end state (what does "done" look like?)
- Identify constraints (time, budget, skills, tools)
- Identify deadlines or milestones

### Step 2: Decompose
Break into specific, ordered steps that are:
- **Specific**: Clear enough that someone could execute without asking follow-up questions