Agent skill

Book Ideation

by robertguss in robertguss/claude-code-toolkit

Develop raw book ideas into structured nonfiction book concepts.

ProprietaryAuto-check passedAgent Workflows

Install Book Ideation

skills CLI
$ npx skills add robertguss/claude-code-toolkit --skill book-ideation -a claude-code

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

GitHub CLI
$ gh skill install robertguss/claude-code-toolkit book-ideation --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/robertguss/claude-code-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/non-fiction-book-factory/book-ideation .claude/skills/book-ideation && 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
book-ideation
GitHub stars
123
Token cost
~2k tokens
SKILL.md length
1,002 words
Files
3 (incl. references, assets)
Skills in repo
16
Repo updated
First seen
Licence
Proprietary

At a glance

Develop raw book ideas into structured nonfiction book concepts.

  • Works in 8 steps: The Reader → The Transformation → The Core Thesis → …
  • The user wants to develop a book idea
  • SKILL.md covers Core Philosophy, Input Types, Session Flow and Quick Capture Mode, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Book Ideation is an agent skill from robertguss/claude-code-toolkit. Develop raw book ideas into structured nonfiction book concepts. Use when the user wants to develop a book idea, has brainstorm documents to refine into a book concept, wants to articulate a book's thesis/promise/reader/transformation, or needs to prepare a book concept for validation and market research. Nonfiction only. Produces a Book Concept Document with all elements needed for downstream skills (idea-validator, market-research, book-architect).

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files and assets (for example `assets/templates/book-concept-template.md` and `references/nonfiction-frameworks.md`).

It sits in Agent Workflows, covering Brainstorming, Essays and academic help and Market research. The repository describes itself as: A collection of custom skills that extend Claude's capabilities with specialized workflows, methods, and domain knowledge.

When your agent uses it

  • The user wants to develop a book idea
  • Has brainstorm documents to refine into a book concept
  • Wants to articulate a books thesis/promise/reader/transformation
  • Needs to prepare a book concept for validation and market research

Example prompts

  • “/book-ideation”

Workflow steps

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

  1. The Reader
  2. The Transformation
  3. The Core Thesis
  4. The Author Angle
  5. The Stakes
  6. The Key Concepts
  7. The Enemy
  8. The Promise

What it can do on your machine

Read from SKILL.md and the folder at commit f7fd35e. 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

Book Ideation loads about 2k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 117 tokens; SKILL.md has 1,002 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~117
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

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

Its licence (Proprietary) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,002 words (~1,992 tokens).

“Transform raw ideas into structured nonfiction book concepts through guided multi-session development.”

— opening of SKILL.md by robertguss, Proprietary
name
book-ideation
license
Proprietary
metadata.author
robertguss
metadata.version
1.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references, assets) in skills/non-fiction-book-factory/book-ideation of robertguss/claude-code-toolkit.

  • SKILL.md
  • assets/templates/book-concept-template.md
  • references/nonfiction-frameworks.md

Open the folder on GitHubat commit f7fd35e

Compare with similar skills

Book Ideation 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.

Book Ideation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Book Ideation this skillrobertguss/claude-code-toolkit123—~2kAutomated safety check: PassProprietary
Creative Directorsmixs/creative-director-skill248—~5.1kAutomated safety check: PassCC-BY-4.0
Audience ResearchTheCraigHewitt/skills157—~2.4kAutomated safety check: PassMIT
Structured Brainstorming and ResearchLigphiDonk/Oh-my--paper7381 repos~4.7kAutomated safety check: PassMIT
Idea Generation And Ideationsocial-media-skills/skills128—~2.1kAutomated safety check: PassMIT
Co MarketingNexus-JPF/note-companion8703 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • Creative Director

    smixs/creative-director-skill

    AI creative director with recursive self-assessment. An agent skill from smixs/creative-director-skill.

    248 GitHub stars~5.1k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Audience Research

    TheCraigHewitt/skills

    When the user wants to understand their YouTube audience, mine viewer psychology, analyze demographics, or find content-market fit signals.

    157 GitHub stars~2.4k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Runs structured brainstorming and research sessions with SCAMPER, SWOT and mind-map techniques, bundled templates and helper scripts, saving outputs in the project.

    738 GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Idea Generation And Ideation

    social-media-skills/skills

    The idea-system craft — never run out of content ideas by running a system instead of waiting for inspiration.

    128 GitHub stars~2.1k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Co Marketing

    Nexus-JPF/note-companion

    When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities.

    870 GitHub starsUsed in 3 repos~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Brand Ideation

    rampstackco/claude-skills

    Generate, evaluate, and narrow brand concepts during early ideation including positioning territories, naming candidates, mood directions, and narrative angles.

    941 GitHub stars~2.4k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from robertguss/claude-code-toolkit

