[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CS390HSDNACB2PKQQNE4PQ":3,"skill-same:01M6CS390HSDNACB2PKQQNE4PQ":66},{"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":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":46,"repositoryHtmlUrl":47,"repositoryHomepageUrl":6,"ownerHtmlUrl":48,"ownerBlogUrl":49,"ownerDescription":50,"updatedAt":51,"install":52,"resources":65},"01M6CS390HSDNACB2PKQQNE4PQ","docs",null,"Documentation conventions for Ghost's user-facing docs site (Astro Starlight). MUST READ before creating or updating any page under docs\u002F, modifying CLI help text, or changing user-facing behavior that needs documentation. Covers which doc file to update for each change type, build verification, formatting, and terminology rules.","mrtolkien\u002FGHOST","mrtolkien","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8489650?v=4","01M6CS32Q934XBQQE8BDV5Z6W2","Tolki","01M6CS32VBCD47F5E27WF9W6FC",5,"MIT","https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fdocs\u002FSKILL.md",[],[5,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],"terminology","cli","build","behavior","read","Rules","page","docs site","text","site","ghost","astro","doc","file","verification","help","update","documentation","change","2026-11-10 10:12:30",false,"---\nname: docs\ndescription: >-\n Documentation conventions for Ghost's user-facing docs site (Astro Starlight). MUST\n READ before creating or updating any page under docs\u002F, modifying CLI help text, or\n changing user-facing behavior that needs documentation. Covers which doc file to\n update for each change type, build verification, formatting, and terminology rules.\n---\n\n# Documentation Conventions\n\nUser-facing docs live in `docs\u002F` (Astro Starlight).\n\n## Which File to Update\n\n| Change type | Doc file |\n| ----------------------- | ------------------------------------------------------------------------------------------------------------- |\n| CLI changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Freference\u002Fcli.md` |\n| Config changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fgetting-started\u002Fconfiguration.md` |\n| Core tools | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fskills-and-tools\u002Fcore-tools.md` |\n| Knowledge tools | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fknowledge\u002Ftools.md` |\n| Web research tools | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fweb-research\u002Ftools.md` |\n| Workspace\u002Fbootstrap | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fgetting-started\u002Fworkspace.mdx` |\n| Provider changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fghost\u002Fproviders.md` |\n| Agent changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fagents\u002F` (introduction.md, syntax.md, context.md, cron.md, agent-control.md) |\n| Chat\u002Fsession changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fchat\u002F` (sessions.md, compaction.md) |\n| Knowledge features | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fknowledge\u002F` (knowledge.mdx, reflection.md, tools.md) |\n| Skills & tools overview | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fskills-and-tools\u002F` (overview.md, creating-skills.md, default-skills.md, core-tools.md) |\n| Web research features | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fweb-research\u002F` (overview.md, tools.md) |\n| Identity\u002Finterfaces | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fghost\u002F` (identity.md, interfaces.mdx, providers.md) |\n| Dependencies | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Freference\u002Fdependencies.md` |\n\n## Build Verification\n\nAlways verify docs build after changes:\n\n```sh\ncd docs && npm run build\n```\n\n## Formatting\n\n- Docs content (`docs\u002Fsrc\u002Fcontent\u002F**`) is excluded from oxfmt because Starlight's `:::`\n admonition syntax is not supported by Prettier-compatible formatters.\n- Line width: 88 characters for all other markdown\u002FMDX\u002FJSON\u002FTOML (via oxfmt).\n\n## Terminology\n\nAlways write `GHOST` and `OPERATOR` in all caps in prose. Keep real code\u002Ffile\nidentifiers (crate names, paths, variable names) unchanged.\n","# Documentation Conventions\n\nUser-facing docs live in `docs\u002F` (Astro Starlight).\n\n## Which File to Update\n\n| Change type | Doc file |\n| ----------------------- | ------------------------------------------------------------------------------------------------------------- |\n| CLI changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Freference\u002Fcli.md` |\n| Config changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fgetting-started\u002Fconfiguration.md` |\n| Core tools | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fskills-and-tools\u002Fcore-tools.md` |\n| Knowledge tools | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fknowledge\u002Ftools.md` |\n| Web research tools | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fweb-research\u002Ftools.md` |\n| Workspace\u002Fbootstrap | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fgetting-started\u002Fworkspace.mdx` |\n| Provider changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fghost\u002Fproviders.md` |\n| Agent changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fagents\u002F` (introduction.md, syntax.md, context.md, cron.md, agent-control.md) |\n| Chat\u002Fsession changes | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fchat\u002F` (sessions.md, compaction.md) |\n| Knowledge features | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fknowledge\u002F` (knowledge.mdx, reflection.md, tools.md) |\n| Skills & tools overview | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fskills-and-tools\u002F` (overview.md, creating-skills.md, default-skills.md, core-tools.md) |\n| Web research features | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fweb-research\u002F` (overview.md, tools.md) |\n| Identity\u002Finterfaces | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fghost\u002F` (identity.md, interfaces.mdx, providers.md) |\n| Dependencies | `docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Freference\u002Fdependencies.md` |\n\n## Build Verification\n\nAlways verify docs build after changes:\n\n```sh\ncd docs && npm run build\n```\n\n## Formatting\n\n- Docs content (`docs\u002Fsrc\u002Fcontent\u002F**`) is excluded from oxfmt because Starlight's `:::`\n admonition syntax is not supported by Prettier-compatible formatters.\n- Line width: 88 characters for all other markdown\u002FMDX\u002FJSON\u002FTOML (via oxfmt).\n\n## Terminology\n\nAlways write `GHOST` and `OPERATOR` in all caps in prose. Keep real code\u002Ffile\nidentifiers (crate names, paths, variable names) unchanged.\n",{"name":5,"description":7},"main","083d96429a2d05526f8a294b83c74f0336670def",".agents\u002Fskills\u002Fdocs",0,"https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST","https:\u002F\u002Fgithub.com\u002Fmrtolkien","https:\u002F\u002Fblog.tolki.dev","Data Engineer \u002F Esports \u002F Keyboards","2026-04-24 15:41:08",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add mrtolkien\u002FGHOST --skill docs",{"tool":58,"command":59},"bunx","bunx skills add mrtolkien\u002FGHOST --skill docs",{"tool":61,"command":62},"pnpm","pnpm dlx skills add mrtolkien\u002FGHOST --skill docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fdocs\u002FSKILL.md",true,[],[67,92,118,136,144,155],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":38},"01M6CS613RWD9CFJ3KFX47V1DS","system-management","Use when reading or changing GHOST configuration (providers, models, timing, compaction, services, any config.toml key), adding or switching LLM providers, answering questions about GHOST's own features or capabilities, a CLI tool is missing or \"not found\", services need starting\u002Fstopping\u002Fdebugging, updating GHOST to a newer version, managing the Nix shell environment, or troubleshooting GHOST setup.","https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST\u002Fblob\u002Fmain\u002Fassets\u002Fskills\u002Fsystem-management\u002Fskill.md",[],[74,75,76,77,20,78,79,80,81,82,83,84,29,85,86,87,88,89,90,91],"system management","management","system","shell","nix","config","setup","debugging","capabilities","services","Providers","tool","troubleshooting","environment","use","version","models","configuration",{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":111,"publishedAt":38},"01M6CS5XTK2884R9HE15YR8YZM","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST\u002Fblob\u002Fmain\u002Fassets\u002Fskills\u002Fsuperpowers\u002Fwriting-skills\u002Fskill.md",[98,103,106],{"categoryNo":99,"categoryName":100,"taxonomyType":101,"taxonomyTypeDesc":102},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",{"categoryNo":104,"categoryName":105,"taxonomyType":101,"taxonomyTypeDesc":102},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":107,"categoryName":108,"taxonomyType":109,"taxonomyTypeDesc":110},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[112,113,114,115,116,88,117],"writing skills","writing","coding","work","editing","deployment",{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":126,"publishedAt":38},"01M6CS5V737R1DVB3TZEK0C6WT","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code. Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste.","https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST\u002Fblob\u002Fmain\u002Fassets\u002Fskills\u002Fsuperpowers\u002Fwriting-plans\u002Fskill.md",[124,125],{"categoryNo":104,"categoryName":105,"taxonomyType":101,"taxonomyTypeDesc":102},{"categoryNo":107,"categoryName":108,"taxonomyType":109,"taxonomyTypeDesc":110},[127,113,128,129,130,114,131,132,88,133,134,135],"writing plans","spec","code","ZeRO","write","context","engineer","implementation","task",{"skillNo":137,"name":33,"nameZh":6,"description":138,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":141,"publishedAt":38},"01M6CS5S5S0YY56686G5CQ0WMP","Use when about to claim work is complete, fixed, or passing, before committing or creating PRs. Requires running verification commands and confirming output before making any success claims. Evidence before assertions, always.","https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST\u002Fblob\u002Fmain\u002Fassets\u002Fskills\u002Fsuperpowers\u002Fverification\u002Fskill.md",[],[33,114,115,88,142,143],"evidence","claim",{"skillNo":145,"name":146,"nameZh":6,"description":147,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":148,"categories":149,"keywords":151,"publishedAt":38},"01M6CS5PD2ZSFWYRDZSACNTAJY","tdd","Use when implementing any feature or bugfix, before writing implementation code. Write the test first. Watch it fail. Write minimal code to pass.","https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST\u002Fblob\u002Fmain\u002Fassets\u002Fskills\u002Fsuperpowers\u002Ftdd\u002Fskill.md",[150],{"categoryNo":99,"categoryName":100,"taxonomyType":101,"taxonomyTypeDesc":102},[146,113,129,152,114,131,88,153,134,154],"first","minimal","test",{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":159,"categories":160,"keywords":162,"publishedAt":38},"01M6CS5K5WE2SHF1YV8D9C4C77","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002Fmrtolkien\u002FGHOST\u002Fblob\u002Fmain\u002Fassets\u002Fskills\u002Fsuperpowers\u002Fsystematic-debugging\u002Fskill.md",[161],{"categoryNo":99,"categoryName":100,"taxonomyType":101,"taxonomyTypeDesc":102},[163,81,22,88,114,154,164],"systematic debugging","bug"]