[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76WWRTBBAPNKM0PA2NG5Q3N":3,"skill-same:01M76WWRTBBAPNKM0PA2NG5Q3N":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M76WWRTBBAPNKM0PA2NG5Q3N","magus-upstream-docs",null,"egladman\u002Fmagus","egladman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8713153?v=4","01M75H42QB5A4X82APZF4H44GM","Eli Gladman","01M75H42R1K59Z7JWAP621J849",3,"GPL-3.0","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-upstream-docs\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"{{if .Full}}# Navigating the magus docs{{else}}# magus docs{{end}}\n{{if .Full}}\nmagus ships one official documentation site. It is a static site, so its\nstructure is fixed and machine-readable: this skill teaches HOW to move through\nit; the pages themselves carry the WHAT. Use it for a magus-domain fact the\nworkspace graph cannot give: the docs are the source of truth for\nmagus's own behavior, so read them rather than guessing.\n{{end}}\n{{if .Full}}Send a docs lookup whose answer is all you need to the `magus-scout` agent, where your\nharness installed one. Otherwise use a worker on your host's cheapest model.{{else}}One official docs site.\nUse for magus-domain fact workspace graph cannot give: docs are source of truth for magus behavior.\nDocs lookup whose answer is all you need -> `magus-scout` agent, where harness installed one; otherwise worker on host's cheapest model.{{end}}\n\n{{if .Full}}Two places serve the same pages:\n{{else}}Two places serve same pages:{{end}}\n{{if .Full}}- In the magus repo (a `magusfile.buzz` at the root, a `docs\u002F` tree): query the section\n  (next), or read `docs\u002F\u003Cname>.md` when you know the page. This is where\n  the skill is dogfooded, so prefer it here.{{else}}- magus repo (`magusfile.buzz` at root, `docs\u002F` tree): query section (next), or read `docs\u002F\u003Cname>.md` when you know page.{{end}}\n{{if .Full}}- Published: `https:\u002F\u002Feli.gladman.cc\u002Fmagus\u002F`. Every page is also raw Markdown at\n  `\u003Cpage-url>index.md`.{{else}}- Published: `https:\u002F\u002Feli.gladman.cc\u002Fmagus\u002F`; every page also raw Markdown at `\u003Cpage-url>index.md`.{{end}}\n\n{{if .Full}}## In a magus workspace, ask the graph for the passage{{else}}## In workspace: ask graph for passage{{end}}\n\n{{if .Full}}Every Markdown heading is a `docsection` node, so \"where is this explained\" is a\nquery, not a scan:{{else}}Every Markdown heading is `docsection` node -> \"where is this explained\" is query, not scan:{{end}}\n\n```sh\nmagus query kind=docsection \"cache key\"\n```\n\n{{if .Full}}Each result's id is `\u003Cpath>#\u003Canchor>`. Read that section, not the whole file.\n`project=\u003Cp>` scopes it, and `{{cmd \"explain\"}} \"docsection:\u003Cpath>#\u003Canchor>\"` walks the\npage's outline from there. The index route below is for the PUBLISHED site,\nwhich has no graph.{{else}}Result id: `\u003Cpath>#\u003Canchor>`. Each result: read that section, not whole file.\nIndex route below: PUBLISHED site only, which has no graph.{{end}}\n\n{{if .Full}}## Fast path: start from the index, do not guess URLs{{else}}## Fast path: index, do not guess URLs{{end}}\n\n{{if .Full}}Two files at the docs root turn \"find the page\" into a lookup:\n{{else}}Two files at docs root:{{end}}\n{{if .Full}}- `llms.txt`: one titled link per page to its raw Markdown (`\u003Curl>index.md`), with a\n  one-line description. Read it FIRST, then fetch the page's `index.md`.{{else}}- `llms.txt`: one titled link per page to raw Markdown (`\u003Curl>index.md`), one-line description. Read FIRST, then fetch page's `index.md`.{{end}}\n{{if .Full}}- `search-index.json`: an array of `{url, title, text, tags, description}`, one\n  record per page. Grep it for a keyword when you do not know the page name.{{else}}- `search-index.json`: array of `{url, title, text, tags, description}`, one record per page. Search when you do not know page name.{{end}}{{if .Full}}\n\nWRONG: guess `https:\u002F\u002F...\u002Fgo-spell` or grep the open web.\nCORRECT: read `llms.txt` (or `docs\u002F` locally), find the entry, fetch its Markdown.{{end}}\n\n## URL scheme\n\n{{if .Full}}Pages use extensionless directory URLs; append `index.md` for the raw source.\n\n| You have                     | Page URL             | Raw Markdown                |\n| ---------------------------- | -------------------- | --------------------------- |\n| the `go` spell               | `\u002Fspells\u002Fgo\u002F`        | `\u002Fspells\u002Fgo\u002Findex.md`       |\n| the `{{cmd \"run\"}}` command      | `\u002Fmanpage\u002F{{skill \"run\"}}\u002F`| `\u002Fmanpage\u002F{{skill \"run\"}}\u002Findex.md`|\n| diagnostic {{mgs \"MGS2001\"}}           | `\u002Fcodes\u002Fsandbox\u002F{{mgs \"MGS2001\"}}\u002F` | `...\u002F{{mgs \"MGS2001\"}}\u002Findex.md` |{{else}}Extensionless directory URLs; append `index.md` for raw source.\n- `go` spell: `\u002Fspells\u002Fgo\u002F` -> `\u002Fspells\u002Fgo\u002Findex.md`\n- `{{cmd \"run\"}}` command: `\u002Fmanpage\u002Fmagus-run\u002F` -> `\u002Fmanpage\u002Fmagus-run\u002Findex.md`\n- diagnostic {{mgs \"MGS2001\"}}: `\u002Fcodes\u002Fsandbox\u002FMGS2001\u002F` -> `...\u002FMGS2001\u002Findex.md`{{end}}\n\n{{if .Full}}## Where things live (stable IDs route straight to a page){{else}}## Where things live{{end}}\n\n{{if .Full}}Each stable ID maps to a fixed section, so you jump without searching:\n\n| Looking for                        | Go to                        |\n| ---------------------------------- | ---------------------------- |\n| a CLI command \u002F flag               | `\u002Fmanpage\u002Fmagus-\u003Ccmd>\u002F`      |\n| a spell and its ops                | `\u002Fspells\u002F\u003Cname>\u002F`            |\n| a diagnostic `MGSxxxx`             | `\u002Fcodes\u002F` (grouped by family)|\n| a stdlib module (fs, os, http, ...)| `\u002Fbuzz\u002Fmodules\u002F\u003Cname>\u002F`      |\n| a core concept (targets, cache, charms, sandbox, affected, ...) | `\u002F\u003Cconcept>\u002F` |\n| install \u002F download                 | `\u002Fdownload\u002F` and its children|\n| the whole map                      | `\u002Fdocumentation\u002F`            |{{else}}Each stable ID maps to fixed section:\n- CLI command \u002F flag: `\u002Fmanpage\u002Fmagus-\u003Ccmd>\u002F`\n- spell and ops: `\u002Fspells\u002F\u003Cname>\u002F`\n- diagnostic `MGSxxxx`: `\u002Fcodes\u002F` (grouped by family)\n- stdlib module (fs, os, http, ...): `\u002Fbuzz\u002Fmodules\u002F\u003Cname>\u002F`\n- core concept (targets, cache, charms, sandbox, affected, ...): `\u002F\u003Cconcept>\u002F`\n- install \u002F download: `\u002Fdownload\u002F` and children\n- whole map: `\u002Fdocumentation\u002F`{{end}}\n\n{{if .Full}}## Traversing within the docs{{else}}## Traversing{{end}}\n{{if .Full}}\nEvery page has three axes, so from one page you can reach its whole area:\n{{end}}\n{{if .Full}}- Breadcrumb (up): the trail back to `\u002Fdocumentation\u002F`.{{else}}Every page, three axes:\n- Breadcrumb (up): trail back to `\u002Fdocumentation\u002F`.{{end}}\n{{if .Full}}- \"In this section\" (siblings + children): the other pages under this section's\n  landing. A `page_type: overview` page IS a section landing.{{else}}- \"In this section\" (siblings, children): other pages under section landing.{{end}}\n{{if .Full}}- Prev \u002F next (pager): the adjacent pages in the section.{{else}}- Prev \u002F next (pager): adjacent pages in section.{{end}}\n\n{{if .Full}}So: land via `llms.txt`, read the page, then use \"In this section\" to sweep its\nsiblings; do not re-search for each one.{{else}}Land via `llms.txt`, then sweep siblings via \"In this section\".{{end}}\n\n{{if .Full}}## The published site follows main, not your build{{else}}## Published site follows main, not your build{{end}}\n\n{{if .Full}}The site and its source links (`\u002Fblob\u002Fmain\u002F`) are rendered from main. The binary\nyou run may be older: a flag, an op or a diagnostic can differ between a page\nand your build. When they disagree, trust what the binary prints, such as\n`magus \u003Ccommand> -h`.\n\nTo read a linked file as your build has it, replace `blob\u002Fmain` with\n`blob\u002F\u003Ccommit>`. Take the commit from `{{cmd \"version\"}} -o json`. Find the symbol by\nname: line numbers move between versions, so the link's anchor points at main's line.\n\nIf the docs and the behavior still disagree after that, and you have a\nreproduction, the {{skill \"upstream-source\"}} skill traces the code at your build.{{else}}Site and source links (`\u002Fblob\u002Fmain\u002F`) render from main; binary may be older.\nWhen they disagree -> trust binary output, like `magus \u003Ccommand> -h`.\nLinked file as your build has it: replace `blob\u002Fmain` with `blob\u002F\u003Ccommit>`; commit from `{{cmd \"version\"}} -o json`.\nFind symbol by name; line numbers move.\nIf docs and behavior still disagree after that, and you have reproduction -> {{skill \"upstream-source\"}} skill traces code at your build.{{end}}\n\n{{if .Full}}## In the magus repo{{else}}## In magus repo{{end}}\n\n{{if .Full}}`docs\u002F` Markdown is the source of truth; `docs\u002Fgen\u002F` is generated (never edit it;\nchange the source and regenerate). MAGUS.md is a routing index for HUMAN readers;\ndo not answer from it: it is true only as of the\nlast regeneration, and every fact in it has a live command. The knowledge graph\ncarries every page as a `doc` node, so `{{cmd \"query\"}} \"kind=doc\"` (see the\n{{skill \"query\"}} skill) lists them from the graph.{{else}}`docs\u002F` Markdown: source of truth.\n`docs\u002Fgen\u002F`: generated; never edit; change source, regenerate.\nMAGUS.md: routing index for HUMAN readers; do not answer from it: true only as of last regeneration.\n`{{cmd \"query\"}} \"kind=doc\"` lists every page from graph.{{end}}\n",{},"main","5f0df014d9eaf4aea1a930b0bd13c3338e2642de","internal\u002Fagent\u002Fskills\u002Fmagus-upstream-docs",0,"https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus","http:\u002F\u002Feli.gladman.cc\u002Fmagus\u002F","https:\u002F\u002Fgithub.com\u002Fegladman","eli.gladman.cc","2026-11-14 12:23:44",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add egladman\u002Fmagus --skill magus-upstream-docs",{"tool":37,"command":38},"bunx","bunx skills add egladman\u002Fmagus --skill magus-upstream-docs",{"tool":40,"command":41},"pnpm","pnpm dlx skills add egladman\u002Fmagus --skill magus-upstream-docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-upstream-docs\u002FSKILL.md",true,[],[46,52,58,64,70,76],{"skillNo":47,"name":48,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":18},"01M76WWZ75J70NCG0TR23XDDE6","magus-workspace-rules","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-workspace-rules\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M76WWX72SY78KG03AVYFE768","magus-vcs-hygiene","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-vcs-hygiene\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":18},"01M76WWTJYGRCKKXH948KN6RR3","magus-upstream-source","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-upstream-source\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M76WWNTF03H9S5CN22QBX5ZK","magus-test-design","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-test-design\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M76WWJX1FPSWYD1RB8JXNF3C","magus-sdk","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-sdk\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M76WWGW39RTK0GRPX4QJXF9V","magus-run","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-run\u002FSKILL.md",[],[]]