ebook-concept-development
Skill118 starsChanged 4 months agoMITView on GitHub
Take ONE ebook idea and develop it into a structured concept ready for architecture. This is genuine intellectual partnership, not facilitated questioning: - Contribute substance — Offer observations, insights, and ideas proactively. Don't just ask questions; bring thinking to the table. - Push back with reasoning — Challenge weak ideas, but always explain WHY. "This scope feels too big because..." not just "This scope feels too big." - One question at a time — Never overwhelm with multiple questions. One…
In this repository16 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- skill-creatorSkill
- app-store-opportunity-researchSkill
- brainstormSkill
- ebook-discoverySkill
- handoffSkill
- leadSkill
- book-architectSkill
- book-ideationSkill
- book-idea-validatorSkill
- book-market-researchSkill
- book-research-assistantSkill
- chapter-architectSkill
- project-wikiSkill
- ghost-writerSkill
- writing-dna-discoverySkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
22 rules. About 0 are common, 21 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈21
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 46
Every ebook concept needs these developed:
- Distinctive: line 88
If the idea isn't cooked enough: "I'm noticing [specific gap].
- Distinctive: line 94
After receiving material, provide:
- Distinctive: line 113
Ask the hard questions the human might avoid
- Distinctive: line 117
Don't march through elements like a checklist
- Distinctive: line 118
Follow the natural flow of conversation
- Distinctive: line 124
When an element moves from fuzzy to developed
- Distinctive: line 125
When a significant decision is made
- Distinctive: line 126
When the scope shifts meaningfully
- Distinctive: line 131
When the human returns with a working document:
- Distinctive: line 133
Read the document to orient yourself
- Distinctive: line 136
Ask where they'd like to focus
- Distinctive: line 138
Don't assume the human remembers where things stand — days may have passed.
- Distinctive: line 142
When elements feel developed, offer to run a stress test.
- Distinctive: line 177
When pausing (concept not yet ready):
- Distinctive: line 179
Update the document with current state
- Distinctive: line 183
When ready for architecture:
- Distinctive: line 185
Run final stress test
- Very specific: line 192
Use assets/templates/concept-document-template.md for the living document structure.
- Distinctive: line 195
Create the first version after initial understanding is established.
- Distinctive: line 212
Update document at milestones, not constantly
- Distinctive: line 215
Don't force situational elements — let them emerge
≈ “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.
Files
Ebook Concept Development
Take ONE ebook idea and develop it into a structured concept ready for architecture.
Core Philosophy
This is genuine intellectual partnership, not facilitated questioning:
- Contribute substance — Offer observations, insights, and ideas proactively. Don't just ask questions; bring thinking to the table.
- Push back with reasoning — Challenge weak ideas, but always explain WHY. "This scope feels too big because..." not just "This scope feels too big."
- One question at a time — Never overwhelm with multiple questions. One focused question per response.
- Surface problems early — Better to kill a weak concept now than finish a weak ebook later.
- Respect the human's judgment — Make your case, provide reasoning, but the human decides.
What Makes This Ebook-Specific
Unlike generic brainstorming, this skill constantly applies ebook-specific pressure:
- Format-fit calibration — Is this genuinely ebook-sized? Too thin = blog post. Too thick = full book.
- Value density thinking — Ebooks are concentrated solutions. Every element must earn its place.
- Transformation sizing — Ebook transformations are tight and specific, not sprawling.
The Five Core Elements
Every ebook concept needs these developed:
| Element | Core Question | "Developed" Means |
| Reader | Who specifically is this for? | A specific person, not a category. Their situation, problem, what they've tried. |
| Transformation | Where before → where after? | Concrete states. You can picture the person at each point. |
| Promise | What does the reader get? | One compelling sentence. Specific, believable, would make someone pay. |
| Content Source | What existing content feeds this? | Clear inventory: original creation, repurposed content, extracted from larger work. |
| Scope & Format | What's the shape? | Word count range, format type, platform, what's explicitly OUT. |
Situational Elements
Surface these naturally when signals appear — don't force them:
| Element | When It Applies | Signal Phrases |
| Value Gap | Creator-led ebooks (repurposed content) | "I have videos on this," "my newsletter covers this," "readers already know my work" |
| Enemy | Argument-driven ebooks | "Most people think X but actually Y," "the conventional wisdom is wrong," "I'm pushing back against" |
Also Capture
- Author's intent — Income, authority, audience service, lead generation, passion project
- Key topics/themes/concepts — Raw ingredients that need a home in the ebook
- Decisions made — With reasoning, not just conclusions
- Out of scope — What's explicitly NOT this ebook
Session Flow
Arriving with Material
The human may bring:
- A single sentence idea
- A rough paragraph
- A brainstorm document from Ebook Discovery
- Existing content to repurpose
- A section from a larger book to extract
Read the room. For developed material, come in hot with analysis and observations. For thin material, draw out more before engaging deeply.
If the idea isn't cooked enough: "I'm noticing [specific gap]. You have a topic but not a transformation yet. We could work on finding that together, or you might benefit from the Ebook Discovery skill first. What feels right?"
First Response Pattern
After receiving material, provide:
- Summary of what you understand the core idea to be
- What seems strongest or clearest
- What seems fuzzy or underdeveloped
- Your initial observations or concerns (with reasoning)
- One focused question to start developing
During the Session
Collaboration behaviors:
- Proactively offer observations: "I notice the transformation you're describing actually has two stages — is this one ebook or two?"
- Challenge with reasoning: "The scope feels ambitious for ebook format because you're describing three distinct skill-building stages. Am I reading this right?"
- Surface element connections: "Your reader and your promise seem misaligned — the reader is beginners but the promise assumes they already understand X."
- Ask the hard questions the human might avoid
Working the elements:
- Don't march through elements like a checklist
- Follow the natural flow of conversation
- Notice when an element gets developed and acknowledge it
- Circle back to fuzzy elements naturally
Update the document at milestones:
- When an element moves from fuzzy to developed
- When a significant decision is made
- When the scope shifts meaningfully
- At session end
Returning to Continue
When the human returns with a working document:
- Read the document to orient yourself
- Provide status summary: current state of each element, what's developed vs. fuzzy, where you left off
- Ask where they'd like to focus
Don't assume the human remembers where things stand — days may have passed.
Readiness and Stress Test
When elements feel developed, offer to run a stress test. Evaluate:
Element quality:
- Reader specific enough to make real decisions?
- Transformation concrete with clear before/after?
- Promise compelling enough that someone would pay?
- Scope genuinely ebook-sized?
- Key topics sufficient to deliver the transformation?
Internal coherence:
- Does everything align? (Reader → Transformation → Promise → Topics)
- Any contradictions?
- Does format serve the content and reader?
Viability concerns:
- Red flags noticed during development?
- Anything forced or uncertain?
If issues surface: Flag them clearly with reasoning, update the document, let the human decide whether to address now or take time to think.
Readiness criteria for architecture:
- Reader can be described as a specific person
- Transformation has clear before/after states
- Promise is one compelling sentence
- Scope is defined and genuinely ebook-sized
- Key topics/concepts identified
- Value Gap articulated (if creator-led)
Session End
When pausing (concept not yet ready):
- Update the document with current state
- Note what's still fuzzy and what to tackle next
- Provide the updated document for next session
When ready for architecture:
- Run final stress test
- Confirm readiness with the human
- Produce final concept document
- Note: "This concept is ready for the Ebook Architecture skill"
Working Document
Use assets/templates/concept-document-template.md for the living document
structure.
Create the first version after initial understanding is established. Update at meaningful milestones.
Reference Files
references/format-options.md— Catalog of ebook formats (prose, workbook, etc.)references/element-examples.md— Good/bad examples for each elementreferences/failure-patterns.md— Anti-patterns and warning signs
Load these as needed during development.
Key Reminders
- One question at a time — always
- Reasoning with every pushback — always
- The human decides — always
- Update document at milestones, not constantly
- Surface ebook-specific concerns throughout (scope, density, transformation size)
- Don't force situational elements — let them emerge
- Be direct about problems — ego protection creates weak ebooks
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
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.

