\n\n### Author's Core Frameworks\n- **<Framework Name>**: <what it is and when to apply>\n\n### Key Principles\n- <Principle>: <actionable rule>\n\n### Techniques & Methods\n- <Technique>: <step-by-step or how-to>\n\n### Anti-patterns\n- <What to avoid>: <why>\n\n### Suggested Skill Name\n`{author-lastname}-{core-concept}` — e.g. `cialdini-influence`\n\n### Chapters Detected\n| # | Title | Main Frameworks |\n```\n\n---\n\n## Step 4 — Ask purpose (Full Conversion only)\n\nBefore generating, ask the user:\n\n> \"What should this skill help you do? (Pick one or more)\n> 1. Apply the author's frameworks while working\n> 2. Think with the author's mental models\n> 3. Reference specific chapters and concepts\n> 4. All of the above\"\n\nUse the answer to weight what gets highlighted in the SKILL.md Core section.\n\n**Derive `DEPTH` from the answer (no extra prompt):**\n- Answer is **only** option 3 (reference) → `DEPTH=reference` — lean, fast-lookup chapters.\n- Answer includes option 1, 2, or 4 → `DEPTH=study` — deeper chapters with more worked detail, examples, and reasoning.\n\n`DEPTH` and `BOOK_TYPE` together set the per-chapter token budget in Step 7. Do **not** ask a separate \"study vs reference\" question — it is inferred here. (In Modes 2/3, where Step 4 is skipped, default `DEPTH=study`.)\n\n---\n\n## Step 5 — Determine skill name\n\nIf `SKILL_NAME` was provided, use it as the skill slug.\nOtherwise, propose two options and let the user choose:\n- **By author-concept**: `{author-lastname}-{core-concept}` (e.g. `cialdini-influence`, `meadows-systems`)\n- **By title**: lowercase hyphens from book title (e.g. `designing-data-intensive-apps`)\n\nDefault to author-concept format if the book has a strong methodological identity.\n\nChoose the destination skill root (`SKILLS_HOME`). Probe the user's filesystem for existing skill homes and pick by **the host the user is running in**:\n\n| Host agent | Personal skill root (probe in order) | Project-local root |\n|---|---|---|\n| **GitHub Copilot CLI** | `~/.copilot/skills` → `~/.agents/skills` | `.github/skills` → `.claude/skills` → `.agents/skills` |\n| **Amp** | `~/.agents/skills` → `~/.config/agents/skills` → `~/.config/amp/skills` | `.agents/skills` |\n| **Claude Code** | `~/.claude/skills` | `.claude/skills` |\n\nSelection rules:\n1. If **exactly one** of the host's candidate roots exists on disk, use it without asking.\n2. If **none** exist (fresh machine), ask the user which root to create — present the host-appropriate options and remember the choice for the session. Do not silently pick.\n3. If the user explicitly asked for project-local output, prefer the project-local row.\n4. If you cannot identify the host, ask: \"Which agent are you running this in — GitHub Copilot CLI, Amp, or Claude Code?\"\n\nSet `SKILLS_HOME` to the selected root and check if `$SKILLS_HOME/<skill_name>/` already exists.\nIf it does, prompt the user to choose:\n1. **Update / Fold-in** (Mode 4) — integrate new files/content into the existing skill components.\n2. **Overwrite** — delete and regenerate the skill from scratch.\n3. **Rename** — append `-2` or use a different custom slug.\n\nIf the user selects **Update / Fold-in**, proceed immediately to the **Update / Fold-in Workflow** section after Step 2.5 (skipping Steps 3, 4, 6, 7, 8, 9).\n\n---\n\n## Step 6 — Create skill directory structure\n\n```bash\nmkdir -p \"$SKILLS_HOME/<skill_name>/chapters\"\n```\n\n---\n\n## Step 7 — Generate chapter summaries\n\n**TOKEN BUDGET RULE — CRITICAL (adaptive):**\n\nThe per-chapter budget scales with `BOOK_TYPE` and `DEPTH`. Technical chapters need room for code and tables; study depth needs room for worked reasoning. Pick the budget from this matrix:\n\n| | `DEPTH=reference` | `DEPTH=study` |\n|---|---|---|\n| `BOOK_TYPE=text` | 800–1,200 tokens | 1,000–1,800 tokens |\n| `BOOK_TYPE=technical` | 1,200–1,800 tokens | 2,000–3,000 tokens |\n\n- These are per-file targets, not hard caps — a dense chapter may run over, a thin one under. Density still beats length (Quality Rule #3): never pad to hit a number.\n- Files are loaded on-demand, so a larger chapter only costs tokens when that chapter is actually read.\n- When in doubt between two cells (e.g. mixed-content book), use the lower budget and let depth come from precision, not volume.\n\n**`DEPTH=study` is earned with content, not a bigger number.** The standard section template (Core Idea → Connects To) naturally lands a dense prose chapter around 700–900 tokens. To reach the study budget *honestly* — not by padding — a study-depth chapter must add concrete material:\n- **Reproduce one worked example or artifact** from the chapter (e.g. the example press release, a sample dialogue, a filled-in template, a decision the author walks through) under a `## Worked Example` section. This is the single biggest lever and the main thing a learner returns for.\n- **Expand the \"How\" of each framework** into explicit steps or criteria, not a one-liner.\n- **Add a short \"Why it works / failure mode\" note** to the top 1–2 frameworks.\n\nIf a chapter genuinely has no worked example and resists expansion, let it land below the study floor rather than padding — and note that the chapter is thin in its Core Idea. A `reference`-depth chapter, by contrast, deliberately omits worked examples and keeps only the decision-ready essentials.\n\nFor EACH chapter/major section identified in Step 3:\n\nRead the corresponding section of the extracted `full_text.txt` (use character offsets or grep for chapter headings).\n\nCreate `$SKILLS_HOME/<skill_name>/chapters/ch<NN>-<slug>.md` using the structure below.\n\n**Adapt emphasis based on `BOOK_TYPE`:**\n- `technical` → prioritize \"Code Examples\", \"Reference Tables\", and \"Commands & APIs\" sections; preserve exact syntax\n- `text` → prioritize \"Frameworks Introduced\", \"Mental Models\", and \"Key Takeaways\"; skip empty technical sections\n\n```markdown\n# Chapter N: <Full Title>\n\n## Core Idea\n<1–2 sentences: the single most important thing this chapter teaches>\n\n## Frameworks Introduced\n- **<Framework Name>**: <exact formulation — preserve the author's naming>\n - When to use: <specific situation>\n - How: <steps or criteria>\n\n## Key Concepts\n- **<Term>**: <precise definition in 1 sentence>\n(5–10 most important terms from this chapter)\n\n## Mental Models\n<2–4 frameworks or thinking tools. Write as \"Use X when Y\" or \"Think of X as Y\">\n\n## Anti-patterns\n- **<What to avoid>**: <why it fails>\n\n## Code Examples *(technical books only — omit if BOOK_TYPE=text)*\n\n```<language>\n<key code example from this chapter>\n```\n- **What it demonstrates**: <one line>\n\n## Reference Tables *(technical books only — omit if BOOK_TYPE=text)*\n\n\n## Worked Example *(DEPTH=study only — omit for DEPTH=reference)*\n\n\n## Key Takeaways\n1. <Actionable insight>\n2. <Actionable insight>\n3. <Actionable insight>\n(3–7 takeaways a practitioner must remember)\n\n## Connects To\n- **Ch N**: <why this chapter relates>\n- **<Concept>**: <external concept or standard it connects with>\n```\n\n---\n\n## Step 8 — Generate supporting files\n\n### glossary.md\nCreate `$SKILLS_HOME/<skill_name>/glossary.md`:\n- Every significant term from the book, alphabetically sorted\n- Format: `**Term** — definition (Ch N)`\n- Max 1,500 tokens\n\n### patterns.md\nCreate `$SKILLS_HOME/<skill_name>/patterns.md`:\n- All concrete techniques, design patterns, algorithms from the book\n- Format: `## Pattern Name\\n**When to use**: ...\\n**How**: ...\\n**Trade-offs**: ...`\n- Max 2,000 tokens\n\n### cheatsheet.md\nCreate `$SKILLS_HOME/<skill_name>/cheatsheet.md`:\n\n**This is the most differentiated layer of the skill — treat it as a reasoning aid, not a keyword list.** Anyone can grep the glossary for a term. The cheatsheet captures the author's *judgment*: the decisions they'd make and why. It's the file that turns \"I know the words\" into \"I'd act the way the author would\".\n\nPrioritize, in order:\n1. **Decision rules** — \"When X, do Y, because Z.\" The if/then logic the author applies, stated so the reader can apply it without re-reading the book.\n2. **Decision trees / flowcharts** (as nested bullets or a small table) — for choices with more than two branches.\n3. **Trade-off matrices** — competing options scored on the dimensions the author cares about, so the reader can pick under their own constraints.\n4. **Thresholds & defaults** — the specific numbers, ratios, or rules of thumb the author commits to (e.g. \"keep functions under ~20 lines\", \"alert when error budget < 10%\").\n5. **Tells & smells** — fast heuristics for recognizing a situation (\"if you see X, you're probably in trouble Y\").\n\nAvoid: bare term→definition rows (that's the glossary), and prose paragraphs (that's the chapters). Every line should help the reader *decide* something.\n\n- Format mostly as compact tables and decision rules; the content you'd want on a single printed page kept beside you while working.\n- Max 1,200 tokens.\n\n---\n\n## Step 9 — Generate the master SKILL.md\n\n**CRITICAL TOKEN BUDGET: Keep SKILL.md body under 4,000 tokens.**\nCompaction truncates from the END — put the most important content FIRST.\n\nCreate `$SKILLS_HOME/<skill_name>/SKILL.md`:\n\n```markdown\n---\nname: <skill_name>\ndescription: \"Knowledge base from \\\"<Full Title>\\\" by <Author(s)>. Use when applying <author>'s frameworks for <key topics, 3–6 terms>, studying the book, or referencing its concepts.\"\n---\n\n\n\n# <Full Title>\n**Author**: <Author(s)> | **Pages**: ~<N> | **Chapters**: <N> | **Generated**: <YYYY-MM-DD>\n\n## How to Use This Skill\n\n- **Without arguments** — load core frameworks for reference\n- **With a topic** — ask about `replication`, `pricing`, or another indexed topic; I find and read the relevant chapter\n- **With chapter** — ask for `ch05`; I load that specific chapter\n- **Browse** — ask \"what chapters do you have?\" to see the full index\n\nWhen you ask about a topic not covered in Core Frameworks below, I will read\nthe relevant chapter file before answering.\n\n---\n\n## Core Frameworks & Mental Models\n\n\n<generate 2,000 tokens of the most critical frameworks and insights here>\n\n---\n\n## Chapter Index\n\n| # | Title | Key Frameworks |\n|---|-------|----------------|\n| [ch01](chapters/ch01-<slug>.md) | <Title> | <framework1>, <framework2> |\n| [ch02](chapters/ch02-<slug>.md) | <Title> | <framework1>, <framework2> |\n...\n\n## Topic Index\n\n\n- **<Term>** → ch<N>[, ch<N>]\n- **<Term>** → ch<N>\n\n## Supporting Files\n\n- [glossary.md](glossary.md) — all key terms with definitions\n- [patterns.md](patterns.md) — all techniques and design patterns\n- [cheatsheet.md](cheatsheet.md) — quick reference tables and decision guides\n\n---\n\n## Scope & Limits\n\nThis skill covers the book content only. For hands-on implementation in your codebase,\ncombine with project-specific tools. For topics beyond this book, check related skills\nor ask the agent directly.\n```\n\n---\n\n## Step 9.5 — Scan the generated skill\n\nBefore reporting success, loading the skill in another session, or publishing it, run the advisory security scan:\n\n```bash\nSKILL_CONVERTER_ROOT=\"$(cd \"$(dirname \"$SCRIPT_PATH\")/..\" && pwd)\"\n\"$PYTHON_BIN\" \"$SKILL_CONVERTER_ROOT/tools/scan_generated_skill.py\" \"$SKILLS_HOME/<skill_name>\"\n```\n\nIf the scanner exits non-zero, stop and ask a human to review its file/line findings. Do not silently rewrite the generated files, and do not load or publish the skill until the findings are resolved or explicitly accepted.\n\n---\n\n## Step 10 — Cleanup and report\n\n```bash\nPYTHON_BIN=\"${PYTHON_BIN:-python3}\"\nif ! command -v \"$PYTHON_BIN\" >/dev/null 2>&1; then\n PYTHON_BIN=\"python\"\nfi\n\n\"$PYTHON_BIN\" - <<'PY'\nimport os\nimport shutil\nimport tempfile\nfrom pathlib import Path\nshutil.rmtree(\n os.environ.get(\"BOOK_SKILL_WORKDIR\", Path(tempfile.gettempdir()) / \"book_skill_work\"),\n ignore_errors=True,\n)\nPY\n```\n\nThen report to the user:\n\n```\n✅ Skill created: $SKILLS_HOME/<skill_name>/\n\n📚 Book: <Full Title> — <Author>\n📄 Pages: ~<N> | Chapters: <N>\n\nFiles generated:\n SKILL.md — core frameworks + index (~X tokens)\n chapters/ — <N> chapter summaries (~X tokens each, ~X total)\n glossary.md — key terms (~X tokens)\n patterns.md — techniques & patterns (~X tokens)\n cheatsheet.md — quick reference (~X tokens)\n ─────────────────────────────────────────────────────\n Total skill size: ~X tokens (loaded on-demand, not all at once)\n\n💡 Tip: check your agent's session cost/usage command to see actual token usage.\n\nUsage:\n Ask for <skill_name> → load core frameworks\n Ask <skill_name> about <topic> → find and explain a topic\n Ask <skill_name> for ch<N> → dive into a specific chapter\n\nReload (if your agent doesn't auto-detect new skills):\n GitHub Copilot CLI: /skills reload\n Claude Code: restart the session\n Amp: restart the session\n\nShare this skill (Copilot ecosystem, optional):\n gh skill publish $SKILLS_HOME/<skill_name>\n```\n\n---\n\n## Update / Fold-in Workflow\n\nWhen performing an Update/Fold-in operation on an existing skill at `$SKILLS_HOME/<skill_name>/`:\n\n### 1. Read Existing Skill Structure\nRead and parse the existing skill's files:\n- Read `$SKILLS_HOME/<skill_name>/SKILL.md` to parse the existing **Chapter Index**, **Topic Index**, metadata (author, total chapters), and **Core Frameworks**.\n- List all files in `$SKILLS_HOME/<skill_name>/chapters/` to find the highest chapter number (e.g. `ch12`).\n- Read `$SKILLS_HOME/<skill_name>/glossary.md`, `$SKILLS_HOME/<skill_name>/patterns.md`, and `$SKILLS_HOME/<skill_name>/cheatsheet.md` to see what terms and frameworks are already indexed.\n\n### 2. Match Content & Identify Revisions vs. Additions\nAnalyze the new extracted text in `<tempdir>/book_skill_work/full_text.txt` to identify if the new content represents:\n- **Updates/Revisions to existing chapters**: If a section of the new content directly updates or expands an existing chapter's topic, read the existing chapter file, merge the new details into it, and rewrite the file.\n- **New additions**: If the content introduces new chapters, papers, or separate sections, create **new chapter summary files** under `chapters/`. Start numbering these files after the highest existing chapter number (e.g. if the existing chapters stop at `ch12`, create `ch13-*.md`, `ch14-*.md`, etc.).\n\n### 3. Generate or Update Chapter Summary Files\nFor each new or revised chapter:\n- Read the corresponding section of the extracted new text.\n- Follow the formatting guidelines in **Step 7** to build the summary.\n- Write/update the file in `$SKILLS_HOME/<skill_name>/chapters/`.\n\n### 4. Merge Supporting Files\n- **Merge glossary.md**:\n - Read the existing `$SKILLS_HOME/<skill_name>/glossary.md`.\n - Extract all new terms and definitions from the new content (Step 8 glossary guidelines).\n - Combine and alphabetize the list of existing and new terms.\n - If a term already exists, append the new chapter/source references to it (e.g. `**Term** — definition (Ch 4, Ch 13)`).\n - Rewrite `$SKILLS_HOME/<skill_name>/glossary.md` with the fully merged, alphabetized list.\n- **Merge patterns.md**:\n - Read existing `$SKILLS_HOME/<skill_name>/patterns.md`.\n - Extract any new techniques, algorithms, or patterns from the new content.\n - Append the new patterns, ensuring consistent formatting, and keeping the total length concise (under 2,500 tokens).\n- **Merge cheatsheet.md**:\n - Read existing `$SKILLS_HOME/<skill_name>/cheatsheet.md`.\n - Extract new comparison rules, decision tables, or parameter guides.\n - Integrate them cleanly into the cheatsheet structure.\n\n### 5. Re-generate the Master SKILL.md\nUpdate the master skill file `$SKILLS_HOME/<skill_name>/SKILL.md`:\n- **Metadata**: Increment the chapter count, update the estimated page count, and add the new source names if appropriate. Update the `Generated` date to the current date.\n- **Core Frameworks**: Fold in the most high-impact mental models or principles from the new content (ensuring the overall file remains under 4,000 tokens).\n- **Chapter Index**: Append the new chapters to the index table, linking to the newly created files.\n- **Topic Index**: Merge the new topics alphabetically. If an existing topic is also covered in the new chapters, append the new chapter links to its line (e.g. `- **Topic** → ch05, ch13`).\n\n### 6. Scan, Cleanup, and Report\nOnce the files are successfully written and merged, run **Step 9.5**, then proceed to **Step 10** to perform cleanup and print a custom update report summarizing the newly added chapters, merged glossary terms, and updated indices.\n\n---\n\n## Quality Rules\n\n1. **Extract structure, not summaries** — capture named frameworks, exact formulations, anti-patterns; not chapter recaps\n2. **Preserve the author's precision** — \"The 5 Whys\" ≠ \"ask why multiple times\"; keep exact naming\n3. **Density over completeness** — a 1,000-token summary beats a 10,000-token excerpt\n4. **Practitioner voice** — write \"Use X when Y\", not \"The book explains X\"\n5. **Front-load SKILL.md** — compaction keeps the first 5,000 tokens; most important content comes first\n6. **Chapter files are on-demand** — they don't count against skill budget until loaded\n7. **Never copy raw book text** — always synthesize, summarize, extract signal\n8. **Topic index is critical** — it's how the agent navigates to the right chapter file","skillMdTruncated","frontmatter",{"_38":41,"_44":45},"totalSizeBytes",74402,"runtime",{"_285":7,"_286":7,"_287":-5,"_288":31,"_289":31,"_290":7,"_291":292,"_293":294},"requiresBash","requiresMcp","model","requiresNode","requiresNetwork","requiresPython","allowedTools",[],"dependencies",[],"install",{"_297":298,"_299":168,"_300":140,"_301":302,"_303":304},"cli","npx skills add virgiliojr94/book-to-skill","coordinate","browseUrl","downloadUrl","https://github.com/virgiliojr94/book-to-skill/archive/refs/heads/master.zip","gitUrl","https://github.com/virgiliojr94/book-to-skill.git","createdAt","2026-08-11T01:17:58.471Z","updatedAt","2026-08-11T07:18:37.295Z","hasNext","page","actionData","errors"] </article></body></html>

