[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79HWYPCM9PCXBM4N5PCBFJJ":3,"skill-same:01M79HWYPCM9PCXBM4N5PCBFJJ":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M79HWYPCM9PCXBM4N5PCBFJJ","book-explainer-generate-site",null,"Internal site-production phase that builds a local PDF or EPUB book reading site from an exact run request, Content brief, Run Manifest, canonical structure, and report set.","choplin\u002Fexplainer-studio","choplin","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F342798?v=4","01M79HWTA907677Q3R963A4PVZ","Akihiro Okuno","01M79HWTB0VNAN238405SZ6ESK",1,"MIT","https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Fskills\u002Fbook-explainer\u002Fbook-explainer-generate-site\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: book-explainer-generate-site\ndescription: \"Internal site-production phase that builds a local PDF or EPUB book reading site from an exact run request, Content brief, Run Manifest, canonical structure, and report set.\"\nuser-invocable: false\n---\n\n# Generate a book reading site\n\nApply [[explainer-content-workflow-base]], read its Artifact contract, and\nrequire the `book` profile. Own only site authoring and local build; do not\nperform workflow discovery, user consultation, Content modeling, or Planning.\n\nRequire exact paths and digests for the run request, selected Content brief,\nRun Manifest, canonical source structure, and every planned source report. The\nManifest entry must select this site output with `create` or `replace`. Return a\nstructured missing\u002Fincompatible-input result otherwise. Never infer the latest\nplanning Artifact.\n\nThe planning Artifacts provide the shared interpretive model and resolved run\nplan, but are not exclusive inputs. Reread reports or the narrow source locus\nwhenever fidelity requires it. Detect the source adapter from durable\nwork-directory artifacts:\n\n- EPUB when `epub\u002Flocators.json` exists;\n- PDF otherwise, when reports use canonical `.p` source anchors.\n\nIf the artifacts conflict or do not identify either format, stop and ask for the\nsource format. Never infer EPUB from prose alone.\n\nDelegate the complete build to [[explainer-reading-site-generate-base]]. This\nskill owns the shared book profile and supplies only the adapter-specific inputs\nbelow. Publishing remains a separate [[explainer-reading-site-deploy]] action.\n\n## Shared book profile\n\nPass `\u003CWORK_DIR>\u002Fstructured\u002Ftoc.md` as the canonical source structure. Order\nreports as follows:\n\n1. `overview` first, kicker `全体レポート`;\n2. `chapter-N` in natural numeric order, kicker `第N章`;\n3. unmatched reports last in natural order, with a readable title-cased kicker.\n\nUse landing vocabulary `読書ガイド`, `チャプター`, and `章`. Use the supplied\ntitle when present; otherwise resolve it from the adapter metadata or overview.\n\nKeep the source-authored order and divisions as the site's navigation backbone.\nUse the selected content brief to explain the book-wide mental model, chapter\nroles, and cross-chapter relationships in the landing page and appropriate\nreport pages. Use the manifest mappings to confirm the selected scope. Never\nreorder, merge, suppress, or rename source divisions merely because the brief\ngroups its explanatory items differently.\n\n## Adapter inputs\n\nFor PDF, pass locator kind `pdf-page` and make `ocr\u002Ffigures\u002F` available when it\nexists. No locator map or deterministic locator command applies.\n\nFor EPUB, pass:\n\n- locator kind `epub`;\n- `\u003CWORK_DIR>\u002Fepub\u002Flocators.json` as the validation map;\n- `\u003CWORK_DIR>\u002Fepub\u002Fmedia\u002F` as optional original media, copied recursively to\n  `site\u002Fmedia\u002F`;\n- the title in `epub\u002Fmetadata.json` when the user did not supply one.\n\nAfter semantic `src\u002F*.md` authoring and the shared consistency sweep are clean,\nbut before HTML generation, run:\n\n```bash\npython3 \u003CSKILL_DIR>\u002Fscripts\u002Fvalidate_locators.py \\\n  \u003CWORK_DIR>\u002Fepub\u002Flocators.json \u003CWORK_DIR>\u002Fsrc\u002F*.md\n```\n\nUnknown or missing EPUB locators and EPUB prose using PDF `.p` anchors block the\nbuild. Finish by reporting `\u003CWORK_DIR>\u002Fsite\u002F` and offering deployment separately.\nRun all normal AI checks and return the exact output inventory and digest to the\ncoordinator. Human interaction belongs to the coordinator. When\n`human_gates.site: true`, mark the checked site as the checkpoint subject; a\nlater phase may accept it only with the matching checkpoint-decision Artifact.\nNever treat that decision as permission to deploy.\n","# Generate a book reading site\n\nApply [[explainer-content-workflow-base]], read its Artifact contract, and\nrequire the `book` profile. Own only site authoring and local build; do not\nperform workflow discovery, user consultation, Content modeling, or Planning.\n\nRequire exact paths and digests for the run request, selected Content brief,\nRun Manifest, canonical source structure, and every planned source report. The\nManifest entry must select this site output with `create` or `replace`. Return a\nstructured missing\u002Fincompatible-input result otherwise. Never infer the latest\nplanning Artifact.\n\nThe planning Artifacts provide the shared interpretive model and resolved run\nplan, but are not exclusive inputs. Reread reports or the narrow source locus\nwhenever fidelity requires it. Detect the source adapter from durable\nwork-directory artifacts:\n\n- EPUB when `epub\u002Flocators.json` exists;\n- PDF otherwise, when reports use canonical `.p` source anchors.\n\nIf the artifacts conflict or do not identify either format, stop and ask for the\nsource format. Never infer EPUB from prose alone.\n\nDelegate the complete build to [[explainer-reading-site-generate-base]]. This\nskill owns the shared book profile and supplies only the adapter-specific inputs\nbelow. Publishing remains a separate [[explainer-reading-site-deploy]] action.\n\n## Shared book profile\n\nPass `\u003CWORK_DIR>\u002Fstructured\u002Ftoc.md` as the canonical source structure. Order\nreports as follows:\n\n1. `overview` first, kicker `全体レポート`;\n2. `chapter-N` in natural numeric order, kicker `第N章`;\n3. unmatched reports last in natural order, with a readable title-cased kicker.\n\nUse landing vocabulary `読書ガイド`, `チャプター`, and `章`. Use the supplied\ntitle when present; otherwise resolve it from the adapter metadata or overview.\n\nKeep the source-authored order and divisions as the site's navigation backbone.\nUse the selected content brief to explain the book-wide mental model, chapter\nroles, and cross-chapter relationships in the landing page and appropriate\nreport pages. Use the manifest mappings to confirm the selected scope. Never\nreorder, merge, suppress, or rename source divisions merely because the brief\ngroups its explanatory items differently.\n\n## Adapter inputs\n\nFor PDF, pass locator kind `pdf-page` and make `ocr\u002Ffigures\u002F` available when it\nexists. No locator map or deterministic locator command applies.\n\nFor EPUB, pass:\n\n- locator kind `epub`;\n- `\u003CWORK_DIR>\u002Fepub\u002Flocators.json` as the validation map;\n- `\u003CWORK_DIR>\u002Fepub\u002Fmedia\u002F` as optional original media, copied recursively to\n  `site\u002Fmedia\u002F`;\n- the title in `epub\u002Fmetadata.json` when the user did not supply one.\n\nAfter semantic `src\u002F*.md` authoring and the shared consistency sweep are clean,\nbut before HTML generation, run:\n\n```bash\npython3 \u003CSKILL_DIR>\u002Fscripts\u002Fvalidate_locators.py \\\n  \u003CWORK_DIR>\u002Fepub\u002Flocators.json \u003CWORK_DIR>\u002Fsrc\u002F*.md\n```\n\nUnknown or missing EPUB locators and EPUB prose using PDF `.p` anchors block the\nbuild. Finish by reporting `\u003CWORK_DIR>\u002Fsite\u002F` and offering deployment separately.\nRun all normal AI checks and return the exact output inventory and digest to the\ncoordinator. Human interaction belongs to the coordinator. When\n`human_gates.site: true`, mark the checked site as the checkpoint subject; a\nlater phase may accept it only with the matching checkpoint-decision Artifact.\nNever treat that decision as permission to deploy.\n",{"name":5,"description":7,"user-invocable":20},"main","08b762ef2ded20d4feadbe6fb7bfdd28747b0848","skills\u002Fbook-explainer\u002Fbook-explainer-generate-site",0,"https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio","https:\u002F\u002Fgithub.com\u002Fchoplin","http:\u002F\u002Fwww.chopl.in\u002F","2026-10-27 17:11:10",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add choplin\u002Fexplainer-studio --skill book-explainer-generate-site",{"tool":38,"command":39},"bunx","bunx skills add choplin\u002Fexplainer-studio --skill book-explainer-generate-site",{"tool":41,"command":42},"pnpm","pnpm dlx skills add choplin\u002Fexplainer-studio --skill book-explainer-generate-site","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Fskills\u002Fbook-explainer\u002Fbook-explainer-generate-site\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"scripts\u002Fvalidate_locators.py","SCRIPT","脚本",3091,"https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Fskills\u002Fbook-explainer\u002Fbook-explainer-generate-site\u002Fscripts\u002Fvalidate_locators.py",[53,59,66,73,80,87],{"skillNo":54,"name":55,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M79J25VYQ91K75R5HNDYYV4Z","invalid-skill-frontmatter","https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid-skill-frontmatter\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M79J1ZWAX4EYVXPKTMB2WBMG","pdf-explainer-summarize","Digest a book, manual, or other long non-paper PDF into a source-anchored Markdown overview. Use when the requested deliverable is only a report, digest, or summary. Use paper-explainer-summarize for academic papers, direct reading for short PDFs, and book-explainer for coordinated reports, audio, site, rebuild, or resume.","https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Fskills\u002Fpdf-explainer\u002Fpdf-explainer-summarize\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M79J1WEQW2GT78X92RMFY1AF","pdf-explainer-pdf-stitch","Internal Phase 2 worker invoked once by pdf-explainer-summarize after chunk extraction. Reconciles sections across chunk boundaries, deduplicates the material, and writes the canonical structural spine and outline.","https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Fskills\u002Fpdf-explainer\u002Fpdf-explainer-pdf-stitch\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M79J1RZTE0VSWAJ26BYSPDD9","pdf-explainer-pdf-extract","Internal Phase 1 worker invoked by pdf-explainer-summarize once per page chunk. Reads the chunk visually or from a faithful text layer and writes structured source material with a verbatim heading stream, not a finished report.","https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Fskills\u002Fpdf-explainer\u002Fpdf-explainer-pdf-extract\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M79J1NVVQY4XP1BQAEJJ4A23","pdf-explainer-pdf-detail","Internal per-chapter worker invoked by book-explainer for PDF input. Re-read one resolved chapter span visually or from a faithful text layer and write a standalone detail report with [pNN] source anchors.","https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Fskills\u002Fpdf-explainer\u002Fpdf-explainer-pdf-detail\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M79J1JQM36YS9WVXFPFJHWC7","pdf-explainer-generate-site","Compatibility entry point for requesting a local PDF reading site from an existing work directory. Route through book-explainer so Artifact reconciliation and Planning still occur.","https:\u002F\u002Fgithub.com\u002Fchoplin\u002Fexplainer-studio\u002Fblob\u002Fmain\u002Fskills\u002Fpdf-explainer\u002Fpdf-explainer-generate-site\u002FSKILL.md",[],[]]