mystery-novel-conventions
A framework for crafting suspense, detective, and mystery narratives, emphasizing fair play principles, clue placement, and plot structure.
Introduction
The mystery-novel-conventions skill provides a rigorous structural framework for authors and writers tasked with developing engaging mystery, detective, crime, and suspense narratives. It is designed for AI agents assisting with creative writing, offering a systematic approach to pacing, clue distribution, and logical consistency. By integrating this skill, users can ensure their stories adhere to the 'Fair Play' mystery tradition, where the reader is presented with the same evidence as the detective, enabling them to solve the puzzle independently if they are sufficiently observant. The skill covers the entire narrative arc from the initial hook to the final reveal, helping creators manage suspects, red herrings, and complex character motivations effectively.
-
Essential structural guidance for mystery arcs, including the 'Dark Night of the Soul' at 75-85% and the final resolution.
-
Implementation of 'Fair Play' principles, ensuring no mechanical deus ex machina solutions or withheld key evidence.
-
Strategic clue distribution frameworks (physical, testimonial, behavioral) categorized by visibility levels (obvious, subtle, hidden in plain sight).
-
Management of suspects, including archetypes like the 'sympathetic suspect' and methods for handling red herrings to maintain suspense.
-
Sub-genre specific adaptations covering Cozy Mystery, Hardboiled, Police Procedural, and Locked Room puzzles.
-
Integration workflows for '/specify', '/plan', '/write', and '/analyze' commands to support iterative narrative development.
-
Inputs typically include plot premises, character lists, or specific narrative segments; outputs include structural critiques, plot timeline adjustments, and logical verification of clues.
-
The agent acts as a narrative editor, identifying common pitfalls such as incompetent detectives, reliance on coincidence rather than logic, and rushed explanations.
-
Designed for use alongside creative writing tools or IDEs where narrative planning is required.
-
Adheres to standard mystery genre tropes to satisfy reader expectations for intelligent, solvable puzzles while maintaining surprise.
Repository Stats
- Stars
- 181
- Forks
- 24
- Open Issues
- 4
- Language
- Python
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- Apr 29, 2026, 12:55 PM