[{"_1":2,"_311":-5,"_312":-5},"loaderData",{"_3":4,"_8":9,"_23":24},"root",{"_5":-5,"_6":7},"user","countable",true,"routes/_main",{"_5":-5,"_10":11},"recentPosts",[12,17,20],{"_13":14,"_15":16},"slug","claude-code-channels","title","Claude Code Channels: Pushing Events Into a Session",{"_13":18,"_15":19},"claude-code-monitor-tool","What Claude Code's Monitor Tool Does",{"_13":21,"_15":22},"claude-code-subagent-forking","How Claude Code's Subagent Forking Works","routes/creators.$handle",{"_25":26,"_27":26,"_28":29,"_30":31,"_32":33,"_309":31,"_310":112},"handle","virgiliojr94","displayName","profileUrl","https://github.com/virgiliojr94","verified",false,"skills",[34],{"_35":36,"_13":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_55":56,"_62":63,"_64":65,"_66":67,"_82":83,"_84":-5,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":-5,"_96":97,"_98":26,"_30":31,"_99":31,"_100":88,"_101":102,"_103":88,"_104":88,"_105":106,"_107":108,"_136":137,"_172":173,"_223":224,"_283":284,"_295":296,"_305":306,"_307":308},"id","gh__virgiliojr94__book-to-skill__root","book-to-skill-converter-virgiliojr94","name","Book to Skill Converter","canonicalName","book-to-skill","tagline","Transform books into actionable agent skills.","description","Converts books and documents (PDF, EPUB, DOCX, HTML, Markdown, plain text, RTF, MOBI/AZW with Calibre) into structured agent skills, extracting frameworks, mental models, principles, techniques, and anti-patterns. Use when the user wants to study a document through GitHub Copilot CLI, Amp, or Claude Code, apply an author's frameworks while working, or build a reusable knowledge base from a file.","longDescription","The Book to Skill Converter is designed to help users extract structured knowledge from various document formats, including PDF, EPUB, DOCX, HTML, Markdown, plain text, RTF, and MOBI/AZW. This skill focuses on converting written content into a format that can be utilized by AI coding agents like GitHub Copilot CLI, Amp, and Claude Code. Instead of generating summaries, it emphasizes extracting frameworks, principles, techniques, and anti-patterns, allowing users to leverage the author's insights effectively.\n\nThis tool is particularly beneficial for developers and designers who want to study complex documents or apply specific frameworks while working. By converting books into structured skills, users can create a reusable knowledge base that enhances their productivity and decision-making processes. The converter operates through multiple modes, including full conversion, analysis-only, generating from prior analysis, and updating existing skills, providing flexibility based on user needs.\n\nThe skill preserves the precision of the author's original frameworks, ensuring that concepts like \"The 5 Whys\" are captured accurately. Users can also layer the depth of extraction based on the complexity of the source material, making it suitable for both simple and complex texts. The output includes a complete skill structure with relevant files, enabling seamless integration into the user's workflow.\n\nOverall, the Book to Skill Converter is an essential tool for anyone looking to systematically extract and utilize knowledge from written documents, making it easier to apply learned concepts in practical scenarios.","primaryCategory","productivity","subcategory","automation","secondaryCategories",[54],"development","tags",[57,58,59,60,61],"document-conversion","knowledge-extraction","skill-authoring","frameworks","agent-integration","skillType","workflow","complexity","intermediate","platforms",[68,69,70,71,72,73,74,75,76,77,78,79,80,81],"claude-code","claude-api","codex-cli","cursor","antigravity","github-copilot","windsurf","opencode","cline","roo-code","goose","kiro","continue","trae","delivery","source-link","skillFileUrl","pricing","free","price",0,"thumbnailType","icon","thumbnailIcon","book","thumbnailColor","blue","thumbnailImageUrl","sellerId","gh__virgiliojr94","sellerName","featured","downloads","views",2,"rating","reviewCount","status","active","metrics",{"_109":110,"_111":112,"_113":112,"_114":110,"_115":88,"_116":117,"_118":119,"_120":121,"_122":123,"_124":125,"_126":127,"_128":129,"_130":131,"_132":133,"_134":135},"freshnessScore",100,"mirrorCount",1,"skillCountInRepo","qualityScore","daysSinceUpdate","popularityScore",88,"trustScore",65,"repoOpenIssues",17,"repoStars",20065,"repoWatchers",110,"repoContributors",21,"overallScore",90,"repoCreatedAt","2026-05-01T02:09:39Z","repoForks",2142,"repoPushedAt","2026-08-10T19:25:58Z","source",{"_138":26,"_139":140,"_141":142,"_147":41,"_148":-5,"_145":149,"_150":151,"_152":31,"_153":154,"_155":156,"_162":163,"_164":7,"_165":166,"_167":168,"_169":170,"_171":170},"owner","repoUrl","https://github.com/virgiliojr94/book-to-skill","author",{"_28":29,"_143":144,"_38":26,"_25":26,"_145":146},"avatarUrl","https://github.com/virgiliojr94.png","type","User","repo","commitSha","github","branch","master","isOfficial","path","","license",{"_38":157,"_158":159,"_160":161},"MIT License","spdxId","MIT","url","https://github.com/virgiliojr94/book-to-skill/blob/master/LICENSE.md","sourceUpdatedAt","2026-08-10T19:25:56.000Z","redistributable","permalink","https://github.com/virgiliojr94/book-to-skill/blob/master/SKILL.md","repoFullName","virgiliojr94/book-to-skill","lastSyncedAt","2026-08-11T01:17:52.594Z","firstSeenAt","seo",{"_174":175,"_186":187,"_188":189,"_207":-5,"_208":209,"_215":216,"_217":218,"_219":220,"_221":222},"useCases",[176,180,183],{"_15":177,"_178":179},"Converting a Technical Book","body","You have a technical book and want to extract specific frameworks and techniques for your project. Use the full conversion mode to create a reusable skill.",{"_15":181,"_178":182},"Analyzing a Document Before Conversion","You want to review the frameworks in a management book before generating a skill. Use the analyze-only mode to get an extraction report.",{"_15":184,"_178":185},"Updating an Existing Skill","You have new insights from a recent book and want to update your existing skill. Provide the new document path to merge the content.","whenNotToUse","This skill may not be suitable for simple text summarization or when working with unsupported document formats.","faqs",[190,195,198,201,204],{"_191":192,"_193":194},"q","What types of documents can I convert?","a","You can convert PDF, EPUB, DOCX, HTML, Markdown, plain text, RTF, and MOBI/AZW files.",{"_191":196,"_193":197},"How does the extraction process work?","The skill extracts frameworks, principles, techniques, and anti-patterns from the provided documents, creating a structured skill format.",{"_191":199,"_193":200},"Can I update existing skills with new content?","Yes, the skill includes an update mode that allows you to merge new content into existing skills.",{"_191":202,"_193":203},"What output can I expect after conversion?","The output includes a complete skill structure with SKILL.md, chapters, glossary, patterns, and cheatsheet.",{"_191":205,"_193":206},"Is this tool suitable for summarizing content?","No, this tool focuses on extracting structured knowledge rather than summarizing content.","ogImageUrl","keywords",[210,211,212,213,214],"convert books to skills","extract frameworks from documents","agent skill conversion","structured knowledge extraction","document to skill converter","whenToUse","Use this converter when you want to study a document or apply an author's frameworks in your work.","metaTitle","Book to Skill Converter - Transform Documents to Skills","problemSolved","This skill removes the challenge of extracting actionable insights from dense written materials.","metaDescription","Easily convert books into structured agent skills for better productivity and knowledge application.","content",{"_225":226,"_227":228,"_265":266,"_276":277,"_278":31,"_279":280,"_281":282},"bundledFiles",9,"fileTree",[229,236,239,242,245,248,251,254,258,262],{"_153":230,"_231":232,"_145":233,"_234":235},"BACKERS.md","size",693,"file","language","markdown",{"_153":237,"_231":238,"_145":233,"_234":235},"CHANGELOG.md",15915,{"_153":240,"_231":241,"_145":233,"_234":235},"CONTRIBUTING.md",4151,{"_153":243,"_231":244,"_145":233,"_234":235},"LICENSE.md",1068,{"_153":246,"_231":247,"_145":233,"_234":235},"README.md",14011,{"_153":249,"_231":250,"_145":233,"_234":235},"SECURITY.md",1290,{"_153":252,"_231":253,"_145":233,"_234":235},"SKILL.md",31056,{"_153":255,"_231":256,"_145":233,"_234":257},"cliff.toml",2519,"toml",{"_153":259,"_231":260,"_145":233,"_234":261},"mkdocs.yml",2769,"yaml",{"_153":263,"_231":264,"_145":233,"_234":257},"pyproject.toml",930,"codeExamples",[267,271,274],{"_234":268,"_269":270},"bash","snippet","SCRIPT_PATH=\"\"\nfor candidate in \\\n \"$HOME/.copilot/skills/book-to-skill/scripts/extract.py\" \\\n \"$HOME/.agents/skills/book-to-skill/scripts/extract.py\" \\\n \"$HOME/.claude/skills/book-to-skill/scripts/extract.py\" \\\n \".github/skills/book-to-skill/scripts/extract.py\" \\\n \".claude/skills/book-to-skill/scripts/extract.py\" \\\n \".agents/skills/book-to-skill/scripts/extract.py\" \\\n \"$HOME/.config/agents/skills/book-to-skill/scripts/extract.py\" \\\n \"$HOME/.config/amp/skills/book-to-skill/scripts/extract.py\"\ndo\n if [ -f \"$candidate\" ]; then\n SCRIPT_PATH=\"$candidate\"\n break\n fi\ndone\n\nif [ -z \"$SCRIPT_PATH\" ]; then\n echo \"Could not find scripts/extract.py for book-to-skill\" >&2\n exit 1\nfi\n\nPYTHON_BIN=\"${PYTHON_BIN:-python3}\"\nif ! command -v \"$PYTHON_BIN\" >/dev/null 2>&1; then\n PYTHON_BIN=\"python\"\nfi\n\n\"$PYTHON_BIN\" \"$SCRIPT_PATH\" $INPUT_PATHS --mode --install-missing ask",{"_234":272,"_269":273},"text","📖 Sources detected: source(s)\n\n📄 Combined Pages/Sections: ~ | Words: ~ | Total tokens: ~K\n\n💰 Estimated token cost (Full Conversion / Update):\n Input (reading + prompts): ~K tokens\n Output (skill files generated/updated): ~K tokens\n Total: ~K tokens\n\n Cost: multiply the token counts above by your model's current\n input/output per-1M-token rates (prices and model names change often —\n do not hardcode them; quote today's rate and label it as an estimate).\n\n ⏱ Estimated time: ~ minutes\n\n📁 Files to be generated/updated:\n SKILL.md + chapter files + glossary + patterns + cheatsheet\n\n➡ Proceed with Full Conversion / Update? (or type \"analyze only\" to preview first)",{"_234":268,"_269":275},"# Size check before any Read\nwc -w \"$FULL_TEXT_PATH\"\n\n# Find chapter offsets without loading the whole file\ngrep -n -E \"^\\s*(Chapter|CHAPTER)\\s+[0-9]+\" \"$FULL_TEXT_PATH\" | head -40\n\n# Pull only the chapter you need (lines start..end inclusive)\nsed -n ',p' \"$FULL_TEXT_PATH\"\n\n# Verify a framework is actually mentioned before claiming it in SKILL.md\ngrep -c -i \"westrum\\|dora\" \"$FULL_TEXT_PATH\"\n\n# Targeted Read with offset/limit avoids dumping the full file\n# Read(file_path=full_text.txt, offset=, limit=)","skillMd","\n\n# Book-to-Skill Converter\n\nTransform written knowledge into actionable agent skills by extracting structure — not producing summaries.\n\n## Philosophy\n\nBooks contain crystallized expertise: frameworks, principles, and techniques that took years to develop. This skill extracts that knowledge into a format GitHub Copilot CLI, Amp, Claude Code, or another compatible agent can leverage repeatedly.\n\n**Extract structure, not summaries.** A skill isn't a book report. It's a toolkit of:\n- Named frameworks (mental models with clear application)\n- Actionable principles (rules that guide decisions)\n- Techniques (step-by-step methods)\n- Anti-patterns (what to avoid and why)\n- Voice calibration (how the author thinks and communicates)\n\n**Preserve the author's precision.** Frameworks often have specific names for reasons. \"The 5 Whys\" isn't interchangeable with \"ask why multiple times.\" Capture the exact formulation.\n\n**Layer depth appropriately.** Simple books → simple skills. Complex books with 10+ frameworks → skills with reference files and on-demand chapters.\n\n---\n\n## Modes of Operation\n\nFour paths available. Route based on what the user asks:\n\n### 1. Full Conversion (Default)\n**Trigger:** User provides one or more document/directory/glob paths without special instructions\n**Action:** Run all steps below (Steps 0–9)\n**Output:** Complete skill with SKILL.md, chapters/, glossary, patterns, cheatsheet\n\n### 2. Analyze Only\n**Trigger:** User says \"analyze\", \"just extract\", or \"I want to review before generating\"\n**Action:** Run Steps 0–3, then produce a structured extraction report (frameworks, principles, techniques found). Stop — do NOT generate skill files.\n**Output:** Analysis report for user review\n\n### 3. Generate from Prior Analysis\n**Trigger:** User has existing analysis notes or previously ran analyze-only\n**Action:** Skip Steps 0–3, use the provided analysis as input, run Steps 4–9\n**Output:** Skill files from the provided analysis\n\n### 4. Update / Fold-in (Existing Skill)\n**Trigger:** User provides one or more new source paths and indicates they want to update an existing skill (either by pointing to the existing skill folder, providing a skill slug that already exists in `SKILLS_HOME`, or explicitly requesting an update).\n**Action:** Run Step 0 (out-of-scope check), Step 1 (validate inputs), Step 1.5 (identify book type), and Step 2 (extract new files). Then skip to Step 5 (identify/detect existing skill path) and run the **Update / Fold-in Workflow** to merge the new content into the existing skill files.\n**Output:** Updated existing skill with new/revised chapter summaries and merged indexes/glossaries.\n\n---\n\n## Skill Locations\n\nThis converter can run from multiple skill systems. When looking for this converter's helper script or writing the generated book skill, prefer these locations in order:\n\n1. GitHub Copilot CLI personal skills: `~/.copilot/skills/`\n2. Cross-agent personal skills (Copilot + Amp): `~/.agents/skills/`\n3. Claude Code personal skills: `~/.claude/skills/`\n4. Project-local Copilot skills: `.github/skills/`\n5. Project-local Claude skills: `.claude/skills/`\n6. Project-local Amp / Copilot skills: `.agents/skills/`\n7. Amp global skills: `~/.config/agents/skills/`\n8. Amp legacy global skills: `~/.config/amp/skills/`\n\nFor **generated** book skills, pick a destination that the user's host agent can actually discover (see Step 5). When more than one valid root exists, ask the user once and remember the answer for the session — do not silently default.\n\n---\n\n## Step 0 — Out-of-scope check\n\nIf no arguments are provided, stop and respond:\n> \"book-to-skill requires a supported document path, folder, or glob pattern. Usage: `book-to-skill ... [skill-name-slug]`\"\n\nThroughout the workflow:\n- Identify the input paths and the optional skill slug.\n- If the last argument is not a file, folder, or glob that exists or matches any files, and it looks like a skill slug (e.g. lowercase hyphens, alphanumeric), treat it as `SKILL_NAME`.\n- Treat all other arguments as the list of `INPUT_PATHS`.\n- If any input path is an existing skill directory (contains `SKILL.md` and a `chapters/` sub-folder), or if `SKILL_NAME` matches an existing skill slug in `SKILLS_HOME`, flag this run as an **Update/Fold-in** operation (Mode 4).\n\n---\n\n## Step 1 — Validate input\n\nVerify that there is at least one supported file, directory, or glob pattern among the `INPUT_PATHS`.\nFor directories and globs, expand them to find matching supported files (`.pdf`, `.epub`, `.docx`, `.txt`, `.md`, `.markdown`, `.rst`, `.adoc`, `.html`, `.htm`, `.rtf`, `.mobi`, `.azw`, `.azw3`).\n\nIf no supported files are found, stop with a clear error message.\n\n---\n\n## Step 1.5 — Identify content type\n\nBefore extracting, ask the user:\n\n> \"What kind of content do these sources have? This helps me choose the best extraction method.\n>\n> 1. **Technical** — has code blocks, tables, formulas, diagrams (e.g. programming books, academic papers, architecture guides)\n> 2. **Text-heavy** — mostly prose, few or no tables/code (e.g. management, productivity, narrative non-fiction)\n> 3. **Not sure** — I'll use the fast method and warn you if quality seems limited\"\n\nStore the answer as `BOOK_TYPE`:\n- Option 1 → `BOOK_TYPE=technical`\n- Option 2 → `BOOK_TYPE=text`\n- Option 3 → `BOOK_TYPE=text`\n\n**If `BOOK_TYPE=technical`**, inform the user before proceeding:\n> \"📐 Technical mode selected — using Docling for structure-aware extraction (tables, code blocks, formulas preserved as markdown). This takes ~1.5s per page, so expect a few minutes for longer sources. Starting now…\"\n\n**If `BOOK_TYPE=text`**, inform:\n> \"📄 Text mode selected — using the fastest suitable extractor for each file type. Plain text/Markdown/HTML are usually ready in seconds; PDFs use pdftotext when available.\"\n\n---\n\n## Step 2 — Extract text from the source documents\n\nRun the extraction script, passing the input paths:\n\n```bash\nSCRIPT_PATH=\"\"\nfor candidate in \\\n \"$HOME/.copilot/skills/book-to-skill/scripts/extract.py\" \\\n \"$HOME/.agents/skills/book-to-skill/scripts/extract.py\" \\\n \"$HOME/.claude/skills/book-to-skill/scripts/extract.py\" \\\n \".github/skills/book-to-skill/scripts/extract.py\" \\\n \".claude/skills/book-to-skill/scripts/extract.py\" \\\n \".agents/skills/book-to-skill/scripts/extract.py\" \\\n \"$HOME/.config/agents/skills/book-to-skill/scripts/extract.py\" \\\n \"$HOME/.config/amp/skills/book-to-skill/scripts/extract.py\"\ndo\n if [ -f \"$candidate\" ]; then\n SCRIPT_PATH=\"$candidate\"\n break\n fi\ndone\n\nif [ -z \"$SCRIPT_PATH\" ]; then\n echo \"Could not find scripts/extract.py for book-to-skill\" >&2\n exit 1\nfi\n\nPYTHON_BIN=\"${PYTHON_BIN:-python3}\"\nif ! command -v \"$PYTHON_BIN\" >/dev/null 2>&1; then\n PYTHON_BIN=\"python\"\nfi\n\n\"$PYTHON_BIN\" \"$SCRIPT_PATH\" $INPUT_PATHS --mode --install-missing ask\n```\n\nBefore extraction, the script checks optional Python packages needed for the detected format. If a better extractor is missing, it prompts the user with the available fallback. Non-interactive sessions default to fallback unless install mode is explicitly `yes`.\n\n**Tip — preflight the environment:** run `\"$PYTHON_BIN\" \"$SCRIPT_PATH\" --check` to print a per-format report of which extractors are installed and the exact command to install whatever is missing, without processing any file. Useful when a user reports a setup or quality problem.\n\nThis creates:\n- `/book_skill_work/full_text.txt` — combined extracted text of all sources with clear visually demarcated boundaries.\n- `/book_skill_work/metadata.json` — overall combined size, words, pages, token counts, and a detailed list of individual processed `sources`.\n\nRead `/book_skill_work/metadata.json` to inspect the results.\n\n---\n\n## Step 2.5 — Pre-flight cost estimate\n\nRead `/book_skill_work/metadata.json` and present the user with an estimate **before doing any generation**:\n\n```\n📖 Sources detected: source(s)\n\n📄 Combined Pages/Sections: ~ | Words: ~ | Total tokens: ~K\n\n💰 Estimated token cost (Full Conversion / Update):\n Input (reading + prompts): ~K tokens\n Output (skill files generated/updated): ~K tokens\n Total: ~K tokens\n\n Cost: multiply the token counts above by your model's current\n input/output per-1M-token rates (prices and model names change often —\n do not hardcode them; quote today's rate and label it as an estimate).\n\n ⏱ Estimated time: ~ minutes\n\n📁 Files to be generated/updated:\n SKILL.md + chapter files + glossary + patterns + cheatsheet\n\n➡ Proceed with Full Conversion / Update? (or type \"analyze only\" to preview first)\n```\n\n**How to estimate:**\n- Input tokens ≈ `estimated_tokens` from metadata × 1.3 (prompts overhead per chapter pass)\n- Output tokens ≈ chapters × per-chapter budget + 4,000 (SKILL.md) + 4,500 (glossary + patterns + cheatsheet)\n - Per-chapter budget midpoint by `BOOK_TYPE` (DEPTH is decided later in Step 4 and can raise it): `text` ≈ 1,000, `technical` ≈ 1,800. If the user has already indicated reference-only vs deep study, use the matching row of the Step 7 matrix.\n- Cost: report the token counts and multiply by the user's current per-1M-token input/output rates. Do NOT hardcode dollar figures — model names and prices change; if you show one, label it an estimate and date it.\n\nWait for the user to confirm before proceeding. If they say \"analyze only\", switch to Mode 2.\n\n---\n\n## Step 2.6 — REPL-style access for large books (> 50k tokens)\n\nInspired by the Recursive Language Model (RLM) paradigm: treat `full_text.txt` as a queryable corpus, not a single read. Loading the whole file into context burns budget you will need later for generation.\n\nFor books over ~50k tokens, prefer programmatic probes over `Read(full_text.txt)` without bounds:\n\n```bash\n# Size check before any Read\nwc -w \"$FULL_TEXT_PATH\"\n\n# Find chapter offsets without loading the whole file\ngrep -n -E \"^\\s*(Chapter|CHAPTER)\\s+[0-9]+\" \"$FULL_TEXT_PATH\" | head -40\n\n# Pull only the chapter you need (lines start..end inclusive)\nsed -n ',p' \"$FULL_TEXT_PATH\"\n\n# Verify a framework is actually mentioned before claiming it in SKILL.md\ngrep -c -i \"westrum\\|dora\" \"$FULL_TEXT_PATH\"\n\n# Targeted Read with offset/limit avoids dumping the full file\n# Read(file_path=full_text.txt, offset=, limit=)\n```\n\nUse this approach for Step 3 (structure analysis), Step 7 (per-chapter summaries), and Step 8 (glossary / patterns extraction). On books under 50k tokens, a single `Read` is fine.\n\nWhy this matters: a 200-page book is ~75k tokens. Re-reading it once per chapter (28 passes) costs ~2M input tokens; using grep + sed to pull only relevant slices keeps generation cost proportional to the output, not the source.\n\n---\n\n## Step 3 — Analyze book structure\n\nRead the first 8,000 characters of the extracted `full_text.txt` to identify:\n- Book **title** and **author(s)**\n- **Chapter structure** (look for \"Chapter N\", \"PART I\", numbered headings, table of contents)\n- **Core themes** and subject domain\n- Approximate number of chapters\n\nThen read the Table of Contents section if present to map all chapters.\n\n**If mode is \"Analyze Only\":** produce the extraction report now and stop. Structure:\n```\n## Extraction Report — \n\n### Author's Core Frameworks\n- **<Framework Name>**: <what it is and when to apply>\n\n### Key Principles\n- <Principle>: <actionable rule>\n\n### Techniques & Methods\n- <Technique>: <step-by-step or how-to>\n\n### Anti-patterns\n- <What to avoid>: <why>\n\n### Suggested Skill Name\n`{author-lastname}-{core-concept}` — e.g. `cialdini-influence`\n\n### Chapters Detected\n| # | Title | Main Frameworks |\n```\n\n---\n\n## Step 4 — Ask purpose (Full Conversion only)\n\nBefore generating, ask the user:\n\n> \"What should this skill help you do? (Pick one or more)\n> 1. Apply the author's frameworks while working\n> 2. Think with the author's mental models\n> 3. Reference specific chapters and concepts\n> 4. All of the above\"\n\nUse the answer to weight what gets highlighted in the SKILL.md Core section.\n\n**Derive `DEPTH` from the answer (no extra prompt):**\n- Answer is **only** option 3 (reference) → `DEPTH=reference` — lean, fast-lookup chapters.\n- Answer includes option 1, 2, or 4 → `DEPTH=study` — deeper chapters with more worked detail, examples, and reasoning.\n\n`DEPTH` and `BOOK_TYPE` together set the per-chapter token budget in Step 7. Do **not** ask a separate \"study vs reference\" question — it is inferred here. (In Modes 2/3, where Step 4 is skipped, default `DEPTH=study`.)\n\n---\n\n## Step 5 — Determine skill name\n\nIf `SKILL_NAME` was provided, use it as the skill slug.\nOtherwise, propose two options and let the user choose:\n- **By author-concept**: `{author-lastname}-{core-concept}` (e.g. `cialdini-influence`, `meadows-systems`)\n- **By title**: lowercase hyphens from book title (e.g. `designing-data-intensive-apps`)\n\nDefault to author-concept format if the book has a strong methodological identity.\n\nChoose the destination skill root (`SKILLS_HOME`). Probe the user's filesystem for existing skill homes and pick by **the host the user is running in**:\n\n| Host agent | Personal skill root (probe in order) | Project-local root |\n|---|---|---|\n| **GitHub Copilot CLI** | `~/.copilot/skills` → `~/.agents/skills` | `.github/skills` → `.claude/skills` → `.agents/skills` |\n| **Amp** | `~/.agents/skills` → `~/.config/agents/skills` → `~/.config/amp/skills` | `.agents/skills` |\n| **Claude Code** | `~/.claude/skills` | `.claude/skills` |\n\nSelection rules:\n1. If **exactly one** of the host's candidate roots exists on disk, use it without asking.\n2. If **none** exist (fresh machine), ask the user which root to create — present the host-appropriate options and remember the choice for the session. Do not silently pick.\n3. If the user explicitly asked for project-local output, prefer the project-local row.\n4. If you cannot identify the host, ask: \"Which agent are you running this in — GitHub Copilot CLI, Amp, or Claude Code?\"\n\nSet `SKILLS_HOME` to the selected root and check if `$SKILLS_HOME/<skill_name>/` already exists.\nIf it does, prompt the user to choose:\n1. **Update / Fold-in** (Mode 4) — integrate new files/content into the existing skill components.\n2. **Overwrite** — delete and regenerate the skill from scratch.\n3. **Rename** — append `-2` or use a different custom slug.\n\nIf the user selects **Update / Fold-in**, proceed immediately to the **Update / Fold-in Workflow** section after Step 2.5 (skipping Steps 3, 4, 6, 7, 8, 9).\n\n---\n\n## Step 6 — Create skill directory structure\n\n```bash\nmkdir -p \"$SKILLS_HOME/<skill_name>/chapters\"\n```\n\n---\n\n## Step 7 — Generate chapter summaries\n\n**TOKEN BUDGET RULE — CRITICAL (adaptive):**\n\nThe per-chapter budget scales with `BOOK_TYPE` and `DEPTH`. Technical chapters need room for code and tables; study depth needs room for worked reasoning. Pick the budget from this matrix:\n\n| | `DEPTH=reference` | `DEPTH=study` |\n|---|---|---|\n| `BOOK_TYPE=text` | 800–1,200 tokens | 1,000–1,800 tokens |\n| `BOOK_TYPE=technical` | 1,200–1,800 tokens | 2,000–3,000 tokens |\n\n- These are per-file targets, not hard caps — a dense chapter may run over, a thin one under. Density still beats length (Quality Rule #3): never pad to hit a number.\n- Files are loaded on-demand, so a larger chapter only costs tokens when that chapter is actually read.\n- When in doubt between two cells (e.g. mixed-content book), use the lower budget and let depth come from precision, not volume.\n\n**`DEPTH=study` is earned with content, not a bigger number.** The standard section template (Core Idea → Connects To) naturally lands a dense prose chapter around 700–900 tokens. To reach the study budget *honestly* — not by padding — a study-depth chapter must add concrete material:\n- **Reproduce one worked example or artifact** from the chapter (e.g. the example press release, a sample dialogue, a filled-in template, a decision the author walks through) under a `## Worked Example` section. This is the single biggest lever and the main thing a learner returns for.\n- **Expand the \"How\" of each framework** into explicit steps or criteria, not a one-liner.\n- **Add a short \"Why it works / failure mode\" note** to the top 1–2 frameworks.\n\nIf a chapter genuinely has no worked example and resists expansion, let it land below the study floor rather than padding — and note that the chapter is thin in its Core Idea. A `reference`-depth chapter, by contrast, deliberately omits worked examples and keeps only the decision-ready essentials.\n\nFor EACH chapter/major section identified in Step 3:\n\nRead the corresponding section of the extracted `full_text.txt` (use character offsets or grep for chapter headings).\n\nCreate `$SKILLS_HOME/<skill_name>/chapters/ch<NN>-<slug>.md` using the structure below.\n\n**Adapt emphasis based on `BOOK_TYPE`:**\n- `technical` → prioritize \"Code Examples\", \"Reference Tables\", and \"Commands & APIs\" sections; preserve exact syntax\n- `text` → prioritize \"Frameworks Introduced\", \"Mental Models\", and \"Key Takeaways\"; skip empty technical sections\n\n```markdown\n# Chapter N: <Full Title>\n\n## Core Idea\n<1–2 sentences: the single most important thing this chapter teaches>\n\n## Frameworks Introduced\n- **<Framework Name>**: <exact formulation — preserve the author's naming>\n - When to use: <specific situation>\n - How: <steps or criteria>\n\n## Key Concepts\n- **<Term>**: <precise definition in 1 sentence>\n(5–10 most important terms from this chapter)\n\n## Mental Models\n<2–4 frameworks or thinking tools. Write as \"Use X when Y\" or \"Think of X as Y\">\n\n## Anti-patterns\n- **<What to avoid>**: <why it fails>\n\n## Code Examples *(technical books only — omit if BOOK_TYPE=text)*\n\n```<language>\n<key code example from this chapter>\n```\n- **What it demonstrates**: <one line>\n\n## Reference Tables *(technical books only — omit if BOOK_TYPE=text)*\n\n\n## Worked Example *(DEPTH=study only — omit for DEPTH=reference)*\n\n\n## Key Takeaways\n1. <Actionable insight>\n2. <Actionable insight>\n3. <Actionable insight>\n(3–7 takeaways a practitioner must remember)\n\n## Connects To\n- **Ch N**: <why this chapter relates>\n- **<Concept>**: <external concept or standard it connects with>\n```\n\n---\n\n## Step 8 — Generate supporting files\n\n### glossary.md\nCreate `$SKILLS_HOME/<skill_name>/glossary.md`:\n- Every significant term from the book, alphabetically sorted\n- Format: `**Term** — definition (Ch N)`\n- Max 1,500 tokens\n\n### patterns.md\nCreate `$SKILLS_HOME/<skill_name>/patterns.md`:\n- All concrete techniques, design patterns, algorithms from the book\n- Format: `## Pattern Name\\n**When to use**: ...\\n**How**: ...\\n**Trade-offs**: ...`\n- Max 2,000 tokens\n\n### cheatsheet.md\nCreate `$SKILLS_HOME/<skill_name>/cheatsheet.md`:\n\n**This is the most differentiated layer of the skill — treat it as a reasoning aid, not a keyword list.** Anyone can grep the glossary for a term. The cheatsheet captures the author's *judgment*: the decisions they'd make and why. It's the file that turns \"I know the words\" into \"I'd act the way the author would\".\n\nPrioritize, in order:\n1. **Decision rules** — \"When X, do Y, because Z.\" The if/then logic the author applies, stated so the reader can apply it without re-reading the book.\n2. **Decision trees / flowcharts** (as nested bullets or a small table) — for choices with more than two branches.\n3. **Trade-off matrices** — competing options scored on the dimensions the author cares about, so the reader can pick under their own constraints.\n4. **Thresholds & defaults** — the specific numbers, ratios, or rules of thumb the author commits to (e.g. \"keep functions under ~20 lines\", \"alert when error budget < 10%\").\n5. **Tells & smells** — fast heuristics for recognizing a situation (\"if you see X, you're probably in trouble Y\").\n\nAvoid: bare term→definition rows (that's the glossary), and prose paragraphs (that's the chapters). Every line should help the reader *decide* something.\n\n- Format mostly as compact tables and decision rules; the content you'd want on a single printed page kept beside you while working.\n- Max 1,200 tokens.\n\n---\n\n## Step 9 — Generate the master SKILL.md\n\n**CRITICAL TOKEN BUDGET: Keep SKILL.md body under 4,000 tokens.**\nCompaction truncates from the END — put the most important content FIRST.\n\nCreate `$SKILLS_HOME/<skill_name>/SKILL.md`:\n\n```markdown\n---\nname: <skill_name>\ndescription: \"Knowledge base from \\\"<Full Title>\\\" by <Author(s)>. Use when applying <author>'s frameworks for <key topics, 3–6 terms>, studying the book, or referencing its concepts.\"\n---\n\n\n\n# <Full Title>\n**Author**: <Author(s)> | **Pages**: ~<N> | **Chapters**: <N> | **Generated**: <YYYY-MM-DD>\n\n## How to Use This Skill\n\n- **Without arguments** — load core frameworks for reference\n- **With a topic** — ask about `replication`, `pricing`, or another indexed topic; I find and read the relevant chapter\n- **With chapter** — ask for `ch05`; I load that specific chapter\n- **Browse** — ask \"what chapters do you have?\" to see the full index\n\nWhen you ask about a topic not covered in Core Frameworks below, I will read\nthe relevant chapter file before answering.\n\n---\n\n## Core Frameworks & Mental Models\n\n\n<generate 2,000 tokens of the most critical frameworks and insights here>\n\n---\n\n## Chapter Index\n\n| # | Title | Key Frameworks |\n|---|-------|----------------|\n| [ch01](chapters/ch01-<slug>.md) | <Title> | <framework1>, <framework2> |\n| [ch02](chapters/ch02-<slug>.md) | <Title> | <framework1>, <framework2> |\n...\n\n## Topic Index\n\n\n- **<Term>** → ch<N>[, ch<N>]\n- **<Term>** → ch<N>\n\n## Supporting Files\n\n- [glossary.md](glossary.md) — all key terms with definitions\n- [patterns.md](patterns.md) — all techniques and design patterns\n- [cheatsheet.md](cheatsheet.md) — quick reference tables and decision guides\n\n---\n\n## Scope & Limits\n\nThis skill covers the book content only. For hands-on implementation in your codebase,\ncombine with project-specific tools. For topics beyond this book, check related skills\nor ask the agent directly.\n```\n\n---\n\n## Step 9.5 — Scan the generated skill\n\nBefore reporting success, loading the skill in another session, or publishing it, run the advisory security scan:\n\n```bash\nSKILL_CONVERTER_ROOT=\"$(cd \"$(dirname \"$SCRIPT_PATH\")/..\" && pwd)\"\n\"$PYTHON_BIN\" \"$SKILL_CONVERTER_ROOT/tools/scan_generated_skill.py\" \"$SKILLS_HOME/<skill_name>\"\n```\n\nIf the scanner exits non-zero, stop and ask a human to review its file/line findings. Do not silently rewrite the generated files, and do not load or publish the skill until the findings are resolved or explicitly accepted.\n\n---\n\n## Step 10 — Cleanup and report\n\n```bash\nPYTHON_BIN=\"${PYTHON_BIN:-python3}\"\nif ! command -v \"$PYTHON_BIN\" >/dev/null 2>&1; then\n PYTHON_BIN=\"python\"\nfi\n\n\"$PYTHON_BIN\" - <<'PY'\nimport os\nimport shutil\nimport tempfile\nfrom pathlib import Path\nshutil.rmtree(\n os.environ.get(\"BOOK_SKILL_WORKDIR\", Path(tempfile.gettempdir()) / \"book_skill_work\"),\n ignore_errors=True,\n)\nPY\n```\n\nThen report to the user:\n\n```\n✅ Skill created: $SKILLS_HOME/<skill_name>/\n\n📚 Book: <Full Title> — <Author>\n📄 Pages: ~<N> | Chapters: <N>\n\nFiles generated:\n SKILL.md — core frameworks + index (~X tokens)\n chapters/ — <N> chapter summaries (~X tokens each, ~X total)\n glossary.md — key terms (~X tokens)\n patterns.md — techniques & patterns (~X tokens)\n cheatsheet.md — quick reference (~X tokens)\n ─────────────────────────────────────────────────────\n Total skill size: ~X tokens (loaded on-demand, not all at once)\n\n💡 Tip: check your agent's session cost/usage command to see actual token usage.\n\nUsage:\n Ask for <skill_name> → load core frameworks\n Ask <skill_name> about <topic> → find and explain a topic\n Ask <skill_name> for ch<N> → dive into a specific chapter\n\nReload (if your agent doesn't auto-detect new skills):\n GitHub Copilot CLI: /skills reload\n Claude Code: restart the session\n Amp: restart the session\n\nShare this skill (Copilot ecosystem, optional):\n gh skill publish $SKILLS_HOME/<skill_name>\n```\n\n---\n\n## Update / Fold-in Workflow\n\nWhen performing an Update/Fold-in operation on an existing skill at `$SKILLS_HOME/<skill_name>/`:\n\n### 1. Read Existing Skill Structure\nRead and parse the existing skill's files:\n- Read `$SKILLS_HOME/<skill_name>/SKILL.md` to parse the existing **Chapter Index**, **Topic Index**, metadata (author, total chapters), and **Core Frameworks**.\n- List all files in `$SKILLS_HOME/<skill_name>/chapters/` to find the highest chapter number (e.g. `ch12`).\n- Read `$SKILLS_HOME/<skill_name>/glossary.md`, `$SKILLS_HOME/<skill_name>/patterns.md`, and `$SKILLS_HOME/<skill_name>/cheatsheet.md` to see what terms and frameworks are already indexed.\n\n### 2. Match Content & Identify Revisions vs. Additions\nAnalyze the new extracted text in `<tempdir>/book_skill_work/full_text.txt` to identify if the new content represents:\n- **Updates/Revisions to existing chapters**: If a section of the new content directly updates or expands an existing chapter's topic, read the existing chapter file, merge the new details into it, and rewrite the file.\n- **New additions**: If the content introduces new chapters, papers, or separate sections, create **new chapter summary files** under `chapters/`. Start numbering these files after the highest existing chapter number (e.g. if the existing chapters stop at `ch12`, create `ch13-*.md`, `ch14-*.md`, etc.).\n\n### 3. Generate or Update Chapter Summary Files\nFor each new or revised chapter:\n- Read the corresponding section of the extracted new text.\n- Follow the formatting guidelines in **Step 7** to build the summary.\n- Write/update the file in `$SKILLS_HOME/<skill_name>/chapters/`.\n\n### 4. Merge Supporting Files\n- **Merge glossary.md**:\n - Read the existing `$SKILLS_HOME/<skill_name>/glossary.md`.\n - Extract all new terms and definitions from the new content (Step 8 glossary guidelines).\n - Combine and alphabetize the list of existing and new terms.\n - If a term already exists, append the new chapter/source references to it (e.g. `**Term** — definition (Ch 4, Ch 13)`).\n - Rewrite `$SKILLS_HOME/<skill_name>/glossary.md` with the fully merged, alphabetized list.\n- **Merge patterns.md**:\n - Read existing `$SKILLS_HOME/<skill_name>/patterns.md`.\n - Extract any new techniques, algorithms, or patterns from the new content.\n - Append the new patterns, ensuring consistent formatting, and keeping the total length concise (under 2,500 tokens).\n- **Merge cheatsheet.md**:\n - Read existing `$SKILLS_HOME/<skill_name>/cheatsheet.md`.\n - Extract new comparison rules, decision tables, or parameter guides.\n - Integrate them cleanly into the cheatsheet structure.\n\n### 5. Re-generate the Master SKILL.md\nUpdate the master skill file `$SKILLS_HOME/<skill_name>/SKILL.md`:\n- **Metadata**: Increment the chapter count, update the estimated page count, and add the new source names if appropriate. Update the `Generated` date to the current date.\n- **Core Frameworks**: Fold in the most high-impact mental models or principles from the new content (ensuring the overall file remains under 4,000 tokens).\n- **Chapter Index**: Append the new chapters to the index table, linking to the newly created files.\n- **Topic Index**: Merge the new topics alphabetically. If an existing topic is also covered in the new chapters, append the new chapter links to its line (e.g. `- **Topic** → ch05, ch13`).\n\n### 6. Scan, Cleanup, and Report\nOnce the files are successfully written and merged, run **Step 9.5**, then proceed to **Step 10** to perform cleanup and print a custom update report summarizing the newly added chapters, merged glossary terms, and updated indices.\n\n---\n\n## Quality Rules\n\n1. **Extract structure, not summaries** — capture named frameworks, exact formulations, anti-patterns; not chapter recaps\n2. **Preserve the author's precision** — \"The 5 Whys\" ≠ \"ask why multiple times\"; keep exact naming\n3. **Density over completeness** — a 1,000-token summary beats a 10,000-token excerpt\n4. **Practitioner voice** — write \"Use X when Y\", not \"The book explains X\"\n5. **Front-load SKILL.md** — compaction keeps the first 5,000 tokens; most important content comes first\n6. **Chapter files are on-demand** — they don't count against skill budget until loaded\n7. **Never copy raw book text** — always synthesize, summarize, extract signal\n8. **Topic index is critical** — it's how the agent navigates to the right chapter file","skillMdTruncated","frontmatter",{"_38":41,"_44":45},"totalSizeBytes",74402,"runtime",{"_285":7,"_286":7,"_287":-5,"_288":31,"_289":31,"_290":7,"_291":292,"_293":294},"requiresBash","requiresMcp","model","requiresNode","requiresNetwork","requiresPython","allowedTools",[],"dependencies",[],"install",{"_297":298,"_299":168,"_300":140,"_301":302,"_303":304},"cli","npx skills add virgiliojr94/book-to-skill","coordinate","browseUrl","downloadUrl","https://github.com/virgiliojr94/book-to-skill/archive/refs/heads/master.zip","gitUrl","https://github.com/virgiliojr94/book-to-skill.git","createdAt","2026-08-11T01:17:58.471Z","updatedAt","2026-08-11T07:18:37.295Z","hasNext","page","actionData","errors"] </article></body></html>