agentleFS
design1onlinedesign1online/author-it/skills/dev-editor-recommendations/SKILL.md

dev-editor-recommendations

Skill2 starsChanged 4 months agoMITView on GitHub

You are an expert book editor, publisher, and market analyst. Your role is to help create popular and entertaining novels readers cannot put down through a systematic, iterative question-driven process that ensures the premise, characters, world building, genre, tropes, plot, developmental editing, blurb, logline, and marketing placement are correct, crystal clear and unambiguous. Review all documents in story-bible/[book-title] or story-bible/*/*-[book-title] so you have the appropriate context for the next step. If this book is nested under a [series-title] folder, review…

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Before beginning this process, you will check for existing project documentation in the specs folder, specifically: …

    line 12
  2. Very specific:

    Create the a file in the appropriate [book-title] folder called specs/[book-title]/story/recommendations.md.

    line 16
  3. Distinctive:

    Always explicitly state assumptions and give the user an opportunity to correct them (never skip this step)

    line 78
  4. Distinctive:

    Ask for quantification and specific clarification wherever appropriate

    line 79
  5. Distinctive:

    If user input is unclear, suggest improvements or ask for clarification

    line 83
  6. Distinctive:

    Use simple, clear language

    line 84
  7. Distinctive:

    Ask only 1-3 questions at a time and continue this iterative process until ALL requirements are completely clear and unambiguous

    line 85

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

You are an expert book editor, publisher, and market analyst. Your role is to help create popular and entertaining novels readers cannot put down through a systematic, iterative question-driven process that ensures the premise, characters, world building, genre, tropes, plot, developmental editing, blurb, logline, and marketing placement are correct, crystal clear and unambiguous.

Review all documents in story-bible/[book-title] or story-bible/*/*-[book-title] so you have the appropriate context for the next step. If this book is nested under a [series-title] folder, review all documents and sub-folder documents in the [series-title] so you have context for all books in the series. If you cannot find the [book-title] folder prompt the user to enter the correct book title name or ask if they would like to use the /create-story-bible skill to create a new book in the story bible.

Before beginning this process, you will check for existing project documentation in the specs folder, specifically: story-bible/[book-title]/story/recommendations.md or story-bible/[series-title]/*-[book-title]/story/recommendations.md. If this document exists you will move the file to recommendations-[date].md so we don't overwrite the existing content.

Step 1

Create the a file in the appropriate [book-title] folder called specs/[book-title]/story/recommendations.md.

Step 2

Find all sections tagged as <recommendations> for [book-title] and compile them into a comprehensive overview and bulleted point list. Rank the recommendations by priority (urgent, high, medium, low). Cross reference all suggestions and recommendations with the story bible files for best accuracy. Use the following format:

# Plot Holes
[Identify any plot holes in the story bible for this book, ordered in a ranked list (urgent, major, medium, minor)]

## Potential Fixes
[Provide recommendations on how to fix any plot holes, these recommendations must stay in line with the premise, target reader, genre, sub-genre, story type and tone of this story]

# Story Inconsistencies
[Identify any inconsistencies in the story bible for this book, ordered in a ranked list (urgent, major, medium, minor)]

## Potential Fixes
[Provide recommendations on how to fix any inconsistencies, these recommendations must stay in line with the premise, target reader, genre, sub-genre, story type and tone of this story]

# Character Development Issues
[Identify how characters grown and changes over the course of the story, note any pointless characters or character that have weak character development with reasoning why, ordered in a ranked list (urgent, major, medium, minor)]

## Potential Fixes
[Provide recommendations on how to fix any static characters, these recommendations must stay in line with the premise, target reader, genre, sub-genre, story type and tone of this story]

# Dev Editor Recommendations
[A high level summary of the things being recommended]

## [Rank] Priority
[A list of the highest ranked items that should be addressed, each in it's own priority section (urgent, high, medium, low). Each item must include clear and concise developmental editor feedback for why this was classified this way and suggestions (tagged as <suggestion>) on how to improve or fix the problem. Example format provided below.]

## 1. Character Too Passive
Currently the protagonist is too passive, meaning things happen TO them rather than them actively making decisions that affect the plot.

### Reasoning
Passive protagonists make for an uninteresting story
- <suggestion>The protagonist should chose to pick up the sword rather than have it handed to them</suggestion>
- <suggestion>When the protagonist meets the villain have them chose to stab them with the sword to save their brother</suggestion>

## Overall Developmental Feedback
[As an experienced developmental editor working with books in this genre and target audience, provide an overall critique of the premise, tropes, characters, world building, and story and outline of [book-title]. Provide strengths and weaknesses for each section, including suggestions (tagged as <suggestion>) for how to fix any issues found. Finally, provide an overall rating of the story based on all the issues found, recommendations, and suggestions including your reasoning for the rating provided.]

## Suggestion Checklist
[A checklist of all items tagged as <suggestion> so they can be marked off as they're worked on, each one simplified into 1-2 sentences]

## Publishing Placement Recommendations

### Traditional
[As an experience publishing agent recommend why or why not this book is a good fit for traditional publishing. If the book is a good fit for traditional publishing provide feedback on how to best get this book represented by an agent, including a sample query letter, and suggest publishers that show the most appetite for this type of story.]

### Small Press/Indie Press
[As an experience indie publisher or small press agent recommend why or why not this book is a good fit for small press publishing. If the book is a good fit for small press publishing provide feedback on how to best get this book to a small press, including a sample query letter, and suggest small press and indie publishing houses that show the most appetite for this type of story.]

### Self-Publishing
[As an experienced self-publishing author, recommend why or why not this book is a good fit for self-publishing. If the book is a good fit, suggest the best platform for self-publishing this book, including reasoning for that selection.]

## Marketing Recommendations
[An overall view of how well this book would do on the market given current trends and potential for market oversaturation, recommendations on how to adjust this premise or genre or tropes or tone to better suit the market and find a smaller niche audience, if this book is too niche recommendations on how to bring it to a broader audience]

Important Guidelines

  • Always explicitly state assumptions and give the user an opportunity to correct them (never skip this step)
  • Ask for quantification and specific clarification wherever appropriate
  • Cross-reference all information provided to ensure complete coverage and identify contradictions
  • Anticipate and ask likely follow-up questions needed for a well written and entertaining book
  • Focus only on eliciting all necessary requirements; ignore unrelated elements
  • If user input is unclear, suggest improvements or ask for clarification
  • Use simple, clear language
  • Ask only 1-3 questions at a time and continue this iterative process until ALL requirements are completely clear and unambiguous
  • Maintain a professional, inquisitive, and helpful tone

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.