All 16 skills in this repo
  • Brainstorm

    robertguss/claude-code-toolkit

    Collaborative brainstorming partner for multi-session ideation projects.

    123 GitHub stars~1.7k tokensUpdated 22 days ago
    Auto-check passed
  • Voice Capture

    robertguss/claude-code-toolkit

    This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style.

    123 GitHub stars~1.7k tokensUpdated 22 days ago
    Auto-check passed
  • Dhh Writing

    robertguss/claude-code-toolkit

    This skill should be used when writing in the distinctive style of David Heinemeier Hansson (DHH).

    123 GitHub stars~1.6k tokensUpdated 22 days ago
    Auto-check passed
  • Pragmatic Writing

    robertguss/claude-code-toolkit

    This skill should be used when writing technical content in the style of Hunt/Thomas (The Pragmatic Programmer) and Joel Spolsky (Joel on Software).

    123 GitHub stars~1.5k tokensUpdated 22 days ago
    Auto-check passed
  • Writing Orchestration

    robertguss/claude-code-toolkit

    This skill should be used when orchestrating complex writing workflows with multiple phases.

    123 GitHub stars~1.9k tokensUpdated 22 days ago
    Auto-check passed
  • App Store Opportunity Research

    robertguss/claude-code-toolkit

    Full-pipeline iOS App Store opportunity research. An agent skill from robertguss/claude-code-toolkit.

    123 GitHub stars~5.6k tokensUpdated 22 days ago
    Auto-check passed

Questions about Book Ideation

What does Book Ideation do?

Develop raw book ideas into structured nonfiction book concepts. Book Ideation is an agent skill from robertguss/claude-code-toolkit. Develop raw book ideas into structured nonfiction book concepts.

When should I use Book Ideation?

Book Ideation fits situations like: the user wants to develop a book idea; has brainstorm documents to refine into a book concept; wants to articulate a books thesis/promise/reader/transformation; needs to prepare a book concept for validation and market research.

How do I install Book Ideation in Claude Code?

Run `npx skills add robertguss/claude-code-toolkit --skill book-ideation -a claude-code`. Or copy the skill folder (skills/non-fiction-book-factory/book-ideation in robertguss/claude-code-toolkit) into .claude/skills/book-ideation in your project. Claude Code loads it when a task matches its description.

How do I install Book Ideation in Codex?

Run `npx skills add robertguss/claude-code-toolkit --skill book-ideation -a codex`. Or copy the skill folder (skills/non-fiction-book-factory/book-ideation in robertguss/claude-code-toolkit) into .agents/skills/book-ideation in your project. Codex loads it when a task matches its description.

Can I use Book Ideation 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 robertguss/claude-code-toolkit --skill book-ideation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/book-ideation, .gemini/skills/book-ideation, .github/skills/book-ideation and .opencode/skills/book-ideation in your project.

What does Book Ideation need to run?

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

Does Book Ideation 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 Book Ideation 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 Book Ideation use?

Book Ideation carries a proprietary licence (declared in SKILL.md). It is published on GitHub, but it is not open source: read the licence file before using or sharing it.

How many tokens does Book Ideation use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Book Ideation?

Skills that share tags, products or a category with Book Ideation: Creative Director (smixs/creative-director-skill, 248 stars), Audience Research (TheCraigHewitt/skills, 157 stars), Structured Brainstorming and Research (LigphiDonk/Oh-my--paper, 738 stars) and Idea Generation And Ideation (social-media-skills/skills, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Book Ideation?

robertguss (a GitHub user) maintains it in robertguss/claude-code-toolkit, which has 123 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 16, 2026.

Source: robertguss/claude-code-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.