[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-posthog-skills-store":3,"mdc--9e31np-key":28,"related-org-posthog-skills-store":3606,"related-repo-posthog-skills-store":3781},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":17,"repoUrl":18,"updatedAt":19,"license":20,"forks":21,"topics":22,"repo":23,"sourceUrl":26,"mdContent":27},"skills-store","manage shared agent skills in PostHog","Discover and use shared team skills stored in PostHog. Use when the user asks to list, browse, load, or manage \"shared skills\", \"team skills\", or references the \"skills store\" \u002F \"skill store\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"posthog","PostHog","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fposthog.png",[12,14],{"name":9,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"Knowledge Management","knowledge-management",56,"https:\u002F\u002Fgithub.com\u002FPostHog\u002Fskills","2026-04-15T05:05:51.76294",null,4,[],{"repoUrl":18,"stars":17,"forks":21,"topics":24,"description":25},[],"PostHog skills (under construction)","https:\u002F\u002Fgithub.com\u002FPostHog\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fomnibus\u002Fskills-store","---\nname: skills-store\ndescription: >-\n  Discover and use shared team skills stored in PostHog.\n  Use when the user asks to list, browse, load, or manage \"shared skills\",\n  \"team skills\", or references the \"skills store\" \u002F \"skill store\".\n---\n\n# PostHog Skills Store\n\nSkills are reusable agent workflows stored in PostHog following the [Agent Skills specification](https:\u002F\u002Fagentskills.io\u002Fspecification) — a body of instructions (SKILL.md) plus optional bundled files (scripts, references, assets), structured metadata, and an `allowed_tools` list.\n\nPostHog is the primary store for team-shared skills — always use the PostHog MCP skill tools to manage them.\n\n## Available tools\n\n| Tool                             | Purpose                                                    |\n| -------------------------------- | ---------------------------------------------------------- |\n| `posthog:llma-skill-list`        | List all available skills (Level 1 — names + descriptions) |\n| `posthog:llma-skill-get`         | Fetch a skill by name (Level 2 — body + file manifest)     |\n| `posthog:llma-skill-file-get`    | Fetch a single bundled file by path (Level 3 — on demand)  |\n| `posthog:llma-skill-create`      | Store a new skill (optionally with bundled files)          |\n| `posthog:llma-skill-update`      | Publish a new version (body, `edits`, or `file_edits`)     |\n| `posthog:llma-skill-file-create` | Add one bundled file to a skill (publishes a new version)  |\n| `posthog:llma-skill-file-delete` | Remove one bundled file from a skill                       |\n| `posthog:llma-skill-file-rename` | Rename one bundled file (move without rewriting content)   |\n| `posthog:llma-skill-duplicate`   | Duplicate an existing skill under a new name               |\n| `posthog:llma-skill-archive`     | Archive all versions of a skill by name (cannot be undone) |\n\nSkills use progressive disclosure: discover by description, fetch the body only when relevant, and pull individual files on demand. Do not fetch every file eagerly.\n\n## Discovering skills\n\nList all available skills:\n\n```json\nposthog:llma-skill-list\n{}\n```\n\nSearch by keyword (matches name and description):\n\n```json\nposthog:llma-skill-list\n{ \"search\": \"fractal\" }\n```\n\n`llma-skill-list` returns only name + description — never the body. Use descriptions to decide which skill to fetch. The whole point of descriptions is that you can pick the right skill without loading any bodies.\n\n## Loading and using a skill\n\n### Step 1 — Fetch the skill by name\n\n```json\nposthog:llma-skill-get\n{ \"skill_name\": \"make-fractals\" }\n```\n\nThe response contains:\n\n- `body` — the full SKILL.md instructions (read these like system instructions for the task)\n- `license`, `compatibility`, `allowed_tools`, `metadata` — spec fields\n- `files[]` — manifest of bundled files (path + content_type only, not content)\n\n### Step 2 — Follow the body\n\nRead `body` and follow it. Treat it as your system instructions for this task.\n\n### Step 3 — Fetch bundled files as needed\n\nWhen the body references a script or reference doc, pull it on demand:\n\n```json\nposthog:llma-skill-file-get\n{ \"skill_name\": \"make-fractals\", \"file_path\": \"scripts\u002Fmandelbrot.py\" }\n```\n\nOnly fetch files you actually need. If the body's decision tree points at one script, don't preload the others.\n\n## Creating a skill\n\nFollow the [Agent Skills specification](https:\u002F\u002Fagentskills.io\u002Fspecification) when creating skills:\n\n- **`name`** — kebab-case, max 64 chars, no leading\u002Ftrailing\u002Fconsecutive hyphens\n- **`description`** — explain what it does AND when to use it. Include keywords agents will search for. This is the only thing visible at discovery time — make it count.\n- **`body`** — keep under ~500 lines. Move detailed reference material, SQL, scripts, and long examples into bundled `files` so the body stays scannable.\n- **Files** — use `scripts\u002F` for executable code, `references\u002F` for docs, `assets\u002F` for templates\u002Fdata. Agents pull these on demand via `llma-skill-file-get`, so splitting keeps context lean.\n\nBundled files are optional and can be included in a single create call:\n\n```json\nposthog:llma-skill-create\n{\n  \"name\": \"make-fractals\",\n  \"description\": \"Generate fractal images as PNGs. Use when the user asks to make, render, or visualize fractals.\",\n  \"body\": \"# make-fractals\\n\\nWhen to use... Workflow... Output contract...\",\n  \"license\": \"MIT\",\n  \"compatibility\": \"Requires Python 3.10+ with Pillow and numpy\",\n  \"allowed_tools\": [\"Bash\", \"Write\"],\n  \"metadata\": { \"author\": \"posthog\", \"category\": \"visualization\" },\n  \"files\": [\n    { \"path\": \"scripts\u002Fmandelbrot.py\", \"content\": \"...\", \"content_type\": \"text\u002Fx-python\" },\n    { \"path\": \"references\u002Fprimer.md\", \"content\": \"# Primer\\n...\", \"content_type\": \"text\u002Fmarkdown\" }\n  ]\n}\n```\n\n## Updating a skill\n\nEach write publishes a new immutable version. Always fetch first to get the current version, then update with `base_version` for concurrency checks:\n\n```json\nposthog:llma-skill-get\n{ \"skill_name\": \"make-fractals\" }\n```\n\nPick the most surgical primitive for what you're changing — the API offers several so you don't have to round-trip the whole skill to tweak one part. Anything you don't touch is carried forward from the current latest.\n\n### Editing the body\n\nFull replacement (good for substantial rewrites):\n\n```json\nposthog:llma-skill-update\n{\n  \"skill_name\": \"make-fractals\",\n  \"body\": \"# make-fractals\\n\\nUpdated instructions...\",\n  \"base_version\": 2\n}\n```\n\nIncremental find\u002Freplace (good for small tweaks — no round-tripping the whole body):\n\n```json\nposthog:llma-skill-update\n{\n  \"skill_name\": \"make-fractals\",\n  \"edits\": [\n    { \"old\": \"Use Pillow for rendering.\", \"new\": \"Use Pillow ≥10.0 for rendering.\" }\n  ],\n  \"base_version\": 2\n}\n```\n\nEach `edits[].old` must match exactly once. `body` and `edits` are mutually exclusive.\n\n### Editing one bundled file\n\nUse `file_edits` to patch a single file without resending any other file:\n\n```json\nposthog:llma-skill-update\n{\n  \"skill_name\": \"make-fractals\",\n  \"file_edits\": [\n    {\n      \"path\": \"scripts\u002Fmandelbrot.py\",\n      \"edits\": [\n        { \"old\": \"ITERATIONS = 100\", \"new\": \"ITERATIONS = 250\" }\n      ]\n    }\n  ],\n  \"base_version\": 2\n}\n```\n\nNon-targeted files carry forward unchanged. `file_edits` cannot add, remove, or rename files — use the per-file tools below for that.\n\n### File-path parameter naming\n\nThe file-path parameter has two names depending on where it sits in the request, so don't guess:\n\n- **`file_path`** — `llma-skill-file-get` and `llma-skill-file-delete` (the path is part of the URL).\n- **`path`** — `llma-skill-file-create`, plus the `files=[{path, …}]` array and `file_edits=[{path, …}]` (body fields on a file object).\n- **`old_path` \u002F `new_path`** — `llma-skill-file-rename`.\n\nPassing `path` to file-get produces a `\u002Ffiles\u002Fundefined\u002F` 404. When in doubt, check the tool's input schema.\n\n### Adding, removing, or renaming a file\n\nAtomic per-file tools — each publishes a new version and returns the updated skill (read its `version` to chain further edits via `base_version`):\n\n```json\nposthog:llma-skill-file-create\n{ \"skill_name\": \"make-fractals\", \"path\": \"scripts\u002Fjulia.py\", \"content\": \"...\", \"base_version\": 2 }\n```\n\n```json\nposthog:llma-skill-file-delete\n{ \"skill_name\": \"make-fractals\", \"file_path\": \"scripts\u002Fold.py\", \"base_version\": 3 }\n```\n\n```json\nposthog:llma-skill-file-rename\n{ \"skill_name\": \"make-fractals\", \"old_path\": \"scripts\u002Fjulia.py\", \"new_path\": \"scripts\u002Fjulia_set.py\", \"base_version\": 4 }\n```\n\n### Replacing the whole bundle (rare)\n\nPassing `files` to `llma-skill-update` replaces ALL bundled files — anything not in the array is dropped. Only use this when you intentionally want to wipe and reseed the bundle. For everything else, prefer `file_edits` or the per-file CRUD tools above.\n\n## Archiving a skill\n\n`llma-skill-archive` hides every active version of a skill by name. It cannot be undone — the skill disappears from `llma-skill-list` and `llma-skill-get` for the whole team. Use it to retire a skill entirely; to remove a single file use `llma-skill-file-delete`, and to roll back content publish a new version instead.\n\n```json\nposthog:llma-skill-archive\n{ \"skill_name\": \"make-fractals\" }\n```\n\n## Porting a local skill\n\nTo move a skill from a local SKILL.md directory (e.g. a local skills folder with `scripts\u002F`, `references\u002F`, `assets\u002F` subdirs) into PostHog:\n\n1. Read the local `SKILL.md` — use its frontmatter for `name`, `description`, `license`, `compatibility`, `allowed_tools`, `metadata`; the body after the frontmatter becomes `body`\n2. Walk the `scripts\u002F`, `references\u002F`, and `assets\u002F` subdirs and collect each file as `{ path, content, content_type }`\n3. Call `posthog:llma-skill-create` with everything in one shot — the skill lands at v1 with its full bundle\n\nThe skill is then available to the whole team via `posthog:llma-skill-get`.\n\n## Quick access: local bridge skill\n\nMost coding agents support local skills or slash commands. A local bridge skill gives you a shortcut (e.g. `\u002Fphs my-github`) that routes straight to the PostHog skills API — faster and more deterministic than asking the agent to \"use the PostHog skills store to load my-github\".\n\nCreate a local skill in your agent's skills directory with these instructions:\n\n```markdown\n---\nname: phs\ndescription: >-\n  Access and run shared team skills stored in PostHog.\n  Use when the user asks to list, run, or manage PostHog skills,\n  or references \u002Fphs, \"ph skills\", or \"posthog skills\".\nuser-invocable: true\nallowed-tools: mcp__posthog__llma-skill-list, mcp__posthog__llma-skill-get, mcp__posthog__llma-skill-create, mcp__posthog__llma-skill-update, mcp__posthog__llma-skill-file-get, mcp__posthog__llma-skill-file-create, mcp__posthog__llma-skill-file-delete, mcp__posthog__llma-skill-file-rename, mcp__posthog__llma-skill-duplicate\n---\n\n# PostHog Skills Store\n\nLocal bridge to the PostHog Skills Store.\n\n## Load and run a skill\n\nWhen the user says `\u002Fphs \u003Cskill-name>`:\n\n1. `llma-skill-get(skill_name=\"\u003Cskill-name>\")` to fetch body + file manifest\n2. Read the `body` field — follow it as system instructions for this task\n3. Use `llma-skill-file-get` to pull bundled scripts\u002Freferences on demand\n\n## List skills\n\nllma-skill-list # all skills\nllma-skill-list(search=\"llma\") # filter by keyword\n\n## Create \u002F update\n\nllma-skill-create(name=\"my-skill\", description=\"...\", body=\"# Instructions...\")\nllma-skill-get → note version → llma-skill-update(skill_name=\"...\", base_version=N, body=\"...\")\n\n## Edit one part of an existing skill\n\nllma-skill-get → note version → pick the smallest primitive:\n\n- body tweak: llma-skill-update(skill_name=\"...\", base_version=N, edits=[{old, new}])\n- one bundled file: llma-skill-update(skill_name=\"...\", base_version=N, file_edits=[{path, edits:[{old, new}]}])\n- add\u002Fremove\u002Frename a file: llma-skill-file-create \u002F llma-skill-file-delete \u002F llma-skill-file-rename\n```\n\nThe bridge is intentionally minimal — it just routes to the MCP tools. The real instructions live in PostHog and update without touching local files.\n\n> **Agent-specific setup:** Where to save this depends on your agent. For Claude Code, save as `~\u002F.claude\u002Fskills\u002Fphs\u002FSKILL.md`. For other agents, consult your agent's docs on local skill or slash command configuration.\n\n## Default behavior\n\n- **Always prefer PostHog MCP** for skill storage and retrieval\n- Only fall back to local files when PostHog MCP is unavailable\n- When asked to \"save\", \"store\", or \"remember\" a workflow, runbook, or multi-step procedure, store it as a PostHog skill\n- When asked to use a skill by name, use `llma-skill-get` first\n- When a skill references bundled files in its body, pull them with `llma-skill-file-get` only when needed — don't preload\n",{"data":29,"body":30},{"name":4,"description":6},{"type":31,"children":32},"root",[33,42,68,73,80,294,299,305,310,343,348,410,421,427,434,490,495,554,560,572,578,583,672,677,683,695,790,795,1436,1442,1455,1507,1512,1518,1523,1656,1661,1853,1880,1886,1898,2171,2183,2189,2194,2289,2309,2315,2335,2479,2591,2735,2741,2767,2773,2805,2859,2865,2889,2991,3002,3008,3021,3026,3520,3525,3547,3553,3600],{"type":34,"tag":35,"props":36,"children":38},"element","h1",{"id":37},"posthog-skills-store",[39],{"type":40,"value":41},"text","PostHog Skills Store",{"type":34,"tag":43,"props":44,"children":45},"p",{},[46,48,57,59,66],{"type":40,"value":47},"Skills are reusable agent workflows stored in PostHog following the ",{"type":34,"tag":49,"props":50,"children":54},"a",{"href":51,"rel":52},"https:\u002F\u002Fagentskills.io\u002Fspecification",[53],"nofollow",[55],{"type":40,"value":56},"Agent Skills specification",{"type":40,"value":58}," — a body of instructions (SKILL.md) plus optional bundled files (scripts, references, assets), structured metadata, and an ",{"type":34,"tag":60,"props":61,"children":63},"code",{"className":62},[],[64],{"type":40,"value":65},"allowed_tools",{"type":40,"value":67}," list.",{"type":34,"tag":43,"props":69,"children":70},{},[71],{"type":40,"value":72},"PostHog is the primary store for team-shared skills — always use the PostHog MCP skill tools to manage them.",{"type":34,"tag":74,"props":75,"children":77},"h2",{"id":76},"available-tools",[78],{"type":40,"value":79},"Available tools",{"type":34,"tag":81,"props":82,"children":83},"table",{},[84,103],{"type":34,"tag":85,"props":86,"children":87},"thead",{},[88],{"type":34,"tag":89,"props":90,"children":91},"tr",{},[92,98],{"type":34,"tag":93,"props":94,"children":95},"th",{},[96],{"type":40,"value":97},"Tool",{"type":34,"tag":93,"props":99,"children":100},{},[101],{"type":40,"value":102},"Purpose",{"type":34,"tag":104,"props":105,"children":106},"tbody",{},[107,125,142,159,176,209,226,243,260,277],{"type":34,"tag":89,"props":108,"children":109},{},[110,120],{"type":34,"tag":111,"props":112,"children":113},"td",{},[114],{"type":34,"tag":60,"props":115,"children":117},{"className":116},[],[118],{"type":40,"value":119},"posthog:llma-skill-list",{"type":34,"tag":111,"props":121,"children":122},{},[123],{"type":40,"value":124},"List all available skills (Level 1 — names + descriptions)",{"type":34,"tag":89,"props":126,"children":127},{},[128,137],{"type":34,"tag":111,"props":129,"children":130},{},[131],{"type":34,"tag":60,"props":132,"children":134},{"className":133},[],[135],{"type":40,"value":136},"posthog:llma-skill-get",{"type":34,"tag":111,"props":138,"children":139},{},[140],{"type":40,"value":141},"Fetch a skill by name (Level 2 — body + file manifest)",{"type":34,"tag":89,"props":143,"children":144},{},[145,154],{"type":34,"tag":111,"props":146,"children":147},{},[148],{"type":34,"tag":60,"props":149,"children":151},{"className":150},[],[152],{"type":40,"value":153},"posthog:llma-skill-file-get",{"type":34,"tag":111,"props":155,"children":156},{},[157],{"type":40,"value":158},"Fetch a single bundled file by path (Level 3 — on demand)",{"type":34,"tag":89,"props":160,"children":161},{},[162,171],{"type":34,"tag":111,"props":163,"children":164},{},[165],{"type":34,"tag":60,"props":166,"children":168},{"className":167},[],[169],{"type":40,"value":170},"posthog:llma-skill-create",{"type":34,"tag":111,"props":172,"children":173},{},[174],{"type":40,"value":175},"Store a new skill (optionally with bundled files)",{"type":34,"tag":89,"props":177,"children":178},{},[179,188],{"type":34,"tag":111,"props":180,"children":181},{},[182],{"type":34,"tag":60,"props":183,"children":185},{"className":184},[],[186],{"type":40,"value":187},"posthog:llma-skill-update",{"type":34,"tag":111,"props":189,"children":190},{},[191,193,199,201,207],{"type":40,"value":192},"Publish a new version (body, ",{"type":34,"tag":60,"props":194,"children":196},{"className":195},[],[197],{"type":40,"value":198},"edits",{"type":40,"value":200},", or ",{"type":34,"tag":60,"props":202,"children":204},{"className":203},[],[205],{"type":40,"value":206},"file_edits",{"type":40,"value":208},")",{"type":34,"tag":89,"props":210,"children":211},{},[212,221],{"type":34,"tag":111,"props":213,"children":214},{},[215],{"type":34,"tag":60,"props":216,"children":218},{"className":217},[],[219],{"type":40,"value":220},"posthog:llma-skill-file-create",{"type":34,"tag":111,"props":222,"children":223},{},[224],{"type":40,"value":225},"Add one bundled file to a skill (publishes a new version)",{"type":34,"tag":89,"props":227,"children":228},{},[229,238],{"type":34,"tag":111,"props":230,"children":231},{},[232],{"type":34,"tag":60,"props":233,"children":235},{"className":234},[],[236],{"type":40,"value":237},"posthog:llma-skill-file-delete",{"type":34,"tag":111,"props":239,"children":240},{},[241],{"type":40,"value":242},"Remove one bundled file from a skill",{"type":34,"tag":89,"props":244,"children":245},{},[246,255],{"type":34,"tag":111,"props":247,"children":248},{},[249],{"type":34,"tag":60,"props":250,"children":252},{"className":251},[],[253],{"type":40,"value":254},"posthog:llma-skill-file-rename",{"type":34,"tag":111,"props":256,"children":257},{},[258],{"type":40,"value":259},"Rename one bundled file (move without rewriting content)",{"type":34,"tag":89,"props":261,"children":262},{},[263,272],{"type":34,"tag":111,"props":264,"children":265},{},[266],{"type":34,"tag":60,"props":267,"children":269},{"className":268},[],[270],{"type":40,"value":271},"posthog:llma-skill-duplicate",{"type":34,"tag":111,"props":273,"children":274},{},[275],{"type":40,"value":276},"Duplicate an existing skill under a new name",{"type":34,"tag":89,"props":278,"children":279},{},[280,289],{"type":34,"tag":111,"props":281,"children":282},{},[283],{"type":34,"tag":60,"props":284,"children":286},{"className":285},[],[287],{"type":40,"value":288},"posthog:llma-skill-archive",{"type":34,"tag":111,"props":290,"children":291},{},[292],{"type":40,"value":293},"Archive all versions of a skill by name (cannot be undone)",{"type":34,"tag":43,"props":295,"children":296},{},[297],{"type":40,"value":298},"Skills use progressive disclosure: discover by description, fetch the body only when relevant, and pull individual files on demand. Do not fetch every file eagerly.",{"type":34,"tag":74,"props":300,"children":302},{"id":301},"discovering-skills",[303],{"type":40,"value":304},"Discovering skills",{"type":34,"tag":43,"props":306,"children":307},{},[308],{"type":40,"value":309},"List all available skills:",{"type":34,"tag":311,"props":312,"children":317},"pre",{"className":313,"code":314,"language":315,"meta":316,"style":316},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","posthog:llma-skill-list\n{}\n","json","",[318],{"type":34,"tag":60,"props":319,"children":320},{"__ignoreMap":316},[321,333],{"type":34,"tag":322,"props":323,"children":326},"span",{"class":324,"line":325},"line",1,[327],{"type":34,"tag":322,"props":328,"children":330},{"style":329},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[331],{"type":40,"value":332},"posthog:llma-skill-list\n",{"type":34,"tag":322,"props":334,"children":336},{"class":324,"line":335},2,[337],{"type":34,"tag":322,"props":338,"children":340},{"style":339},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[341],{"type":40,"value":342},"{}\n",{"type":34,"tag":43,"props":344,"children":345},{},[346],{"type":40,"value":347},"Search by keyword (matches name and description):",{"type":34,"tag":311,"props":349,"children":351},{"className":313,"code":350,"language":315,"meta":316,"style":316},"posthog:llma-skill-list\n{ \"search\": \"fractal\" }\n",[352],{"type":34,"tag":60,"props":353,"children":354},{"__ignoreMap":316},[355,362],{"type":34,"tag":322,"props":356,"children":357},{"class":324,"line":325},[358],{"type":34,"tag":322,"props":359,"children":360},{"style":329},[361],{"type":40,"value":332},{"type":34,"tag":322,"props":363,"children":364},{"class":324,"line":335},[365,370,375,381,386,391,395,401,405],{"type":34,"tag":322,"props":366,"children":367},{"style":339},[368],{"type":40,"value":369},"{",{"type":34,"tag":322,"props":371,"children":372},{"style":339},[373],{"type":40,"value":374}," \"",{"type":34,"tag":322,"props":376,"children":378},{"style":377},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[379],{"type":40,"value":380},"search",{"type":34,"tag":322,"props":382,"children":383},{"style":339},[384],{"type":40,"value":385},"\"",{"type":34,"tag":322,"props":387,"children":388},{"style":339},[389],{"type":40,"value":390},":",{"type":34,"tag":322,"props":392,"children":393},{"style":339},[394],{"type":40,"value":374},{"type":34,"tag":322,"props":396,"children":398},{"style":397},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[399],{"type":40,"value":400},"fractal",{"type":34,"tag":322,"props":402,"children":403},{"style":339},[404],{"type":40,"value":385},{"type":34,"tag":322,"props":406,"children":407},{"style":339},[408],{"type":40,"value":409}," }\n",{"type":34,"tag":43,"props":411,"children":412},{},[413,419],{"type":34,"tag":60,"props":414,"children":416},{"className":415},[],[417],{"type":40,"value":418},"llma-skill-list",{"type":40,"value":420}," returns only name + description — never the body. Use descriptions to decide which skill to fetch. The whole point of descriptions is that you can pick the right skill without loading any bodies.",{"type":34,"tag":74,"props":422,"children":424},{"id":423},"loading-and-using-a-skill",[425],{"type":40,"value":426},"Loading and using a skill",{"type":34,"tag":428,"props":429,"children":431},"h3",{"id":430},"step-1-fetch-the-skill-by-name",[432],{"type":40,"value":433},"Step 1 — Fetch the skill by name",{"type":34,"tag":311,"props":435,"children":437},{"className":313,"code":436,"language":315,"meta":316,"style":316},"posthog:llma-skill-get\n{ \"skill_name\": \"make-fractals\" }\n",[438],{"type":34,"tag":60,"props":439,"children":440},{"__ignoreMap":316},[441,449],{"type":34,"tag":322,"props":442,"children":443},{"class":324,"line":325},[444],{"type":34,"tag":322,"props":445,"children":446},{"style":329},[447],{"type":40,"value":448},"posthog:llma-skill-get\n",{"type":34,"tag":322,"props":450,"children":451},{"class":324,"line":335},[452,456,460,465,469,473,477,482,486],{"type":34,"tag":322,"props":453,"children":454},{"style":339},[455],{"type":40,"value":369},{"type":34,"tag":322,"props":457,"children":458},{"style":339},[459],{"type":40,"value":374},{"type":34,"tag":322,"props":461,"children":462},{"style":377},[463],{"type":40,"value":464},"skill_name",{"type":34,"tag":322,"props":466,"children":467},{"style":339},[468],{"type":40,"value":385},{"type":34,"tag":322,"props":470,"children":471},{"style":339},[472],{"type":40,"value":390},{"type":34,"tag":322,"props":474,"children":475},{"style":339},[476],{"type":40,"value":374},{"type":34,"tag":322,"props":478,"children":479},{"style":397},[480],{"type":40,"value":481},"make-fractals",{"type":34,"tag":322,"props":483,"children":484},{"style":339},[485],{"type":40,"value":385},{"type":34,"tag":322,"props":487,"children":488},{"style":339},[489],{"type":40,"value":409},{"type":34,"tag":43,"props":491,"children":492},{},[493],{"type":40,"value":494},"The response contains:",{"type":34,"tag":496,"props":497,"children":498},"ul",{},[499,511,543],{"type":34,"tag":500,"props":501,"children":502},"li",{},[503,509],{"type":34,"tag":60,"props":504,"children":506},{"className":505},[],[507],{"type":40,"value":508},"body",{"type":40,"value":510}," — the full SKILL.md instructions (read these like system instructions for the task)",{"type":34,"tag":500,"props":512,"children":513},{},[514,520,522,528,529,534,535,541],{"type":34,"tag":60,"props":515,"children":517},{"className":516},[],[518],{"type":40,"value":519},"license",{"type":40,"value":521},", ",{"type":34,"tag":60,"props":523,"children":525},{"className":524},[],[526],{"type":40,"value":527},"compatibility",{"type":40,"value":521},{"type":34,"tag":60,"props":530,"children":532},{"className":531},[],[533],{"type":40,"value":65},{"type":40,"value":521},{"type":34,"tag":60,"props":536,"children":538},{"className":537},[],[539],{"type":40,"value":540},"metadata",{"type":40,"value":542}," — spec fields",{"type":34,"tag":500,"props":544,"children":545},{},[546,552],{"type":34,"tag":60,"props":547,"children":549},{"className":548},[],[550],{"type":40,"value":551},"files[]",{"type":40,"value":553}," — manifest of bundled files (path + content_type only, not content)",{"type":34,"tag":428,"props":555,"children":557},{"id":556},"step-2-follow-the-body",[558],{"type":40,"value":559},"Step 2 — Follow the body",{"type":34,"tag":43,"props":561,"children":562},{},[563,565,570],{"type":40,"value":564},"Read ",{"type":34,"tag":60,"props":566,"children":568},{"className":567},[],[569],{"type":40,"value":508},{"type":40,"value":571}," and follow it. Treat it as your system instructions for this task.",{"type":34,"tag":428,"props":573,"children":575},{"id":574},"step-3-fetch-bundled-files-as-needed",[576],{"type":40,"value":577},"Step 3 — Fetch bundled files as needed",{"type":34,"tag":43,"props":579,"children":580},{},[581],{"type":40,"value":582},"When the body references a script or reference doc, pull it on demand:",{"type":34,"tag":311,"props":584,"children":586},{"className":313,"code":585,"language":315,"meta":316,"style":316},"posthog:llma-skill-file-get\n{ \"skill_name\": \"make-fractals\", \"file_path\": \"scripts\u002Fmandelbrot.py\" }\n",[587],{"type":34,"tag":60,"props":588,"children":589},{"__ignoreMap":316},[590,598],{"type":34,"tag":322,"props":591,"children":592},{"class":324,"line":325},[593],{"type":34,"tag":322,"props":594,"children":595},{"style":329},[596],{"type":40,"value":597},"posthog:llma-skill-file-get\n",{"type":34,"tag":322,"props":599,"children":600},{"class":324,"line":335},[601,605,609,613,617,621,625,629,633,638,642,647,651,655,659,664,668],{"type":34,"tag":322,"props":602,"children":603},{"style":339},[604],{"type":40,"value":369},{"type":34,"tag":322,"props":606,"children":607},{"style":339},[608],{"type":40,"value":374},{"type":34,"tag":322,"props":610,"children":611},{"style":377},[612],{"type":40,"value":464},{"type":34,"tag":322,"props":614,"children":615},{"style":339},[616],{"type":40,"value":385},{"type":34,"tag":322,"props":618,"children":619},{"style":339},[620],{"type":40,"value":390},{"type":34,"tag":322,"props":622,"children":623},{"style":339},[624],{"type":40,"value":374},{"type":34,"tag":322,"props":626,"children":627},{"style":397},[628],{"type":40,"value":481},{"type":34,"tag":322,"props":630,"children":631},{"style":339},[632],{"type":40,"value":385},{"type":34,"tag":322,"props":634,"children":635},{"style":339},[636],{"type":40,"value":637},",",{"type":34,"tag":322,"props":639,"children":640},{"style":339},[641],{"type":40,"value":374},{"type":34,"tag":322,"props":643,"children":644},{"style":377},[645],{"type":40,"value":646},"file_path",{"type":34,"tag":322,"props":648,"children":649},{"style":339},[650],{"type":40,"value":385},{"type":34,"tag":322,"props":652,"children":653},{"style":339},[654],{"type":40,"value":390},{"type":34,"tag":322,"props":656,"children":657},{"style":339},[658],{"type":40,"value":374},{"type":34,"tag":322,"props":660,"children":661},{"style":397},[662],{"type":40,"value":663},"scripts\u002Fmandelbrot.py",{"type":34,"tag":322,"props":665,"children":666},{"style":339},[667],{"type":40,"value":385},{"type":34,"tag":322,"props":669,"children":670},{"style":339},[671],{"type":40,"value":409},{"type":34,"tag":43,"props":673,"children":674},{},[675],{"type":40,"value":676},"Only fetch files you actually need. If the body's decision tree points at one script, don't preload the others.",{"type":34,"tag":74,"props":678,"children":680},{"id":679},"creating-a-skill",[681],{"type":40,"value":682},"Creating a skill",{"type":34,"tag":43,"props":684,"children":685},{},[686,688,693],{"type":40,"value":687},"Follow the ",{"type":34,"tag":49,"props":689,"children":691},{"href":51,"rel":690},[53],[692],{"type":40,"value":56},{"type":40,"value":694}," when creating skills:",{"type":34,"tag":496,"props":696,"children":697},{},[698,713,727,748],{"type":34,"tag":500,"props":699,"children":700},{},[701,711],{"type":34,"tag":702,"props":703,"children":704},"strong",{},[705],{"type":34,"tag":60,"props":706,"children":708},{"className":707},[],[709],{"type":40,"value":710},"name",{"type":40,"value":712}," — kebab-case, max 64 chars, no leading\u002Ftrailing\u002Fconsecutive hyphens",{"type":34,"tag":500,"props":714,"children":715},{},[716,725],{"type":34,"tag":702,"props":717,"children":718},{},[719],{"type":34,"tag":60,"props":720,"children":722},{"className":721},[],[723],{"type":40,"value":724},"description",{"type":40,"value":726}," — explain what it does AND when to use it. Include keywords agents will search for. This is the only thing visible at discovery time — make it count.",{"type":34,"tag":500,"props":728,"children":729},{},[730,738,740,746],{"type":34,"tag":702,"props":731,"children":732},{},[733],{"type":34,"tag":60,"props":734,"children":736},{"className":735},[],[737],{"type":40,"value":508},{"type":40,"value":739}," — keep under ~500 lines. Move detailed reference material, SQL, scripts, and long examples into bundled ",{"type":34,"tag":60,"props":741,"children":743},{"className":742},[],[744],{"type":40,"value":745},"files",{"type":40,"value":747}," so the body stays scannable.",{"type":34,"tag":500,"props":749,"children":750},{},[751,756,758,764,766,772,774,780,782,788],{"type":34,"tag":702,"props":752,"children":753},{},[754],{"type":40,"value":755},"Files",{"type":40,"value":757}," — use ",{"type":34,"tag":60,"props":759,"children":761},{"className":760},[],[762],{"type":40,"value":763},"scripts\u002F",{"type":40,"value":765}," for executable code, ",{"type":34,"tag":60,"props":767,"children":769},{"className":768},[],[770],{"type":40,"value":771},"references\u002F",{"type":40,"value":773}," for docs, ",{"type":34,"tag":60,"props":775,"children":777},{"className":776},[],[778],{"type":40,"value":779},"assets\u002F",{"type":40,"value":781}," for templates\u002Fdata. Agents pull these on demand via ",{"type":34,"tag":60,"props":783,"children":785},{"className":784},[],[786],{"type":40,"value":787},"llma-skill-file-get",{"type":40,"value":789},", so splitting keeps context lean.",{"type":34,"tag":43,"props":791,"children":792},{},[793],{"type":40,"value":794},"Bundled files are optional and can be included in a single create call:",{"type":34,"tag":311,"props":796,"children":798},{"className":313,"code":797,"language":315,"meta":316,"style":316},"posthog:llma-skill-create\n{\n  \"name\": \"make-fractals\",\n  \"description\": \"Generate fractal images as PNGs. Use when the user asks to make, render, or visualize fractals.\",\n  \"body\": \"# make-fractals\\n\\nWhen to use... Workflow... Output contract...\",\n  \"license\": \"MIT\",\n  \"compatibility\": \"Requires Python 3.10+ with Pillow and numpy\",\n  \"allowed_tools\": [\"Bash\", \"Write\"],\n  \"metadata\": { \"author\": \"posthog\", \"category\": \"visualization\" },\n  \"files\": [\n    { \"path\": \"scripts\u002Fmandelbrot.py\", \"content\": \"...\", \"content_type\": \"text\u002Fx-python\" },\n    { \"path\": \"references\u002Fprimer.md\", \"content\": \"# Primer\\n...\", \"content_type\": \"text\u002Fmarkdown\" }\n  ]\n}\n",[799],{"type":34,"tag":60,"props":800,"children":801},{"__ignoreMap":316},[802,810,818,856,892,939,976,1013,1073,1167,1192,1302,1418,1427],{"type":34,"tag":322,"props":803,"children":804},{"class":324,"line":325},[805],{"type":34,"tag":322,"props":806,"children":807},{"style":329},[808],{"type":40,"value":809},"posthog:llma-skill-create\n",{"type":34,"tag":322,"props":811,"children":812},{"class":324,"line":335},[813],{"type":34,"tag":322,"props":814,"children":815},{"style":339},[816],{"type":40,"value":817},"{\n",{"type":34,"tag":322,"props":819,"children":821},{"class":324,"line":820},3,[822,827,831,835,839,843,847,851],{"type":34,"tag":322,"props":823,"children":824},{"style":339},[825],{"type":40,"value":826},"  \"",{"type":34,"tag":322,"props":828,"children":829},{"style":377},[830],{"type":40,"value":710},{"type":34,"tag":322,"props":832,"children":833},{"style":339},[834],{"type":40,"value":385},{"type":34,"tag":322,"props":836,"children":837},{"style":339},[838],{"type":40,"value":390},{"type":34,"tag":322,"props":840,"children":841},{"style":339},[842],{"type":40,"value":374},{"type":34,"tag":322,"props":844,"children":845},{"style":397},[846],{"type":40,"value":481},{"type":34,"tag":322,"props":848,"children":849},{"style":339},[850],{"type":40,"value":385},{"type":34,"tag":322,"props":852,"children":853},{"style":339},[854],{"type":40,"value":855},",\n",{"type":34,"tag":322,"props":857,"children":858},{"class":324,"line":21},[859,863,867,871,875,879,884,888],{"type":34,"tag":322,"props":860,"children":861},{"style":339},[862],{"type":40,"value":826},{"type":34,"tag":322,"props":864,"children":865},{"style":377},[866],{"type":40,"value":724},{"type":34,"tag":322,"props":868,"children":869},{"style":339},[870],{"type":40,"value":385},{"type":34,"tag":322,"props":872,"children":873},{"style":339},[874],{"type":40,"value":390},{"type":34,"tag":322,"props":876,"children":877},{"style":339},[878],{"type":40,"value":374},{"type":34,"tag":322,"props":880,"children":881},{"style":397},[882],{"type":40,"value":883},"Generate fractal images as PNGs. Use when the user asks to make, render, or visualize fractals.",{"type":34,"tag":322,"props":885,"children":886},{"style":339},[887],{"type":40,"value":385},{"type":34,"tag":322,"props":889,"children":890},{"style":339},[891],{"type":40,"value":855},{"type":34,"tag":322,"props":893,"children":895},{"class":324,"line":894},5,[896,900,904,908,912,916,921,926,931,935],{"type":34,"tag":322,"props":897,"children":898},{"style":339},[899],{"type":40,"value":826},{"type":34,"tag":322,"props":901,"children":902},{"style":377},[903],{"type":40,"value":508},{"type":34,"tag":322,"props":905,"children":906},{"style":339},[907],{"type":40,"value":385},{"type":34,"tag":322,"props":909,"children":910},{"style":339},[911],{"type":40,"value":390},{"type":34,"tag":322,"props":913,"children":914},{"style":339},[915],{"type":40,"value":374},{"type":34,"tag":322,"props":917,"children":918},{"style":397},[919],{"type":40,"value":920},"# make-fractals",{"type":34,"tag":322,"props":922,"children":923},{"style":329},[924],{"type":40,"value":925},"\\n\\n",{"type":34,"tag":322,"props":927,"children":928},{"style":397},[929],{"type":40,"value":930},"When to use... Workflow... Output contract...",{"type":34,"tag":322,"props":932,"children":933},{"style":339},[934],{"type":40,"value":385},{"type":34,"tag":322,"props":936,"children":937},{"style":339},[938],{"type":40,"value":855},{"type":34,"tag":322,"props":940,"children":942},{"class":324,"line":941},6,[943,947,951,955,959,963,968,972],{"type":34,"tag":322,"props":944,"children":945},{"style":339},[946],{"type":40,"value":826},{"type":34,"tag":322,"props":948,"children":949},{"style":377},[950],{"type":40,"value":519},{"type":34,"tag":322,"props":952,"children":953},{"style":339},[954],{"type":40,"value":385},{"type":34,"tag":322,"props":956,"children":957},{"style":339},[958],{"type":40,"value":390},{"type":34,"tag":322,"props":960,"children":961},{"style":339},[962],{"type":40,"value":374},{"type":34,"tag":322,"props":964,"children":965},{"style":397},[966],{"type":40,"value":967},"MIT",{"type":34,"tag":322,"props":969,"children":970},{"style":339},[971],{"type":40,"value":385},{"type":34,"tag":322,"props":973,"children":974},{"style":339},[975],{"type":40,"value":855},{"type":34,"tag":322,"props":977,"children":979},{"class":324,"line":978},7,[980,984,988,992,996,1000,1005,1009],{"type":34,"tag":322,"props":981,"children":982},{"style":339},[983],{"type":40,"value":826},{"type":34,"tag":322,"props":985,"children":986},{"style":377},[987],{"type":40,"value":527},{"type":34,"tag":322,"props":989,"children":990},{"style":339},[991],{"type":40,"value":385},{"type":34,"tag":322,"props":993,"children":994},{"style":339},[995],{"type":40,"value":390},{"type":34,"tag":322,"props":997,"children":998},{"style":339},[999],{"type":40,"value":374},{"type":34,"tag":322,"props":1001,"children":1002},{"style":397},[1003],{"type":40,"value":1004},"Requires Python 3.10+ with Pillow and numpy",{"type":34,"tag":322,"props":1006,"children":1007},{"style":339},[1008],{"type":40,"value":385},{"type":34,"tag":322,"props":1010,"children":1011},{"style":339},[1012],{"type":40,"value":855},{"type":34,"tag":322,"props":1014,"children":1016},{"class":324,"line":1015},8,[1017,1021,1025,1029,1033,1038,1042,1047,1051,1055,1059,1064,1068],{"type":34,"tag":322,"props":1018,"children":1019},{"style":339},[1020],{"type":40,"value":826},{"type":34,"tag":322,"props":1022,"children":1023},{"style":377},[1024],{"type":40,"value":65},{"type":34,"tag":322,"props":1026,"children":1027},{"style":339},[1028],{"type":40,"value":385},{"type":34,"tag":322,"props":1030,"children":1031},{"style":339},[1032],{"type":40,"value":390},{"type":34,"tag":322,"props":1034,"children":1035},{"style":339},[1036],{"type":40,"value":1037}," [",{"type":34,"tag":322,"props":1039,"children":1040},{"style":339},[1041],{"type":40,"value":385},{"type":34,"tag":322,"props":1043,"children":1044},{"style":397},[1045],{"type":40,"value":1046},"Bash",{"type":34,"tag":322,"props":1048,"children":1049},{"style":339},[1050],{"type":40,"value":385},{"type":34,"tag":322,"props":1052,"children":1053},{"style":339},[1054],{"type":40,"value":637},{"type":34,"tag":322,"props":1056,"children":1057},{"style":339},[1058],{"type":40,"value":374},{"type":34,"tag":322,"props":1060,"children":1061},{"style":397},[1062],{"type":40,"value":1063},"Write",{"type":34,"tag":322,"props":1065,"children":1066},{"style":339},[1067],{"type":40,"value":385},{"type":34,"tag":322,"props":1069,"children":1070},{"style":339},[1071],{"type":40,"value":1072},"],\n",{"type":34,"tag":322,"props":1074,"children":1076},{"class":324,"line":1075},9,[1077,1081,1085,1089,1093,1098,1102,1108,1112,1116,1120,1124,1128,1132,1136,1141,1145,1149,1153,1158,1162],{"type":34,"tag":322,"props":1078,"children":1079},{"style":339},[1080],{"type":40,"value":826},{"type":34,"tag":322,"props":1082,"children":1083},{"style":377},[1084],{"type":40,"value":540},{"type":34,"tag":322,"props":1086,"children":1087},{"style":339},[1088],{"type":40,"value":385},{"type":34,"tag":322,"props":1090,"children":1091},{"style":339},[1092],{"type":40,"value":390},{"type":34,"tag":322,"props":1094,"children":1095},{"style":339},[1096],{"type":40,"value":1097}," {",{"type":34,"tag":322,"props":1099,"children":1100},{"style":339},[1101],{"type":40,"value":374},{"type":34,"tag":322,"props":1103,"children":1105},{"style":1104},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[1106],{"type":40,"value":1107},"author",{"type":34,"tag":322,"props":1109,"children":1110},{"style":339},[1111],{"type":40,"value":385},{"type":34,"tag":322,"props":1113,"children":1114},{"style":339},[1115],{"type":40,"value":390},{"type":34,"tag":322,"props":1117,"children":1118},{"style":339},[1119],{"type":40,"value":374},{"type":34,"tag":322,"props":1121,"children":1122},{"style":397},[1123],{"type":40,"value":8},{"type":34,"tag":322,"props":1125,"children":1126},{"style":339},[1127],{"type":40,"value":385},{"type":34,"tag":322,"props":1129,"children":1130},{"style":339},[1131],{"type":40,"value":637},{"type":34,"tag":322,"props":1133,"children":1134},{"style":339},[1135],{"type":40,"value":374},{"type":34,"tag":322,"props":1137,"children":1138},{"style":1104},[1139],{"type":40,"value":1140},"category",{"type":34,"tag":322,"props":1142,"children":1143},{"style":339},[1144],{"type":40,"value":385},{"type":34,"tag":322,"props":1146,"children":1147},{"style":339},[1148],{"type":40,"value":390},{"type":34,"tag":322,"props":1150,"children":1151},{"style":339},[1152],{"type":40,"value":374},{"type":34,"tag":322,"props":1154,"children":1155},{"style":397},[1156],{"type":40,"value":1157},"visualization",{"type":34,"tag":322,"props":1159,"children":1160},{"style":339},[1161],{"type":40,"value":385},{"type":34,"tag":322,"props":1163,"children":1164},{"style":339},[1165],{"type":40,"value":1166}," },\n",{"type":34,"tag":322,"props":1168,"children":1170},{"class":324,"line":1169},10,[1171,1175,1179,1183,1187],{"type":34,"tag":322,"props":1172,"children":1173},{"style":339},[1174],{"type":40,"value":826},{"type":34,"tag":322,"props":1176,"children":1177},{"style":377},[1178],{"type":40,"value":745},{"type":34,"tag":322,"props":1180,"children":1181},{"style":339},[1182],{"type":40,"value":385},{"type":34,"tag":322,"props":1184,"children":1185},{"style":339},[1186],{"type":40,"value":390},{"type":34,"tag":322,"props":1188,"children":1189},{"style":339},[1190],{"type":40,"value":1191}," [\n",{"type":34,"tag":322,"props":1193,"children":1195},{"class":324,"line":1194},11,[1196,1201,1205,1210,1214,1218,1222,1226,1230,1234,1238,1243,1247,1251,1255,1260,1264,1268,1272,1277,1281,1285,1289,1294,1298],{"type":34,"tag":322,"props":1197,"children":1198},{"style":339},[1199],{"type":40,"value":1200},"    {",{"type":34,"tag":322,"props":1202,"children":1203},{"style":339},[1204],{"type":40,"value":374},{"type":34,"tag":322,"props":1206,"children":1207},{"style":1104},[1208],{"type":40,"value":1209},"path",{"type":34,"tag":322,"props":1211,"children":1212},{"style":339},[1213],{"type":40,"value":385},{"type":34,"tag":322,"props":1215,"children":1216},{"style":339},[1217],{"type":40,"value":390},{"type":34,"tag":322,"props":1219,"children":1220},{"style":339},[1221],{"type":40,"value":374},{"type":34,"tag":322,"props":1223,"children":1224},{"style":397},[1225],{"type":40,"value":663},{"type":34,"tag":322,"props":1227,"children":1228},{"style":339},[1229],{"type":40,"value":385},{"type":34,"tag":322,"props":1231,"children":1232},{"style":339},[1233],{"type":40,"value":637},{"type":34,"tag":322,"props":1235,"children":1236},{"style":339},[1237],{"type":40,"value":374},{"type":34,"tag":322,"props":1239,"children":1240},{"style":1104},[1241],{"type":40,"value":1242},"content",{"type":34,"tag":322,"props":1244,"children":1245},{"style":339},[1246],{"type":40,"value":385},{"type":34,"tag":322,"props":1248,"children":1249},{"style":339},[1250],{"type":40,"value":390},{"type":34,"tag":322,"props":1252,"children":1253},{"style":339},[1254],{"type":40,"value":374},{"type":34,"tag":322,"props":1256,"children":1257},{"style":397},[1258],{"type":40,"value":1259},"...",{"type":34,"tag":322,"props":1261,"children":1262},{"style":339},[1263],{"type":40,"value":385},{"type":34,"tag":322,"props":1265,"children":1266},{"style":339},[1267],{"type":40,"value":637},{"type":34,"tag":322,"props":1269,"children":1270},{"style":339},[1271],{"type":40,"value":374},{"type":34,"tag":322,"props":1273,"children":1274},{"style":1104},[1275],{"type":40,"value":1276},"content_type",{"type":34,"tag":322,"props":1278,"children":1279},{"style":339},[1280],{"type":40,"value":385},{"type":34,"tag":322,"props":1282,"children":1283},{"style":339},[1284],{"type":40,"value":390},{"type":34,"tag":322,"props":1286,"children":1287},{"style":339},[1288],{"type":40,"value":374},{"type":34,"tag":322,"props":1290,"children":1291},{"style":397},[1292],{"type":40,"value":1293},"text\u002Fx-python",{"type":34,"tag":322,"props":1295,"children":1296},{"style":339},[1297],{"type":40,"value":385},{"type":34,"tag":322,"props":1299,"children":1300},{"style":339},[1301],{"type":40,"value":1166},{"type":34,"tag":322,"props":1303,"children":1305},{"class":324,"line":1304},12,[1306,1310,1314,1318,1322,1326,1330,1335,1339,1343,1347,1351,1355,1359,1363,1368,1373,1377,1381,1385,1389,1393,1397,1401,1405,1410,1414],{"type":34,"tag":322,"props":1307,"children":1308},{"style":339},[1309],{"type":40,"value":1200},{"type":34,"tag":322,"props":1311,"children":1312},{"style":339},[1313],{"type":40,"value":374},{"type":34,"tag":322,"props":1315,"children":1316},{"style":1104},[1317],{"type":40,"value":1209},{"type":34,"tag":322,"props":1319,"children":1320},{"style":339},[1321],{"type":40,"value":385},{"type":34,"tag":322,"props":1323,"children":1324},{"style":339},[1325],{"type":40,"value":390},{"type":34,"tag":322,"props":1327,"children":1328},{"style":339},[1329],{"type":40,"value":374},{"type":34,"tag":322,"props":1331,"children":1332},{"style":397},[1333],{"type":40,"value":1334},"references\u002Fprimer.md",{"type":34,"tag":322,"props":1336,"children":1337},{"style":339},[1338],{"type":40,"value":385},{"type":34,"tag":322,"props":1340,"children":1341},{"style":339},[1342],{"type":40,"value":637},{"type":34,"tag":322,"props":1344,"children":1345},{"style":339},[1346],{"type":40,"value":374},{"type":34,"tag":322,"props":1348,"children":1349},{"style":1104},[1350],{"type":40,"value":1242},{"type":34,"tag":322,"props":1352,"children":1353},{"style":339},[1354],{"type":40,"value":385},{"type":34,"tag":322,"props":1356,"children":1357},{"style":339},[1358],{"type":40,"value":390},{"type":34,"tag":322,"props":1360,"children":1361},{"style":339},[1362],{"type":40,"value":374},{"type":34,"tag":322,"props":1364,"children":1365},{"style":397},[1366],{"type":40,"value":1367},"# Primer",{"type":34,"tag":322,"props":1369,"children":1370},{"style":329},[1371],{"type":40,"value":1372},"\\n",{"type":34,"tag":322,"props":1374,"children":1375},{"style":397},[1376],{"type":40,"value":1259},{"type":34,"tag":322,"props":1378,"children":1379},{"style":339},[1380],{"type":40,"value":385},{"type":34,"tag":322,"props":1382,"children":1383},{"style":339},[1384],{"type":40,"value":637},{"type":34,"tag":322,"props":1386,"children":1387},{"style":339},[1388],{"type":40,"value":374},{"type":34,"tag":322,"props":1390,"children":1391},{"style":1104},[1392],{"type":40,"value":1276},{"type":34,"tag":322,"props":1394,"children":1395},{"style":339},[1396],{"type":40,"value":385},{"type":34,"tag":322,"props":1398,"children":1399},{"style":339},[1400],{"type":40,"value":390},{"type":34,"tag":322,"props":1402,"children":1403},{"style":339},[1404],{"type":40,"value":374},{"type":34,"tag":322,"props":1406,"children":1407},{"style":397},[1408],{"type":40,"value":1409},"text\u002Fmarkdown",{"type":34,"tag":322,"props":1411,"children":1412},{"style":339},[1413],{"type":40,"value":385},{"type":34,"tag":322,"props":1415,"children":1416},{"style":339},[1417],{"type":40,"value":409},{"type":34,"tag":322,"props":1419,"children":1421},{"class":324,"line":1420},13,[1422],{"type":34,"tag":322,"props":1423,"children":1424},{"style":339},[1425],{"type":40,"value":1426},"  ]\n",{"type":34,"tag":322,"props":1428,"children":1430},{"class":324,"line":1429},14,[1431],{"type":34,"tag":322,"props":1432,"children":1433},{"style":339},[1434],{"type":40,"value":1435},"}\n",{"type":34,"tag":74,"props":1437,"children":1439},{"id":1438},"updating-a-skill",[1440],{"type":40,"value":1441},"Updating a skill",{"type":34,"tag":43,"props":1443,"children":1444},{},[1445,1447,1453],{"type":40,"value":1446},"Each write publishes a new immutable version. Always fetch first to get the current version, then update with ",{"type":34,"tag":60,"props":1448,"children":1450},{"className":1449},[],[1451],{"type":40,"value":1452},"base_version",{"type":40,"value":1454}," for concurrency checks:",{"type":34,"tag":311,"props":1456,"children":1457},{"className":313,"code":436,"language":315,"meta":316,"style":316},[1458],{"type":34,"tag":60,"props":1459,"children":1460},{"__ignoreMap":316},[1461,1468],{"type":34,"tag":322,"props":1462,"children":1463},{"class":324,"line":325},[1464],{"type":34,"tag":322,"props":1465,"children":1466},{"style":329},[1467],{"type":40,"value":448},{"type":34,"tag":322,"props":1469,"children":1470},{"class":324,"line":335},[1471,1475,1479,1483,1487,1491,1495,1499,1503],{"type":34,"tag":322,"props":1472,"children":1473},{"style":339},[1474],{"type":40,"value":369},{"type":34,"tag":322,"props":1476,"children":1477},{"style":339},[1478],{"type":40,"value":374},{"type":34,"tag":322,"props":1480,"children":1481},{"style":377},[1482],{"type":40,"value":464},{"type":34,"tag":322,"props":1484,"children":1485},{"style":339},[1486],{"type":40,"value":385},{"type":34,"tag":322,"props":1488,"children":1489},{"style":339},[1490],{"type":40,"value":390},{"type":34,"tag":322,"props":1492,"children":1493},{"style":339},[1494],{"type":40,"value":374},{"type":34,"tag":322,"props":1496,"children":1497},{"style":397},[1498],{"type":40,"value":481},{"type":34,"tag":322,"props":1500,"children":1501},{"style":339},[1502],{"type":40,"value":385},{"type":34,"tag":322,"props":1504,"children":1505},{"style":339},[1506],{"type":40,"value":409},{"type":34,"tag":43,"props":1508,"children":1509},{},[1510],{"type":40,"value":1511},"Pick the most surgical primitive for what you're changing — the API offers several so you don't have to round-trip the whole skill to tweak one part. Anything you don't touch is carried forward from the current latest.",{"type":34,"tag":428,"props":1513,"children":1515},{"id":1514},"editing-the-body",[1516],{"type":40,"value":1517},"Editing the body",{"type":34,"tag":43,"props":1519,"children":1520},{},[1521],{"type":40,"value":1522},"Full replacement (good for substantial rewrites):",{"type":34,"tag":311,"props":1524,"children":1526},{"className":313,"code":1525,"language":315,"meta":316,"style":316},"posthog:llma-skill-update\n{\n  \"skill_name\": \"make-fractals\",\n  \"body\": \"# make-fractals\\n\\nUpdated instructions...\",\n  \"base_version\": 2\n}\n",[1527],{"type":34,"tag":60,"props":1528,"children":1529},{"__ignoreMap":316},[1530,1538,1545,1580,1624,1649],{"type":34,"tag":322,"props":1531,"children":1532},{"class":324,"line":325},[1533],{"type":34,"tag":322,"props":1534,"children":1535},{"style":329},[1536],{"type":40,"value":1537},"posthog:llma-skill-update\n",{"type":34,"tag":322,"props":1539,"children":1540},{"class":324,"line":335},[1541],{"type":34,"tag":322,"props":1542,"children":1543},{"style":339},[1544],{"type":40,"value":817},{"type":34,"tag":322,"props":1546,"children":1547},{"class":324,"line":820},[1548,1552,1556,1560,1564,1568,1572,1576],{"type":34,"tag":322,"props":1549,"children":1550},{"style":339},[1551],{"type":40,"value":826},{"type":34,"tag":322,"props":1553,"children":1554},{"style":377},[1555],{"type":40,"value":464},{"type":34,"tag":322,"props":1557,"children":1558},{"style":339},[1559],{"type":40,"value":385},{"type":34,"tag":322,"props":1561,"children":1562},{"style":339},[1563],{"type":40,"value":390},{"type":34,"tag":322,"props":1565,"children":1566},{"style":339},[1567],{"type":40,"value":374},{"type":34,"tag":322,"props":1569,"children":1570},{"style":397},[1571],{"type":40,"value":481},{"type":34,"tag":322,"props":1573,"children":1574},{"style":339},[1575],{"type":40,"value":385},{"type":34,"tag":322,"props":1577,"children":1578},{"style":339},[1579],{"type":40,"value":855},{"type":34,"tag":322,"props":1581,"children":1582},{"class":324,"line":21},[1583,1587,1591,1595,1599,1603,1607,1611,1616,1620],{"type":34,"tag":322,"props":1584,"children":1585},{"style":339},[1586],{"type":40,"value":826},{"type":34,"tag":322,"props":1588,"children":1589},{"style":377},[1590],{"type":40,"value":508},{"type":34,"tag":322,"props":1592,"children":1593},{"style":339},[1594],{"type":40,"value":385},{"type":34,"tag":322,"props":1596,"children":1597},{"style":339},[1598],{"type":40,"value":390},{"type":34,"tag":322,"props":1600,"children":1601},{"style":339},[1602],{"type":40,"value":374},{"type":34,"tag":322,"props":1604,"children":1605},{"style":397},[1606],{"type":40,"value":920},{"type":34,"tag":322,"props":1608,"children":1609},{"style":329},[1610],{"type":40,"value":925},{"type":34,"tag":322,"props":1612,"children":1613},{"style":397},[1614],{"type":40,"value":1615},"Updated instructions...",{"type":34,"tag":322,"props":1617,"children":1618},{"style":339},[1619],{"type":40,"value":385},{"type":34,"tag":322,"props":1621,"children":1622},{"style":339},[1623],{"type":40,"value":855},{"type":34,"tag":322,"props":1625,"children":1626},{"class":324,"line":894},[1627,1631,1635,1639,1643],{"type":34,"tag":322,"props":1628,"children":1629},{"style":339},[1630],{"type":40,"value":826},{"type":34,"tag":322,"props":1632,"children":1633},{"style":377},[1634],{"type":40,"value":1452},{"type":34,"tag":322,"props":1636,"children":1637},{"style":339},[1638],{"type":40,"value":385},{"type":34,"tag":322,"props":1640,"children":1641},{"style":339},[1642],{"type":40,"value":390},{"type":34,"tag":322,"props":1644,"children":1646},{"style":1645},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1647],{"type":40,"value":1648}," 2\n",{"type":34,"tag":322,"props":1650,"children":1651},{"class":324,"line":941},[1652],{"type":34,"tag":322,"props":1653,"children":1654},{"style":339},[1655],{"type":40,"value":1435},{"type":34,"tag":43,"props":1657,"children":1658},{},[1659],{"type":40,"value":1660},"Incremental find\u002Freplace (good for small tweaks — no round-tripping the whole body):",{"type":34,"tag":311,"props":1662,"children":1664},{"className":313,"code":1663,"language":315,"meta":316,"style":316},"posthog:llma-skill-update\n{\n  \"skill_name\": \"make-fractals\",\n  \"edits\": [\n    { \"old\": \"Use Pillow for rendering.\", \"new\": \"Use Pillow ≥10.0 for rendering.\" }\n  ],\n  \"base_version\": 2\n}\n",[1665],{"type":34,"tag":60,"props":1666,"children":1667},{"__ignoreMap":316},[1668,1675,1682,1717,1740,1815,1823,1846],{"type":34,"tag":322,"props":1669,"children":1670},{"class":324,"line":325},[1671],{"type":34,"tag":322,"props":1672,"children":1673},{"style":329},[1674],{"type":40,"value":1537},{"type":34,"tag":322,"props":1676,"children":1677},{"class":324,"line":335},[1678],{"type":34,"tag":322,"props":1679,"children":1680},{"style":339},[1681],{"type":40,"value":817},{"type":34,"tag":322,"props":1683,"children":1684},{"class":324,"line":820},[1685,1689,1693,1697,1701,1705,1709,1713],{"type":34,"tag":322,"props":1686,"children":1687},{"style":339},[1688],{"type":40,"value":826},{"type":34,"tag":322,"props":1690,"children":1691},{"style":377},[1692],{"type":40,"value":464},{"type":34,"tag":322,"props":1694,"children":1695},{"style":339},[1696],{"type":40,"value":385},{"type":34,"tag":322,"props":1698,"children":1699},{"style":339},[1700],{"type":40,"value":390},{"type":34,"tag":322,"props":1702,"children":1703},{"style":339},[1704],{"type":40,"value":374},{"type":34,"tag":322,"props":1706,"children":1707},{"style":397},[1708],{"type":40,"value":481},{"type":34,"tag":322,"props":1710,"children":1711},{"style":339},[1712],{"type":40,"value":385},{"type":34,"tag":322,"props":1714,"children":1715},{"style":339},[1716],{"type":40,"value":855},{"type":34,"tag":322,"props":1718,"children":1719},{"class":324,"line":21},[1720,1724,1728,1732,1736],{"type":34,"tag":322,"props":1721,"children":1722},{"style":339},[1723],{"type":40,"value":826},{"type":34,"tag":322,"props":1725,"children":1726},{"style":377},[1727],{"type":40,"value":198},{"type":34,"tag":322,"props":1729,"children":1730},{"style":339},[1731],{"type":40,"value":385},{"type":34,"tag":322,"props":1733,"children":1734},{"style":339},[1735],{"type":40,"value":390},{"type":34,"tag":322,"props":1737,"children":1738},{"style":339},[1739],{"type":40,"value":1191},{"type":34,"tag":322,"props":1741,"children":1742},{"class":324,"line":894},[1743,1747,1751,1756,1760,1764,1768,1773,1777,1781,1785,1790,1794,1798,1802,1807,1811],{"type":34,"tag":322,"props":1744,"children":1745},{"style":339},[1746],{"type":40,"value":1200},{"type":34,"tag":322,"props":1748,"children":1749},{"style":339},[1750],{"type":40,"value":374},{"type":34,"tag":322,"props":1752,"children":1753},{"style":1104},[1754],{"type":40,"value":1755},"old",{"type":34,"tag":322,"props":1757,"children":1758},{"style":339},[1759],{"type":40,"value":385},{"type":34,"tag":322,"props":1761,"children":1762},{"style":339},[1763],{"type":40,"value":390},{"type":34,"tag":322,"props":1765,"children":1766},{"style":339},[1767],{"type":40,"value":374},{"type":34,"tag":322,"props":1769,"children":1770},{"style":397},[1771],{"type":40,"value":1772},"Use Pillow for rendering.",{"type":34,"tag":322,"props":1774,"children":1775},{"style":339},[1776],{"type":40,"value":385},{"type":34,"tag":322,"props":1778,"children":1779},{"style":339},[1780],{"type":40,"value":637},{"type":34,"tag":322,"props":1782,"children":1783},{"style":339},[1784],{"type":40,"value":374},{"type":34,"tag":322,"props":1786,"children":1787},{"style":1104},[1788],{"type":40,"value":1789},"new",{"type":34,"tag":322,"props":1791,"children":1792},{"style":339},[1793],{"type":40,"value":385},{"type":34,"tag":322,"props":1795,"children":1796},{"style":339},[1797],{"type":40,"value":390},{"type":34,"tag":322,"props":1799,"children":1800},{"style":339},[1801],{"type":40,"value":374},{"type":34,"tag":322,"props":1803,"children":1804},{"style":397},[1805],{"type":40,"value":1806},"Use Pillow ≥10.0 for rendering.",{"type":34,"tag":322,"props":1808,"children":1809},{"style":339},[1810],{"type":40,"value":385},{"type":34,"tag":322,"props":1812,"children":1813},{"style":339},[1814],{"type":40,"value":409},{"type":34,"tag":322,"props":1816,"children":1817},{"class":324,"line":941},[1818],{"type":34,"tag":322,"props":1819,"children":1820},{"style":339},[1821],{"type":40,"value":1822},"  ],\n",{"type":34,"tag":322,"props":1824,"children":1825},{"class":324,"line":978},[1826,1830,1834,1838,1842],{"type":34,"tag":322,"props":1827,"children":1828},{"style":339},[1829],{"type":40,"value":826},{"type":34,"tag":322,"props":1831,"children":1832},{"style":377},[1833],{"type":40,"value":1452},{"type":34,"tag":322,"props":1835,"children":1836},{"style":339},[1837],{"type":40,"value":385},{"type":34,"tag":322,"props":1839,"children":1840},{"style":339},[1841],{"type":40,"value":390},{"type":34,"tag":322,"props":1843,"children":1844},{"style":1645},[1845],{"type":40,"value":1648},{"type":34,"tag":322,"props":1847,"children":1848},{"class":324,"line":1015},[1849],{"type":34,"tag":322,"props":1850,"children":1851},{"style":339},[1852],{"type":40,"value":1435},{"type":34,"tag":43,"props":1854,"children":1855},{},[1856,1858,1864,1866,1871,1873,1878],{"type":40,"value":1857},"Each ",{"type":34,"tag":60,"props":1859,"children":1861},{"className":1860},[],[1862],{"type":40,"value":1863},"edits[].old",{"type":40,"value":1865}," must match exactly once. ",{"type":34,"tag":60,"props":1867,"children":1869},{"className":1868},[],[1870],{"type":40,"value":508},{"type":40,"value":1872}," and ",{"type":34,"tag":60,"props":1874,"children":1876},{"className":1875},[],[1877],{"type":40,"value":198},{"type":40,"value":1879}," are mutually exclusive.",{"type":34,"tag":428,"props":1881,"children":1883},{"id":1882},"editing-one-bundled-file",[1884],{"type":40,"value":1885},"Editing one bundled file",{"type":34,"tag":43,"props":1887,"children":1888},{},[1889,1891,1896],{"type":40,"value":1890},"Use ",{"type":34,"tag":60,"props":1892,"children":1894},{"className":1893},[],[1895],{"type":40,"value":206},{"type":40,"value":1897}," to patch a single file without resending any other file:",{"type":34,"tag":311,"props":1899,"children":1901},{"className":313,"code":1900,"language":315,"meta":316,"style":316},"posthog:llma-skill-update\n{\n  \"skill_name\": \"make-fractals\",\n  \"file_edits\": [\n    {\n      \"path\": \"scripts\u002Fmandelbrot.py\",\n      \"edits\": [\n        { \"old\": \"ITERATIONS = 100\", \"new\": \"ITERATIONS = 250\" }\n      ]\n    }\n  ],\n  \"base_version\": 2\n}\n",[1902],{"type":34,"tag":60,"props":1903,"children":1904},{"__ignoreMap":316},[1905,1912,1919,1954,1977,1985,2021,2044,2118,2126,2134,2141,2164],{"type":34,"tag":322,"props":1906,"children":1907},{"class":324,"line":325},[1908],{"type":34,"tag":322,"props":1909,"children":1910},{"style":329},[1911],{"type":40,"value":1537},{"type":34,"tag":322,"props":1913,"children":1914},{"class":324,"line":335},[1915],{"type":34,"tag":322,"props":1916,"children":1917},{"style":339},[1918],{"type":40,"value":817},{"type":34,"tag":322,"props":1920,"children":1921},{"class":324,"line":820},[1922,1926,1930,1934,1938,1942,1946,1950],{"type":34,"tag":322,"props":1923,"children":1924},{"style":339},[1925],{"type":40,"value":826},{"type":34,"tag":322,"props":1927,"children":1928},{"style":377},[1929],{"type":40,"value":464},{"type":34,"tag":322,"props":1931,"children":1932},{"style":339},[1933],{"type":40,"value":385},{"type":34,"tag":322,"props":1935,"children":1936},{"style":339},[1937],{"type":40,"value":390},{"type":34,"tag":322,"props":1939,"children":1940},{"style":339},[1941],{"type":40,"value":374},{"type":34,"tag":322,"props":1943,"children":1944},{"style":397},[1945],{"type":40,"value":481},{"type":34,"tag":322,"props":1947,"children":1948},{"style":339},[1949],{"type":40,"value":385},{"type":34,"tag":322,"props":1951,"children":1952},{"style":339},[1953],{"type":40,"value":855},{"type":34,"tag":322,"props":1955,"children":1956},{"class":324,"line":21},[1957,1961,1965,1969,1973],{"type":34,"tag":322,"props":1958,"children":1959},{"style":339},[1960],{"type":40,"value":826},{"type":34,"tag":322,"props":1962,"children":1963},{"style":377},[1964],{"type":40,"value":206},{"type":34,"tag":322,"props":1966,"children":1967},{"style":339},[1968],{"type":40,"value":385},{"type":34,"tag":322,"props":1970,"children":1971},{"style":339},[1972],{"type":40,"value":390},{"type":34,"tag":322,"props":1974,"children":1975},{"style":339},[1976],{"type":40,"value":1191},{"type":34,"tag":322,"props":1978,"children":1979},{"class":324,"line":894},[1980],{"type":34,"tag":322,"props":1981,"children":1982},{"style":339},[1983],{"type":40,"value":1984},"    {\n",{"type":34,"tag":322,"props":1986,"children":1987},{"class":324,"line":941},[1988,1993,1997,2001,2005,2009,2013,2017],{"type":34,"tag":322,"props":1989,"children":1990},{"style":339},[1991],{"type":40,"value":1992},"      \"",{"type":34,"tag":322,"props":1994,"children":1995},{"style":1104},[1996],{"type":40,"value":1209},{"type":34,"tag":322,"props":1998,"children":1999},{"style":339},[2000],{"type":40,"value":385},{"type":34,"tag":322,"props":2002,"children":2003},{"style":339},[2004],{"type":40,"value":390},{"type":34,"tag":322,"props":2006,"children":2007},{"style":339},[2008],{"type":40,"value":374},{"type":34,"tag":322,"props":2010,"children":2011},{"style":397},[2012],{"type":40,"value":663},{"type":34,"tag":322,"props":2014,"children":2015},{"style":339},[2016],{"type":40,"value":385},{"type":34,"tag":322,"props":2018,"children":2019},{"style":339},[2020],{"type":40,"value":855},{"type":34,"tag":322,"props":2022,"children":2023},{"class":324,"line":978},[2024,2028,2032,2036,2040],{"type":34,"tag":322,"props":2025,"children":2026},{"style":339},[2027],{"type":40,"value":1992},{"type":34,"tag":322,"props":2029,"children":2030},{"style":1104},[2031],{"type":40,"value":198},{"type":34,"tag":322,"props":2033,"children":2034},{"style":339},[2035],{"type":40,"value":385},{"type":34,"tag":322,"props":2037,"children":2038},{"style":339},[2039],{"type":40,"value":390},{"type":34,"tag":322,"props":2041,"children":2042},{"style":339},[2043],{"type":40,"value":1191},{"type":34,"tag":322,"props":2045,"children":2046},{"class":324,"line":1015},[2047,2052,2056,2060,2064,2068,2072,2077,2081,2085,2089,2093,2097,2101,2105,2110,2114],{"type":34,"tag":322,"props":2048,"children":2049},{"style":339},[2050],{"type":40,"value":2051},"        {",{"type":34,"tag":322,"props":2053,"children":2054},{"style":339},[2055],{"type":40,"value":374},{"type":34,"tag":322,"props":2057,"children":2058},{"style":1645},[2059],{"type":40,"value":1755},{"type":34,"tag":322,"props":2061,"children":2062},{"style":339},[2063],{"type":40,"value":385},{"type":34,"tag":322,"props":2065,"children":2066},{"style":339},[2067],{"type":40,"value":390},{"type":34,"tag":322,"props":2069,"children":2070},{"style":339},[2071],{"type":40,"value":374},{"type":34,"tag":322,"props":2073,"children":2074},{"style":397},[2075],{"type":40,"value":2076},"ITERATIONS = 100",{"type":34,"tag":322,"props":2078,"children":2079},{"style":339},[2080],{"type":40,"value":385},{"type":34,"tag":322,"props":2082,"children":2083},{"style":339},[2084],{"type":40,"value":637},{"type":34,"tag":322,"props":2086,"children":2087},{"style":339},[2088],{"type":40,"value":374},{"type":34,"tag":322,"props":2090,"children":2091},{"style":1645},[2092],{"type":40,"value":1789},{"type":34,"tag":322,"props":2094,"children":2095},{"style":339},[2096],{"type":40,"value":385},{"type":34,"tag":322,"props":2098,"children":2099},{"style":339},[2100],{"type":40,"value":390},{"type":34,"tag":322,"props":2102,"children":2103},{"style":339},[2104],{"type":40,"value":374},{"type":34,"tag":322,"props":2106,"children":2107},{"style":397},[2108],{"type":40,"value":2109},"ITERATIONS = 250",{"type":34,"tag":322,"props":2111,"children":2112},{"style":339},[2113],{"type":40,"value":385},{"type":34,"tag":322,"props":2115,"children":2116},{"style":339},[2117],{"type":40,"value":409},{"type":34,"tag":322,"props":2119,"children":2120},{"class":324,"line":1075},[2121],{"type":34,"tag":322,"props":2122,"children":2123},{"style":339},[2124],{"type":40,"value":2125},"      ]\n",{"type":34,"tag":322,"props":2127,"children":2128},{"class":324,"line":1169},[2129],{"type":34,"tag":322,"props":2130,"children":2131},{"style":339},[2132],{"type":40,"value":2133},"    }\n",{"type":34,"tag":322,"props":2135,"children":2136},{"class":324,"line":1194},[2137],{"type":34,"tag":322,"props":2138,"children":2139},{"style":339},[2140],{"type":40,"value":1822},{"type":34,"tag":322,"props":2142,"children":2143},{"class":324,"line":1304},[2144,2148,2152,2156,2160],{"type":34,"tag":322,"props":2145,"children":2146},{"style":339},[2147],{"type":40,"value":826},{"type":34,"tag":322,"props":2149,"children":2150},{"style":377},[2151],{"type":40,"value":1452},{"type":34,"tag":322,"props":2153,"children":2154},{"style":339},[2155],{"type":40,"value":385},{"type":34,"tag":322,"props":2157,"children":2158},{"style":339},[2159],{"type":40,"value":390},{"type":34,"tag":322,"props":2161,"children":2162},{"style":1645},[2163],{"type":40,"value":1648},{"type":34,"tag":322,"props":2165,"children":2166},{"class":324,"line":1420},[2167],{"type":34,"tag":322,"props":2168,"children":2169},{"style":339},[2170],{"type":40,"value":1435},{"type":34,"tag":43,"props":2172,"children":2173},{},[2174,2176,2181],{"type":40,"value":2175},"Non-targeted files carry forward unchanged. ",{"type":34,"tag":60,"props":2177,"children":2179},{"className":2178},[],[2180],{"type":40,"value":206},{"type":40,"value":2182}," cannot add, remove, or rename files — use the per-file tools below for that.",{"type":34,"tag":428,"props":2184,"children":2186},{"id":2185},"file-path-parameter-naming",[2187],{"type":40,"value":2188},"File-path parameter naming",{"type":34,"tag":43,"props":2190,"children":2191},{},[2192],{"type":40,"value":2193},"The file-path parameter has two names depending on where it sits in the request, so don't guess:",{"type":34,"tag":496,"props":2195,"children":2196},{},[2197,2224,2260],{"type":34,"tag":500,"props":2198,"children":2199},{},[2200,2208,2210,2215,2216,2222],{"type":34,"tag":702,"props":2201,"children":2202},{},[2203],{"type":34,"tag":60,"props":2204,"children":2206},{"className":2205},[],[2207],{"type":40,"value":646},{"type":40,"value":2209}," — ",{"type":34,"tag":60,"props":2211,"children":2213},{"className":2212},[],[2214],{"type":40,"value":787},{"type":40,"value":1872},{"type":34,"tag":60,"props":2217,"children":2219},{"className":2218},[],[2220],{"type":40,"value":2221},"llma-skill-file-delete",{"type":40,"value":2223}," (the path is part of the URL).",{"type":34,"tag":500,"props":2225,"children":2226},{},[2227,2235,2236,2242,2244,2250,2252,2258],{"type":34,"tag":702,"props":2228,"children":2229},{},[2230],{"type":34,"tag":60,"props":2231,"children":2233},{"className":2232},[],[2234],{"type":40,"value":1209},{"type":40,"value":2209},{"type":34,"tag":60,"props":2237,"children":2239},{"className":2238},[],[2240],{"type":40,"value":2241},"llma-skill-file-create",{"type":40,"value":2243},", plus the ",{"type":34,"tag":60,"props":2245,"children":2247},{"className":2246},[],[2248],{"type":40,"value":2249},"files=[{path, …}]",{"type":40,"value":2251}," array and ",{"type":34,"tag":60,"props":2253,"children":2255},{"className":2254},[],[2256],{"type":40,"value":2257},"file_edits=[{path, …}]",{"type":40,"value":2259}," (body fields on a file object).",{"type":34,"tag":500,"props":2261,"children":2262},{},[2263,2280,2281,2287],{"type":34,"tag":702,"props":2264,"children":2265},{},[2266,2272,2274],{"type":34,"tag":60,"props":2267,"children":2269},{"className":2268},[],[2270],{"type":40,"value":2271},"old_path",{"type":40,"value":2273}," \u002F ",{"type":34,"tag":60,"props":2275,"children":2277},{"className":2276},[],[2278],{"type":40,"value":2279},"new_path",{"type":40,"value":2209},{"type":34,"tag":60,"props":2282,"children":2284},{"className":2283},[],[2285],{"type":40,"value":2286},"llma-skill-file-rename",{"type":40,"value":2288},".",{"type":34,"tag":43,"props":2290,"children":2291},{},[2292,2294,2299,2301,2307],{"type":40,"value":2293},"Passing ",{"type":34,"tag":60,"props":2295,"children":2297},{"className":2296},[],[2298],{"type":40,"value":1209},{"type":40,"value":2300}," to file-get produces a ",{"type":34,"tag":60,"props":2302,"children":2304},{"className":2303},[],[2305],{"type":40,"value":2306},"\u002Ffiles\u002Fundefined\u002F",{"type":40,"value":2308}," 404. When in doubt, check the tool's input schema.",{"type":34,"tag":428,"props":2310,"children":2312},{"id":2311},"adding-removing-or-renaming-a-file",[2313],{"type":40,"value":2314},"Adding, removing, or renaming a file",{"type":34,"tag":43,"props":2316,"children":2317},{},[2318,2320,2326,2328,2333],{"type":40,"value":2319},"Atomic per-file tools — each publishes a new version and returns the updated skill (read its ",{"type":34,"tag":60,"props":2321,"children":2323},{"className":2322},[],[2324],{"type":40,"value":2325},"version",{"type":40,"value":2327}," to chain further edits via ",{"type":34,"tag":60,"props":2329,"children":2331},{"className":2330},[],[2332],{"type":40,"value":1452},{"type":40,"value":2334},"):",{"type":34,"tag":311,"props":2336,"children":2338},{"className":313,"code":2337,"language":315,"meta":316,"style":316},"posthog:llma-skill-file-create\n{ \"skill_name\": \"make-fractals\", \"path\": \"scripts\u002Fjulia.py\", \"content\": \"...\", \"base_version\": 2 }\n",[2339],{"type":34,"tag":60,"props":2340,"children":2341},{"__ignoreMap":316},[2342,2350],{"type":34,"tag":322,"props":2343,"children":2344},{"class":324,"line":325},[2345],{"type":34,"tag":322,"props":2346,"children":2347},{"style":329},[2348],{"type":40,"value":2349},"posthog:llma-skill-file-create\n",{"type":34,"tag":322,"props":2351,"children":2352},{"class":324,"line":335},[2353,2357,2361,2365,2369,2373,2377,2381,2385,2389,2393,2397,2401,2405,2409,2414,2418,2422,2426,2430,2434,2438,2442,2446,2450,2454,2458,2462,2466,2470,2475],{"type":34,"tag":322,"props":2354,"children":2355},{"style":339},[2356],{"type":40,"value":369},{"type":34,"tag":322,"props":2358,"children":2359},{"style":339},[2360],{"type":40,"value":374},{"type":34,"tag":322,"props":2362,"children":2363},{"style":377},[2364],{"type":40,"value":464},{"type":34,"tag":322,"props":2366,"children":2367},{"style":339},[2368],{"type":40,"value":385},{"type":34,"tag":322,"props":2370,"children":2371},{"style":339},[2372],{"type":40,"value":390},{"type":34,"tag":322,"props":2374,"children":2375},{"style":339},[2376],{"type":40,"value":374},{"type":34,"tag":322,"props":2378,"children":2379},{"style":397},[2380],{"type":40,"value":481},{"type":34,"tag":322,"props":2382,"children":2383},{"style":339},[2384],{"type":40,"value":385},{"type":34,"tag":322,"props":2386,"children":2387},{"style":339},[2388],{"type":40,"value":637},{"type":34,"tag":322,"props":2390,"children":2391},{"style":339},[2392],{"type":40,"value":374},{"type":34,"tag":322,"props":2394,"children":2395},{"style":377},[2396],{"type":40,"value":1209},{"type":34,"tag":322,"props":2398,"children":2399},{"style":339},[2400],{"type":40,"value":385},{"type":34,"tag":322,"props":2402,"children":2403},{"style":339},[2404],{"type":40,"value":390},{"type":34,"tag":322,"props":2406,"children":2407},{"style":339},[2408],{"type":40,"value":374},{"type":34,"tag":322,"props":2410,"children":2411},{"style":397},[2412],{"type":40,"value":2413},"scripts\u002Fjulia.py",{"type":34,"tag":322,"props":2415,"children":2416},{"style":339},[2417],{"type":40,"value":385},{"type":34,"tag":322,"props":2419,"children":2420},{"style":339},[2421],{"type":40,"value":637},{"type":34,"tag":322,"props":2423,"children":2424},{"style":339},[2425],{"type":40,"value":374},{"type":34,"tag":322,"props":2427,"children":2428},{"style":377},[2429],{"type":40,"value":1242},{"type":34,"tag":322,"props":2431,"children":2432},{"style":339},[2433],{"type":40,"value":385},{"type":34,"tag":322,"props":2435,"children":2436},{"style":339},[2437],{"type":40,"value":390},{"type":34,"tag":322,"props":2439,"children":2440},{"style":339},[2441],{"type":40,"value":374},{"type":34,"tag":322,"props":2443,"children":2444},{"style":397},[2445],{"type":40,"value":1259},{"type":34,"tag":322,"props":2447,"children":2448},{"style":339},[2449],{"type":40,"value":385},{"type":34,"tag":322,"props":2451,"children":2452},{"style":339},[2453],{"type":40,"value":637},{"type":34,"tag":322,"props":2455,"children":2456},{"style":339},[2457],{"type":40,"value":374},{"type":34,"tag":322,"props":2459,"children":2460},{"style":377},[2461],{"type":40,"value":1452},{"type":34,"tag":322,"props":2463,"children":2464},{"style":339},[2465],{"type":40,"value":385},{"type":34,"tag":322,"props":2467,"children":2468},{"style":339},[2469],{"type":40,"value":390},{"type":34,"tag":322,"props":2471,"children":2472},{"style":1645},[2473],{"type":40,"value":2474}," 2",{"type":34,"tag":322,"props":2476,"children":2477},{"style":339},[2478],{"type":40,"value":409},{"type":34,"tag":311,"props":2480,"children":2482},{"className":313,"code":2481,"language":315,"meta":316,"style":316},"posthog:llma-skill-file-delete\n{ \"skill_name\": \"make-fractals\", \"file_path\": \"scripts\u002Fold.py\", \"base_version\": 3 }\n",[2483],{"type":34,"tag":60,"props":2484,"children":2485},{"__ignoreMap":316},[2486,2494],{"type":34,"tag":322,"props":2487,"children":2488},{"class":324,"line":325},[2489],{"type":34,"tag":322,"props":2490,"children":2491},{"style":329},[2492],{"type":40,"value":2493},"posthog:llma-skill-file-delete\n",{"type":34,"tag":322,"props":2495,"children":2496},{"class":324,"line":335},[2497,2501,2505,2509,2513,2517,2521,2525,2529,2533,2537,2541,2545,2549,2553,2558,2562,2566,2570,2574,2578,2582,2587],{"type":34,"tag":322,"props":2498,"children":2499},{"style":339},[2500],{"type":40,"value":369},{"type":34,"tag":322,"props":2502,"children":2503},{"style":339},[2504],{"type":40,"value":374},{"type":34,"tag":322,"props":2506,"children":2507},{"style":377},[2508],{"type":40,"value":464},{"type":34,"tag":322,"props":2510,"children":2511},{"style":339},[2512],{"type":40,"value":385},{"type":34,"tag":322,"props":2514,"children":2515},{"style":339},[2516],{"type":40,"value":390},{"type":34,"tag":322,"props":2518,"children":2519},{"style":339},[2520],{"type":40,"value":374},{"type":34,"tag":322,"props":2522,"children":2523},{"style":397},[2524],{"type":40,"value":481},{"type":34,"tag":322,"props":2526,"children":2527},{"style":339},[2528],{"type":40,"value":385},{"type":34,"tag":322,"props":2530,"children":2531},{"style":339},[2532],{"type":40,"value":637},{"type":34,"tag":322,"props":2534,"children":2535},{"style":339},[2536],{"type":40,"value":374},{"type":34,"tag":322,"props":2538,"children":2539},{"style":377},[2540],{"type":40,"value":646},{"type":34,"tag":322,"props":2542,"children":2543},{"style":339},[2544],{"type":40,"value":385},{"type":34,"tag":322,"props":2546,"children":2547},{"style":339},[2548],{"type":40,"value":390},{"type":34,"tag":322,"props":2550,"children":2551},{"style":339},[2552],{"type":40,"value":374},{"type":34,"tag":322,"props":2554,"children":2555},{"style":397},[2556],{"type":40,"value":2557},"scripts\u002Fold.py",{"type":34,"tag":322,"props":2559,"children":2560},{"style":339},[2561],{"type":40,"value":385},{"type":34,"tag":322,"props":2563,"children":2564},{"style":339},[2565],{"type":40,"value":637},{"type":34,"tag":322,"props":2567,"children":2568},{"style":339},[2569],{"type":40,"value":374},{"type":34,"tag":322,"props":2571,"children":2572},{"style":377},[2573],{"type":40,"value":1452},{"type":34,"tag":322,"props":2575,"children":2576},{"style":339},[2577],{"type":40,"value":385},{"type":34,"tag":322,"props":2579,"children":2580},{"style":339},[2581],{"type":40,"value":390},{"type":34,"tag":322,"props":2583,"children":2584},{"style":1645},[2585],{"type":40,"value":2586}," 3",{"type":34,"tag":322,"props":2588,"children":2589},{"style":339},[2590],{"type":40,"value":409},{"type":34,"tag":311,"props":2592,"children":2594},{"className":313,"code":2593,"language":315,"meta":316,"style":316},"posthog:llma-skill-file-rename\n{ \"skill_name\": \"make-fractals\", \"old_path\": \"scripts\u002Fjulia.py\", \"new_path\": \"scripts\u002Fjulia_set.py\", \"base_version\": 4 }\n",[2595],{"type":34,"tag":60,"props":2596,"children":2597},{"__ignoreMap":316},[2598,2606],{"type":34,"tag":322,"props":2599,"children":2600},{"class":324,"line":325},[2601],{"type":34,"tag":322,"props":2602,"children":2603},{"style":329},[2604],{"type":40,"value":2605},"posthog:llma-skill-file-rename\n",{"type":34,"tag":322,"props":2607,"children":2608},{"class":324,"line":335},[2609,2613,2617,2621,2625,2629,2633,2637,2641,2645,2649,2653,2657,2661,2665,2669,2673,2677,2681,2685,2689,2693,2697,2702,2706,2710,2714,2718,2722,2726,2731],{"type":34,"tag":322,"props":2610,"children":2611},{"style":339},[2612],{"type":40,"value":369},{"type":34,"tag":322,"props":2614,"children":2615},{"style":339},[2616],{"type":40,"value":374},{"type":34,"tag":322,"props":2618,"children":2619},{"style":377},[2620],{"type":40,"value":464},{"type":34,"tag":322,"props":2622,"children":2623},{"style":339},[2624],{"type":40,"value":385},{"type":34,"tag":322,"props":2626,"children":2627},{"style":339},[2628],{"type":40,"value":390},{"type":34,"tag":322,"props":2630,"children":2631},{"style":339},[2632],{"type":40,"value":374},{"type":34,"tag":322,"props":2634,"children":2635},{"style":397},[2636],{"type":40,"value":481},{"type":34,"tag":322,"props":2638,"children":2639},{"style":339},[2640],{"type":40,"value":385},{"type":34,"tag":322,"props":2642,"children":2643},{"style":339},[2644],{"type":40,"value":637},{"type":34,"tag":322,"props":2646,"children":2647},{"style":339},[2648],{"type":40,"value":374},{"type":34,"tag":322,"props":2650,"children":2651},{"style":377},[2652],{"type":40,"value":2271},{"type":34,"tag":322,"props":2654,"children":2655},{"style":339},[2656],{"type":40,"value":385},{"type":34,"tag":322,"props":2658,"children":2659},{"style":339},[2660],{"type":40,"value":390},{"type":34,"tag":322,"props":2662,"children":2663},{"style":339},[2664],{"type":40,"value":374},{"type":34,"tag":322,"props":2666,"children":2667},{"style":397},[2668],{"type":40,"value":2413},{"type":34,"tag":322,"props":2670,"children":2671},{"style":339},[2672],{"type":40,"value":385},{"type":34,"tag":322,"props":2674,"children":2675},{"style":339},[2676],{"type":40,"value":637},{"type":34,"tag":322,"props":2678,"children":2679},{"style":339},[2680],{"type":40,"value":374},{"type":34,"tag":322,"props":2682,"children":2683},{"style":377},[2684],{"type":40,"value":2279},{"type":34,"tag":322,"props":2686,"children":2687},{"style":339},[2688],{"type":40,"value":385},{"type":34,"tag":322,"props":2690,"children":2691},{"style":339},[2692],{"type":40,"value":390},{"type":34,"tag":322,"props":2694,"children":2695},{"style":339},[2696],{"type":40,"value":374},{"type":34,"tag":322,"props":2698,"children":2699},{"style":397},[2700],{"type":40,"value":2701},"scripts\u002Fjulia_set.py",{"type":34,"tag":322,"props":2703,"children":2704},{"style":339},[2705],{"type":40,"value":385},{"type":34,"tag":322,"props":2707,"children":2708},{"style":339},[2709],{"type":40,"value":637},{"type":34,"tag":322,"props":2711,"children":2712},{"style":339},[2713],{"type":40,"value":374},{"type":34,"tag":322,"props":2715,"children":2716},{"style":377},[2717],{"type":40,"value":1452},{"type":34,"tag":322,"props":2719,"children":2720},{"style":339},[2721],{"type":40,"value":385},{"type":34,"tag":322,"props":2723,"children":2724},{"style":339},[2725],{"type":40,"value":390},{"type":34,"tag":322,"props":2727,"children":2728},{"style":1645},[2729],{"type":40,"value":2730}," 4",{"type":34,"tag":322,"props":2732,"children":2733},{"style":339},[2734],{"type":40,"value":409},{"type":34,"tag":428,"props":2736,"children":2738},{"id":2737},"replacing-the-whole-bundle-rare",[2739],{"type":40,"value":2740},"Replacing the whole bundle (rare)",{"type":34,"tag":43,"props":2742,"children":2743},{},[2744,2745,2750,2752,2758,2760,2765],{"type":40,"value":2293},{"type":34,"tag":60,"props":2746,"children":2748},{"className":2747},[],[2749],{"type":40,"value":745},{"type":40,"value":2751}," to ",{"type":34,"tag":60,"props":2753,"children":2755},{"className":2754},[],[2756],{"type":40,"value":2757},"llma-skill-update",{"type":40,"value":2759}," replaces ALL bundled files — anything not in the array is dropped. Only use this when you intentionally want to wipe and reseed the bundle. For everything else, prefer ",{"type":34,"tag":60,"props":2761,"children":2763},{"className":2762},[],[2764],{"type":40,"value":206},{"type":40,"value":2766}," or the per-file CRUD tools above.",{"type":34,"tag":74,"props":2768,"children":2770},{"id":2769},"archiving-a-skill",[2771],{"type":40,"value":2772},"Archiving a skill",{"type":34,"tag":43,"props":2774,"children":2775},{},[2776,2782,2784,2789,2790,2796,2798,2803],{"type":34,"tag":60,"props":2777,"children":2779},{"className":2778},[],[2780],{"type":40,"value":2781},"llma-skill-archive",{"type":40,"value":2783}," hides every active version of a skill by name. It cannot be undone — the skill disappears from ",{"type":34,"tag":60,"props":2785,"children":2787},{"className":2786},[],[2788],{"type":40,"value":418},{"type":40,"value":1872},{"type":34,"tag":60,"props":2791,"children":2793},{"className":2792},[],[2794],{"type":40,"value":2795},"llma-skill-get",{"type":40,"value":2797}," for the whole team. Use it to retire a skill entirely; to remove a single file use ",{"type":34,"tag":60,"props":2799,"children":2801},{"className":2800},[],[2802],{"type":40,"value":2221},{"type":40,"value":2804},", and to roll back content publish a new version instead.",{"type":34,"tag":311,"props":2806,"children":2808},{"className":313,"code":2807,"language":315,"meta":316,"style":316},"posthog:llma-skill-archive\n{ \"skill_name\": \"make-fractals\" }\n",[2809],{"type":34,"tag":60,"props":2810,"children":2811},{"__ignoreMap":316},[2812,2820],{"type":34,"tag":322,"props":2813,"children":2814},{"class":324,"line":325},[2815],{"type":34,"tag":322,"props":2816,"children":2817},{"style":329},[2818],{"type":40,"value":2819},"posthog:llma-skill-archive\n",{"type":34,"tag":322,"props":2821,"children":2822},{"class":324,"line":335},[2823,2827,2831,2835,2839,2843,2847,2851,2855],{"type":34,"tag":322,"props":2824,"children":2825},{"style":339},[2826],{"type":40,"value":369},{"type":34,"tag":322,"props":2828,"children":2829},{"style":339},[2830],{"type":40,"value":374},{"type":34,"tag":322,"props":2832,"children":2833},{"style":377},[2834],{"type":40,"value":464},{"type":34,"tag":322,"props":2836,"children":2837},{"style":339},[2838],{"type":40,"value":385},{"type":34,"tag":322,"props":2840,"children":2841},{"style":339},[2842],{"type":40,"value":390},{"type":34,"tag":322,"props":2844,"children":2845},{"style":339},[2846],{"type":40,"value":374},{"type":34,"tag":322,"props":2848,"children":2849},{"style":397},[2850],{"type":40,"value":481},{"type":34,"tag":322,"props":2852,"children":2853},{"style":339},[2854],{"type":40,"value":385},{"type":34,"tag":322,"props":2856,"children":2857},{"style":339},[2858],{"type":40,"value":409},{"type":34,"tag":74,"props":2860,"children":2862},{"id":2861},"porting-a-local-skill",[2863],{"type":40,"value":2864},"Porting a local skill",{"type":34,"tag":43,"props":2866,"children":2867},{},[2868,2870,2875,2876,2881,2882,2887],{"type":40,"value":2869},"To move a skill from a local SKILL.md directory (e.g. a local skills folder with ",{"type":34,"tag":60,"props":2871,"children":2873},{"className":2872},[],[2874],{"type":40,"value":763},{"type":40,"value":521},{"type":34,"tag":60,"props":2877,"children":2879},{"className":2878},[],[2880],{"type":40,"value":771},{"type":40,"value":521},{"type":34,"tag":60,"props":2883,"children":2885},{"className":2884},[],[2886],{"type":40,"value":779},{"type":40,"value":2888}," subdirs) into PostHog:",{"type":34,"tag":2890,"props":2891,"children":2892},"ol",{},[2893,2948,2979],{"type":34,"tag":500,"props":2894,"children":2895},{},[2896,2898,2904,2906,2911,2912,2917,2918,2923,2924,2929,2930,2935,2936,2941,2943],{"type":40,"value":2897},"Read the local ",{"type":34,"tag":60,"props":2899,"children":2901},{"className":2900},[],[2902],{"type":40,"value":2903},"SKILL.md",{"type":40,"value":2905}," — use its frontmatter for ",{"type":34,"tag":60,"props":2907,"children":2909},{"className":2908},[],[2910],{"type":40,"value":710},{"type":40,"value":521},{"type":34,"tag":60,"props":2913,"children":2915},{"className":2914},[],[2916],{"type":40,"value":724},{"type":40,"value":521},{"type":34,"tag":60,"props":2919,"children":2921},{"className":2920},[],[2922],{"type":40,"value":519},{"type":40,"value":521},{"type":34,"tag":60,"props":2925,"children":2927},{"className":2926},[],[2928],{"type":40,"value":527},{"type":40,"value":521},{"type":34,"tag":60,"props":2931,"children":2933},{"className":2932},[],[2934],{"type":40,"value":65},{"type":40,"value":521},{"type":34,"tag":60,"props":2937,"children":2939},{"className":2938},[],[2940],{"type":40,"value":540},{"type":40,"value":2942},"; the body after the frontmatter becomes ",{"type":34,"tag":60,"props":2944,"children":2946},{"className":2945},[],[2947],{"type":40,"value":508},{"type":34,"tag":500,"props":2949,"children":2950},{},[2951,2953,2958,2959,2964,2966,2971,2973],{"type":40,"value":2952},"Walk the ",{"type":34,"tag":60,"props":2954,"children":2956},{"className":2955},[],[2957],{"type":40,"value":763},{"type":40,"value":521},{"type":34,"tag":60,"props":2960,"children":2962},{"className":2961},[],[2963],{"type":40,"value":771},{"type":40,"value":2965},", and ",{"type":34,"tag":60,"props":2967,"children":2969},{"className":2968},[],[2970],{"type":40,"value":779},{"type":40,"value":2972}," subdirs and collect each file as ",{"type":34,"tag":60,"props":2974,"children":2976},{"className":2975},[],[2977],{"type":40,"value":2978},"{ path, content, content_type }",{"type":34,"tag":500,"props":2980,"children":2981},{},[2982,2984,2989],{"type":40,"value":2983},"Call ",{"type":34,"tag":60,"props":2985,"children":2987},{"className":2986},[],[2988],{"type":40,"value":170},{"type":40,"value":2990}," with everything in one shot — the skill lands at v1 with its full bundle",{"type":34,"tag":43,"props":2992,"children":2993},{},[2994,2996,3001],{"type":40,"value":2995},"The skill is then available to the whole team via ",{"type":34,"tag":60,"props":2997,"children":2999},{"className":2998},[],[3000],{"type":40,"value":136},{"type":40,"value":2288},{"type":34,"tag":74,"props":3003,"children":3005},{"id":3004},"quick-access-local-bridge-skill",[3006],{"type":40,"value":3007},"Quick access: local bridge skill",{"type":34,"tag":43,"props":3009,"children":3010},{},[3011,3013,3019],{"type":40,"value":3012},"Most coding agents support local skills or slash commands. A local bridge skill gives you a shortcut (e.g. ",{"type":34,"tag":60,"props":3014,"children":3016},{"className":3015},[],[3017],{"type":40,"value":3018},"\u002Fphs my-github",{"type":40,"value":3020},") that routes straight to the PostHog skills API — faster and more deterministic than asking the agent to \"use the PostHog skills store to load my-github\".",{"type":34,"tag":43,"props":3022,"children":3023},{},[3024],{"type":40,"value":3025},"Create a local skill in your agent's skills directory with these instructions:",{"type":34,"tag":311,"props":3027,"children":3031},{"className":3028,"code":3029,"language":3030,"meta":316,"style":316},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\nname: phs\ndescription: >-\n  Access and run shared team skills stored in PostHog.\n  Use when the user asks to list, run, or manage PostHog skills,\n  or references \u002Fphs, \"ph skills\", or \"posthog skills\".\nuser-invocable: true\nallowed-tools: mcp__posthog__llma-skill-list, mcp__posthog__llma-skill-get, mcp__posthog__llma-skill-create, mcp__posthog__llma-skill-update, mcp__posthog__llma-skill-file-get, mcp__posthog__llma-skill-file-create, mcp__posthog__llma-skill-file-delete, mcp__posthog__llma-skill-file-rename, mcp__posthog__llma-skill-duplicate\n---\n\n# PostHog Skills Store\n\nLocal bridge to the PostHog Skills Store.\n\n## Load and run a skill\n\nWhen the user says `\u002Fphs \u003Cskill-name>`:\n\n1. `llma-skill-get(skill_name=\"\u003Cskill-name>\")` to fetch body + file manifest\n2. Read the `body` field — follow it as system instructions for this task\n3. Use `llma-skill-file-get` to pull bundled scripts\u002Freferences on demand\n\n## List skills\n\nllma-skill-list # all skills\nllma-skill-list(search=\"llma\") # filter by keyword\n\n## Create \u002F update\n\nllma-skill-create(name=\"my-skill\", description=\"...\", body=\"# Instructions...\")\nllma-skill-get → note version → llma-skill-update(skill_name=\"...\", base_version=N, body=\"...\")\n\n## Edit one part of an existing skill\n\nllma-skill-get → note version → pick the smallest primitive:\n\n- body tweak: llma-skill-update(skill_name=\"...\", base_version=N, edits=[{old, new}])\n- one bundled file: llma-skill-update(skill_name=\"...\", base_version=N, file_edits=[{path, edits:[{old, new}]}])\n- add\u002Fremove\u002Frename a file: llma-skill-file-create \u002F llma-skill-file-delete \u002F llma-skill-file-rename\n","markdown",[3032],{"type":34,"tag":60,"props":3033,"children":3034},{"__ignoreMap":316},[3035,3043,3060,3082,3090,3098,3106,3124,3141,3148,3157,3170,3177,3185,3192,3206,3214,3242,3250,3278,3309,3340,3348,3361,3369,3378,3387,3395,3408,3416,3425,3434,3442,3455,3463,3472,3480,3494,3507],{"type":34,"tag":322,"props":3036,"children":3037},{"class":324,"line":325},[3038],{"type":34,"tag":322,"props":3039,"children":3040},{"style":339},[3041],{"type":40,"value":3042},"---\n",{"type":34,"tag":322,"props":3044,"children":3045},{"class":324,"line":335},[3046,3051,3055],{"type":34,"tag":322,"props":3047,"children":3049},{"style":3048},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[3050],{"type":40,"value":710},{"type":34,"tag":322,"props":3052,"children":3053},{"style":339},[3054],{"type":40,"value":390},{"type":34,"tag":322,"props":3056,"children":3057},{"style":397},[3058],{"type":40,"value":3059}," phs\n",{"type":34,"tag":322,"props":3061,"children":3062},{"class":324,"line":820},[3063,3067,3071,3077],{"type":34,"tag":322,"props":3064,"children":3065},{"style":3048},[3066],{"type":40,"value":724},{"type":34,"tag":322,"props":3068,"children":3069},{"style":339},[3070],{"type":40,"value":390},{"type":34,"tag":322,"props":3072,"children":3074},{"style":3073},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[3075],{"type":40,"value":3076}," >",{"type":34,"tag":322,"props":3078,"children":3079},{"style":377},[3080],{"type":40,"value":3081},"-\n",{"type":34,"tag":322,"props":3083,"children":3084},{"class":324,"line":21},[3085],{"type":34,"tag":322,"props":3086,"children":3087},{"style":397},[3088],{"type":40,"value":3089},"  Access and run shared team skills stored in PostHog.\n",{"type":34,"tag":322,"props":3091,"children":3092},{"class":324,"line":894},[3093],{"type":34,"tag":322,"props":3094,"children":3095},{"style":397},[3096],{"type":40,"value":3097},"  Use when the user asks to list, run, or manage PostHog skills,\n",{"type":34,"tag":322,"props":3099,"children":3100},{"class":324,"line":941},[3101],{"type":34,"tag":322,"props":3102,"children":3103},{"style":397},[3104],{"type":40,"value":3105},"  or references \u002Fphs, \"ph skills\", or \"posthog skills\".\n",{"type":34,"tag":322,"props":3107,"children":3108},{"class":324,"line":978},[3109,3114,3118],{"type":34,"tag":322,"props":3110,"children":3111},{"style":3048},[3112],{"type":40,"value":3113},"user-invocable",{"type":34,"tag":322,"props":3115,"children":3116},{"style":339},[3117],{"type":40,"value":390},{"type":34,"tag":322,"props":3119,"children":3121},{"style":3120},"--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC",[3122],{"type":40,"value":3123}," true\n",{"type":34,"tag":322,"props":3125,"children":3126},{"class":324,"line":1015},[3127,3132,3136],{"type":34,"tag":322,"props":3128,"children":3129},{"style":3048},[3130],{"type":40,"value":3131},"allowed-tools",{"type":34,"tag":322,"props":3133,"children":3134},{"style":339},[3135],{"type":40,"value":390},{"type":34,"tag":322,"props":3137,"children":3138},{"style":397},[3139],{"type":40,"value":3140}," mcp__posthog__llma-skill-list, mcp__posthog__llma-skill-get, mcp__posthog__llma-skill-create, mcp__posthog__llma-skill-update, mcp__posthog__llma-skill-file-get, mcp__posthog__llma-skill-file-create, mcp__posthog__llma-skill-file-delete, mcp__posthog__llma-skill-file-rename, mcp__posthog__llma-skill-duplicate\n",{"type":34,"tag":322,"props":3142,"children":3143},{"class":324,"line":1075},[3144],{"type":34,"tag":322,"props":3145,"children":3146},{"style":339},[3147],{"type":40,"value":3042},{"type":34,"tag":322,"props":3149,"children":3150},{"class":324,"line":1169},[3151],{"type":34,"tag":322,"props":3152,"children":3154},{"emptyLinePlaceholder":3153},true,[3155],{"type":40,"value":3156},"\n",{"type":34,"tag":322,"props":3158,"children":3159},{"class":324,"line":1194},[3160,3165],{"type":34,"tag":322,"props":3161,"children":3162},{"style":339},[3163],{"type":40,"value":3164},"# ",{"type":34,"tag":322,"props":3166,"children":3167},{"style":1104},[3168],{"type":40,"value":3169},"PostHog Skills Store\n",{"type":34,"tag":322,"props":3171,"children":3172},{"class":324,"line":1304},[3173],{"type":34,"tag":322,"props":3174,"children":3175},{"emptyLinePlaceholder":3153},[3176],{"type":40,"value":3156},{"type":34,"tag":322,"props":3178,"children":3179},{"class":324,"line":1420},[3180],{"type":34,"tag":322,"props":3181,"children":3182},{"style":329},[3183],{"type":40,"value":3184},"Local bridge to the PostHog Skills Store.\n",{"type":34,"tag":322,"props":3186,"children":3187},{"class":324,"line":1429},[3188],{"type":34,"tag":322,"props":3189,"children":3190},{"emptyLinePlaceholder":3153},[3191],{"type":40,"value":3156},{"type":34,"tag":322,"props":3193,"children":3195},{"class":324,"line":3194},15,[3196,3201],{"type":34,"tag":322,"props":3197,"children":3198},{"style":339},[3199],{"type":40,"value":3200},"## ",{"type":34,"tag":322,"props":3202,"children":3203},{"style":1104},[3204],{"type":40,"value":3205},"Load and run a skill\n",{"type":34,"tag":322,"props":3207,"children":3209},{"class":324,"line":3208},16,[3210],{"type":34,"tag":322,"props":3211,"children":3212},{"emptyLinePlaceholder":3153},[3213],{"type":40,"value":3156},{"type":34,"tag":322,"props":3215,"children":3217},{"class":324,"line":3216},17,[3218,3223,3228,3233,3237],{"type":34,"tag":322,"props":3219,"children":3220},{"style":329},[3221],{"type":40,"value":3222},"When the user says ",{"type":34,"tag":322,"props":3224,"children":3225},{"style":339},[3226],{"type":40,"value":3227},"`",{"type":34,"tag":322,"props":3229,"children":3230},{"style":397},[3231],{"type":40,"value":3232},"\u002Fphs \u003Cskill-name>",{"type":34,"tag":322,"props":3234,"children":3235},{"style":339},[3236],{"type":40,"value":3227},{"type":34,"tag":322,"props":3238,"children":3239},{"style":329},[3240],{"type":40,"value":3241},":\n",{"type":34,"tag":322,"props":3243,"children":3245},{"class":324,"line":3244},18,[3246],{"type":34,"tag":322,"props":3247,"children":3248},{"emptyLinePlaceholder":3153},[3249],{"type":40,"value":3156},{"type":34,"tag":322,"props":3251,"children":3253},{"class":324,"line":3252},19,[3254,3259,3264,3269,3273],{"type":34,"tag":322,"props":3255,"children":3256},{"style":339},[3257],{"type":40,"value":3258},"1.",{"type":34,"tag":322,"props":3260,"children":3261},{"style":339},[3262],{"type":40,"value":3263}," `",{"type":34,"tag":322,"props":3265,"children":3266},{"style":397},[3267],{"type":40,"value":3268},"llma-skill-get(skill_name=\"\u003Cskill-name>\")",{"type":34,"tag":322,"props":3270,"children":3271},{"style":339},[3272],{"type":40,"value":3227},{"type":34,"tag":322,"props":3274,"children":3275},{"style":329},[3276],{"type":40,"value":3277}," to fetch body + file manifest\n",{"type":34,"tag":322,"props":3279,"children":3281},{"class":324,"line":3280},20,[3282,3287,3292,3296,3300,3304],{"type":34,"tag":322,"props":3283,"children":3284},{"style":339},[3285],{"type":40,"value":3286},"2.",{"type":34,"tag":322,"props":3288,"children":3289},{"style":329},[3290],{"type":40,"value":3291}," Read the ",{"type":34,"tag":322,"props":3293,"children":3294},{"style":339},[3295],{"type":40,"value":3227},{"type":34,"tag":322,"props":3297,"children":3298},{"style":397},[3299],{"type":40,"value":508},{"type":34,"tag":322,"props":3301,"children":3302},{"style":339},[3303],{"type":40,"value":3227},{"type":34,"tag":322,"props":3305,"children":3306},{"style":329},[3307],{"type":40,"value":3308}," field — follow it as system instructions for this task\n",{"type":34,"tag":322,"props":3310,"children":3312},{"class":324,"line":3311},21,[3313,3318,3323,3327,3331,3335],{"type":34,"tag":322,"props":3314,"children":3315},{"style":339},[3316],{"type":40,"value":3317},"3.",{"type":34,"tag":322,"props":3319,"children":3320},{"style":329},[3321],{"type":40,"value":3322}," Use ",{"type":34,"tag":322,"props":3324,"children":3325},{"style":339},[3326],{"type":40,"value":3227},{"type":34,"tag":322,"props":3328,"children":3329},{"style":397},[3330],{"type":40,"value":787},{"type":34,"tag":322,"props":3332,"children":3333},{"style":339},[3334],{"type":40,"value":3227},{"type":34,"tag":322,"props":3336,"children":3337},{"style":329},[3338],{"type":40,"value":3339}," to pull bundled scripts\u002Freferences on demand\n",{"type":34,"tag":322,"props":3341,"children":3343},{"class":324,"line":3342},22,[3344],{"type":34,"tag":322,"props":3345,"children":3346},{"emptyLinePlaceholder":3153},[3347],{"type":40,"value":3156},{"type":34,"tag":322,"props":3349,"children":3351},{"class":324,"line":3350},23,[3352,3356],{"type":34,"tag":322,"props":3353,"children":3354},{"style":339},[3355],{"type":40,"value":3200},{"type":34,"tag":322,"props":3357,"children":3358},{"style":1104},[3359],{"type":40,"value":3360},"List skills\n",{"type":34,"tag":322,"props":3362,"children":3364},{"class":324,"line":3363},24,[3365],{"type":34,"tag":322,"props":3366,"children":3367},{"emptyLinePlaceholder":3153},[3368],{"type":40,"value":3156},{"type":34,"tag":322,"props":3370,"children":3372},{"class":324,"line":3371},25,[3373],{"type":34,"tag":322,"props":3374,"children":3375},{"style":329},[3376],{"type":40,"value":3377},"llma-skill-list # all skills\n",{"type":34,"tag":322,"props":3379,"children":3381},{"class":324,"line":3380},26,[3382],{"type":34,"tag":322,"props":3383,"children":3384},{"style":329},[3385],{"type":40,"value":3386},"llma-skill-list(search=\"llma\") # filter by keyword\n",{"type":34,"tag":322,"props":3388,"children":3390},{"class":324,"line":3389},27,[3391],{"type":34,"tag":322,"props":3392,"children":3393},{"emptyLinePlaceholder":3153},[3394],{"type":40,"value":3156},{"type":34,"tag":322,"props":3396,"children":3398},{"class":324,"line":3397},28,[3399,3403],{"type":34,"tag":322,"props":3400,"children":3401},{"style":339},[3402],{"type":40,"value":3200},{"type":34,"tag":322,"props":3404,"children":3405},{"style":1104},[3406],{"type":40,"value":3407},"Create \u002F update\n",{"type":34,"tag":322,"props":3409,"children":3411},{"class":324,"line":3410},29,[3412],{"type":34,"tag":322,"props":3413,"children":3414},{"emptyLinePlaceholder":3153},[3415],{"type":40,"value":3156},{"type":34,"tag":322,"props":3417,"children":3419},{"class":324,"line":3418},30,[3420],{"type":34,"tag":322,"props":3421,"children":3422},{"style":329},[3423],{"type":40,"value":3424},"llma-skill-create(name=\"my-skill\", description=\"...\", body=\"# Instructions...\")\n",{"type":34,"tag":322,"props":3426,"children":3428},{"class":324,"line":3427},31,[3429],{"type":34,"tag":322,"props":3430,"children":3431},{"style":329},[3432],{"type":40,"value":3433},"llma-skill-get → note version → llma-skill-update(skill_name=\"...\", base_version=N, body=\"...\")\n",{"type":34,"tag":322,"props":3435,"children":3437},{"class":324,"line":3436},32,[3438],{"type":34,"tag":322,"props":3439,"children":3440},{"emptyLinePlaceholder":3153},[3441],{"type":40,"value":3156},{"type":34,"tag":322,"props":3443,"children":3445},{"class":324,"line":3444},33,[3446,3450],{"type":34,"tag":322,"props":3447,"children":3448},{"style":339},[3449],{"type":40,"value":3200},{"type":34,"tag":322,"props":3451,"children":3452},{"style":1104},[3453],{"type":40,"value":3454},"Edit one part of an existing skill\n",{"type":34,"tag":322,"props":3456,"children":3458},{"class":324,"line":3457},34,[3459],{"type":34,"tag":322,"props":3460,"children":3461},{"emptyLinePlaceholder":3153},[3462],{"type":40,"value":3156},{"type":34,"tag":322,"props":3464,"children":3466},{"class":324,"line":3465},35,[3467],{"type":34,"tag":322,"props":3468,"children":3469},{"style":329},[3470],{"type":40,"value":3471},"llma-skill-get → note version → pick the smallest primitive:\n",{"type":34,"tag":322,"props":3473,"children":3475},{"class":324,"line":3474},36,[3476],{"type":34,"tag":322,"props":3477,"children":3478},{"emptyLinePlaceholder":3153},[3479],{"type":40,"value":3156},{"type":34,"tag":322,"props":3481,"children":3483},{"class":324,"line":3482},37,[3484,3489],{"type":34,"tag":322,"props":3485,"children":3486},{"style":339},[3487],{"type":40,"value":3488},"-",{"type":34,"tag":322,"props":3490,"children":3491},{"style":329},[3492],{"type":40,"value":3493}," body tweak: llma-skill-update(skill_name=\"...\", base_version=N, edits=[{old, new}])\n",{"type":34,"tag":322,"props":3495,"children":3497},{"class":324,"line":3496},38,[3498,3502],{"type":34,"tag":322,"props":3499,"children":3500},{"style":339},[3501],{"type":40,"value":3488},{"type":34,"tag":322,"props":3503,"children":3504},{"style":329},[3505],{"type":40,"value":3506}," one bundled file: llma-skill-update(skill_name=\"...\", base_version=N, file_edits=[{path, edits:[{old, new}]}])\n",{"type":34,"tag":322,"props":3508,"children":3510},{"class":324,"line":3509},39,[3511,3515],{"type":34,"tag":322,"props":3512,"children":3513},{"style":339},[3514],{"type":40,"value":3488},{"type":34,"tag":322,"props":3516,"children":3517},{"style":329},[3518],{"type":40,"value":3519}," add\u002Fremove\u002Frename a file: llma-skill-file-create \u002F llma-skill-file-delete \u002F llma-skill-file-rename\n",{"type":34,"tag":43,"props":3521,"children":3522},{},[3523],{"type":40,"value":3524},"The bridge is intentionally minimal — it just routes to the MCP tools. The real instructions live in PostHog and update without touching local files.",{"type":34,"tag":3526,"props":3527,"children":3528},"blockquote",{},[3529],{"type":34,"tag":43,"props":3530,"children":3531},{},[3532,3537,3539,3545],{"type":34,"tag":702,"props":3533,"children":3534},{},[3535],{"type":40,"value":3536},"Agent-specific setup:",{"type":40,"value":3538}," Where to save this depends on your agent. For Claude Code, save as ",{"type":34,"tag":60,"props":3540,"children":3542},{"className":3541},[],[3543],{"type":40,"value":3544},"~\u002F.claude\u002Fskills\u002Fphs\u002FSKILL.md",{"type":40,"value":3546},". For other agents, consult your agent's docs on local skill or slash command configuration.",{"type":34,"tag":74,"props":3548,"children":3550},{"id":3549},"default-behavior",[3551],{"type":40,"value":3552},"Default behavior",{"type":34,"tag":496,"props":3554,"children":3555},{},[3556,3566,3571,3576,3588],{"type":34,"tag":500,"props":3557,"children":3558},{},[3559,3564],{"type":34,"tag":702,"props":3560,"children":3561},{},[3562],{"type":40,"value":3563},"Always prefer PostHog MCP",{"type":40,"value":3565}," for skill storage and retrieval",{"type":34,"tag":500,"props":3567,"children":3568},{},[3569],{"type":40,"value":3570},"Only fall back to local files when PostHog MCP is unavailable",{"type":34,"tag":500,"props":3572,"children":3573},{},[3574],{"type":40,"value":3575},"When asked to \"save\", \"store\", or \"remember\" a workflow, runbook, or multi-step procedure, store it as a PostHog skill",{"type":34,"tag":500,"props":3577,"children":3578},{},[3579,3581,3586],{"type":40,"value":3580},"When asked to use a skill by name, use ",{"type":34,"tag":60,"props":3582,"children":3584},{"className":3583},[],[3585],{"type":40,"value":2795},{"type":40,"value":3587}," first",{"type":34,"tag":500,"props":3589,"children":3590},{},[3591,3593,3598],{"type":40,"value":3592},"When a skill references bundled files in its body, pull them with ",{"type":34,"tag":60,"props":3594,"children":3596},{"className":3595},[],[3597],{"type":40,"value":787},{"type":40,"value":3599}," only when needed — don't preload",{"type":34,"tag":3601,"props":3602,"children":3603},"style",{},[3604],{"type":40,"value":3605},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3607,"total":3780},[3608,3627,3639,3652,3665,3680,3696,3713,3727,3742,3752,3770],{"slug":3609,"name":3609,"fn":3610,"description":3611,"org":3612,"tags":3613,"stars":3624,"repoUrl":3625,"updatedAt":3626},"analyzing-expensive-users","analyze expensive users in AI observability","Analyze the most expensive users in AI observability and explain why they cost so much. Use when the user asks about top spenders, expensive users, per-user LLM cost, user-level cost drivers, or patterns behind high AI observability spend.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3614,3617,3620,3623],{"name":3615,"slug":3616,"type":13},"Analytics","analytics",{"name":3618,"slug":3619,"type":13},"Cost Optimization","cost-optimization",{"name":3621,"slug":3622,"type":13},"Observability","observability",{"name":9,"slug":8,"type":13},35568,"https:\u002F\u002Fgithub.com\u002FPostHog\u002Fposthog","2026-07-28T05:34:11.117757",{"slug":3628,"name":3628,"fn":3629,"description":3630,"org":3631,"tags":3632,"stars":3624,"repoUrl":3625,"updatedAt":3638},"auditing-endpoints","audit PostHog project endpoints","Audit every endpoint in a PostHog project for staleness, failed materialisations, and unused materialised versions. Use when the user asks \"what endpoints can I clean up?\", \"are any of my endpoints broken?\", \"which materialised versions are still being called?\", or wants a one-shot cleanup pass over the Endpoints product. Produces a prioritised report grouped by issue type, with recommended actions but does not modify anything without explicit confirmation.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3633,3634,3637],{"name":3615,"slug":3616,"type":13},{"name":3635,"slug":3636,"type":13},"Audit","audit",{"name":9,"slug":8,"type":13},"2026-06-08T08:08:33.693989",{"slug":3640,"name":3640,"fn":3641,"description":3642,"org":3643,"tags":3644,"stars":3624,"repoUrl":3625,"updatedAt":3651},"auditing-warehouse-source-health","audit PostHog data warehouse source health","Audit the health of a PostHog project's data warehouse sources and syncs — find every broken or degraded source connection, sync schema, and webhook channel. Use when the user asks \"why are my imports failing?\", \"what's broken with my sources?\", \"why is my warehouse data stale?\", or wants a one-shot triage of source\u002Fsync health before deciding where to dig in. Produces a prioritized report grouped by severity, with recommended next steps. For materialized-view health use `auditing-warehouse-view-health`; for a single failing sync use `diagnosing-failed-warehouse-syncs`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3645,3646,3649,3650],{"name":3635,"slug":3636,"type":13},{"name":3647,"slug":3648,"type":13},"Data Warehouse","data-warehouse",{"name":3621,"slug":3622,"type":13},{"name":9,"slug":8,"type":13},"2026-06-18T08:22:57.67984",{"slug":3653,"name":3653,"fn":3654,"description":3655,"org":3656,"tags":3657,"stars":3624,"repoUrl":3625,"updatedAt":3664},"auditing-warehouse-view-health","audit PostHog materialized view health","Audit the health of a PostHog project's materialized views (saved queries) — find every failed materialization and flag unused or stale materialized views that cost storage and compute. Use when the user asks \"which of my views are broken?\", \"why is this materialized view failing?\", \"are any of my views wasting compute?\", or wants a one-shot triage of view health. For source\u002Fsync health use `auditing-warehouse-source-health`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3658,3659,3660,3663],{"name":3635,"slug":3636,"type":13},{"name":3647,"slug":3648,"type":13},{"name":3661,"slug":3662,"type":13},"Performance","performance",{"name":9,"slug":8,"type":13},"2026-06-18T08:25:10.936787",{"slug":3666,"name":3666,"fn":3667,"description":3668,"org":3669,"tags":3670,"stars":3624,"repoUrl":3625,"updatedAt":3679},"authoring-error-tracking-alerts","author PostHog error tracking alerts","Author error tracking alerts that fire when an issue is created, reopened, or starts spiking. Use when the user asks to set up error notifications, route exceptions to Slack\u002Fwebhook\u002FLinear, or evaluate which error events are worth alerting on. Covers trigger-event selection, integration choice, dedup against existing alerts, and shipping with the canonical message body shape.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3671,3674,3677,3678],{"name":3672,"slug":3673,"type":13},"Alerting","alerting",{"name":3675,"slug":3676,"type":13},"Debugging","debugging",{"name":3621,"slug":3622,"type":13},{"name":9,"slug":8,"type":13},"2026-06-18T08:24:40.318583",{"slug":3681,"name":3681,"fn":3682,"description":3683,"org":3684,"tags":3685,"stars":3624,"repoUrl":3625,"updatedAt":3695},"authoring-log-alerts","author log alerts in PostHog","Author useful, low-noise log alerts on services in a PostHog project. Use when the user asks to set up alerts for their logs, suggest alerts they should add, or evaluate whether a service is worth monitoring. Covers service triage, baseline characterisation, threshold drafting, back-testing via simulate, and shipping with a notification destination.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3686,3687,3690,3691,3694],{"name":3615,"slug":3616,"type":13},{"name":3688,"slug":3689,"type":13},"Monitoring","monitoring",{"name":3621,"slug":3622,"type":13},{"name":3692,"slug":3693,"type":13},"Operations","operations",{"name":9,"slug":8,"type":13},"2026-07-18T05:10:54.430898",{"slug":3697,"name":3697,"fn":3698,"description":3699,"org":3700,"tags":3701,"stars":3624,"repoUrl":3625,"updatedAt":3712},"building-workflows","build and edit PostHog workflows","Build, edit, test, enable, and monitor PostHog workflows over MCP. Author the action\u002Fedge graph so it runs and opens cleanly in the visual editor, then change drafts surgically with patch operations. Use when asked to build, set up, automate, change, fix, or debug a workflow, campaign, broadcast, drip sequence, or event-triggered automation in the workflows product.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3702,3705,3708,3709],{"name":3703,"slug":3704,"type":13},"Automation","automation",{"name":3706,"slug":3707,"type":13},"MCP","mcp",{"name":9,"slug":8,"type":13},{"name":3710,"slug":3711,"type":13},"Workflow Automation","workflow-automation","2026-07-28T05:34:12.167015",{"slug":3714,"name":3714,"fn":3715,"description":3716,"org":3717,"tags":3718,"stars":3624,"repoUrl":3625,"updatedAt":3726},"check-posthog-loading","inspect PostHog SDK loading across URLs","Inspect how the PostHog JavaScript SDK is loaded across a list of URLs. Use to confirm consistent installation across pages, find pages missing the snippet, detect mismatched API keys or hosts between pages, and verify the load method (head snippet vs deferred vs array.js).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3719,3720,3721,3724,3725],{"name":3615,"slug":3616,"type":13},{"name":3675,"slug":3676,"type":13},{"name":3722,"slug":3723,"type":13},"Frontend","frontend",{"name":3621,"slug":3622,"type":13},{"name":9,"slug":8,"type":13},"2026-05-07T05:56:19.828048",{"slug":3728,"name":3728,"fn":3729,"description":3730,"org":3731,"tags":3732,"stars":3624,"repoUrl":3625,"updatedAt":3741},"consuming-endpoints-from-client-code","integrate PostHog endpoints into client applications","Wire a PostHog endpoint into a client app or SDK. Covers fetching the OpenAPI spec, generating a typed client with openapi-generator or @hey-api\u002Fopenapi-ts, sending the right auth header, shaping the variables payload (HogQL code_name vs insight breakdown property), handling rate-limit and materialised-endpoint error responses. Use when the user says \"how do I call my endpoint\", \"generate a client for this\", or \"what auth header do I use\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3733,3736,3737,3738],{"name":3734,"slug":3735,"type":13},"API Development","api-development",{"name":3722,"slug":3723,"type":13},{"name":9,"slug":8,"type":13},{"name":3739,"slug":3740,"type":13},"SDK","sdk","2026-06-08T08:08:34.929454",{"slug":3743,"name":3743,"fn":3744,"description":3745,"org":3746,"tags":3747,"stars":3624,"repoUrl":3625,"updatedAt":3751},"copying-endpoints-across-projects","copy PostHog endpoints across projects","Copy a PostHog endpoint (a saved HogQL\u002Finsight query exposed as an API route) to another project in the same organization, or duplicate it under a new name in the same project. Use when the user wants to duplicate an endpoint, promote an endpoint from staging to production, replicate an endpoint's query\u002Fvariables\u002Ffreshness config in another workspace, or clone an endpoint to iterate on it. Unlike feature flags and experiments, endpoints have NO native cross-project copy tool — this skill covers the read-then-recreate flow (endpoint-get then endpoint-create), the active-project switching it requires, name-collision checks, and the safe defaults (land unmaterialised in the target, verify with endpoint-run). Does not cover editing endpoint versions (see managing-endpoint-versions) or authoring a brand-new endpoint from scratch (see creating-an-endpoint).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3748,3749,3750],{"name":3734,"slug":3735,"type":13},{"name":3692,"slug":3693,"type":13},{"name":9,"slug":8,"type":13},"2026-07-15T05:29:58.442727",{"slug":3753,"name":3753,"fn":3754,"description":3755,"org":3756,"tags":3757,"stars":3624,"repoUrl":3625,"updatedAt":3769},"creating-ai-subscription","schedule recurring AI-generated PostHog reports","Create a recurring AI-generated PostHog report — schedule a free-text prompt to run on a cron, with the LLM-synthesized markdown delivered to email or Slack on each tick. Use when the user wants a recurring AI summary of X on any cadence (daily, weekly, monthly, yearly) rather than a one-off report. (To attach an AI summary to an existing insight\u002Fdashboard subscription instead of a free-text prompt, see `managing-subscriptions` and its `summary_enabled` option.)\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3758,3759,3762,3763,3766],{"name":3703,"slug":3704,"type":13},{"name":3760,"slug":3761,"type":13},"Email","email",{"name":9,"slug":8,"type":13},{"name":3764,"slug":3765,"type":13},"Reporting","reporting",{"name":3767,"slug":3768,"type":13},"Slack","slack","2026-06-09T07:32:27.935712",{"slug":3771,"name":3771,"fn":3772,"description":3773,"org":3774,"tags":3775,"stars":3624,"repoUrl":3625,"updatedAt":3779},"creating-an-endpoint","create PostHog API endpoints","Create a PostHog endpoint with the right shape on the first try — covers query kind choice, name conventions, what to expose as variables (HogQL code_name vs insight breakdown), data_freshness_seconds, and whether to materialise on day one. Use when the user says \"create an endpoint\", \"expose this query as an API\", \"turn this insight into an endpoint\", or asks for help structuring a new endpoint. Steers away from common mistakes: materialising a query with cohort breakdowns or compare mode, inline-only variables on a materialised endpoint, unbounded date ranges, ambiguous names.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3776,3777,3778],{"name":3615,"slug":3616,"type":13},{"name":3734,"slug":3735,"type":13},{"name":9,"slug":8,"type":13},"2026-06-08T08:08:29.624498",231,{"items":3782,"total":3885},[3783,3800,3816,3830,3846,3858,3869],{"slug":3784,"name":3784,"fn":3785,"description":3786,"org":3787,"tags":3788,"stars":17,"repoUrl":18,"updatedAt":3799},"account-handover","draft sales account handover notes","Draft structured handover notes for transitioning a PostHog account from one TAM or CSM to another. Use this skill when a TAM needs to hand over an account, prepare a transition briefing, write handover notes, create an account summary for a new owner, or any request involving account transitions between TAMs or CSMs. Triggers on \"hand over this account\", \"transition account to\", \"draft handover notes\", \"account briefing for new TAM\", \"prepare account transition\", or when a TAM names an account and says they're leaving or reassigning it.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3789,3792,3795,3796],{"name":3790,"slug":3791,"type":13},"Communications","communications",{"name":3793,"slug":3794,"type":13},"CRM","crm",{"name":9,"slug":8,"type":13},{"name":3797,"slug":3798,"type":13},"Sales","sales","2026-04-16T05:13:00.172732",{"slug":3801,"name":3801,"fn":3802,"description":3803,"org":3804,"tags":3805,"stars":17,"repoUrl":18,"updatedAt":3815},"auditing-warehouse-data-health","audit PostHog data warehouse health","Audit the health of a PostHog project's data warehouse — find every broken or degraded pipeline item across sources, sync schemas, materialized views, batch exports, and transformations. Use when the user asks \"what's broken in my warehouse?\", \"give me a health check\", \"audit my data pipeline\", \"why are some dashboards stale?\", or wants a one-shot triage summary before deciding where to spend time. Produces a prioritized report of issues grouped by severity and type, with recommended next steps.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3806,3807,3810,3813,3814],{"name":3635,"slug":3636,"type":13},{"name":3808,"slug":3809,"type":13},"Data Engineering","data-engineering",{"name":3811,"slug":3812,"type":13},"Data Quality","data-quality",{"name":3621,"slug":3622,"type":13},{"name":9,"slug":8,"type":13},"2026-06-21T08:19:05.85849",{"slug":3817,"name":3817,"fn":3818,"description":3819,"org":3820,"tags":3821,"stars":17,"repoUrl":18,"updatedAt":3829},"copying-flags-across-projects","copy feature flags across PostHog projects","Copy a feature flag from one PostHog project to one or more target projects in the same organization. Use when the user wants to duplicate a flag, promote a flag from staging to production, sync flags across projects, or replicate a flag configuration in a different workspace. Covers cohort remapping, scheduled-change handling, encrypted payloads, and the safe defaults (disabled in target, no scheduled changes).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3822,3825,3828],{"name":3823,"slug":3824,"type":13},"Deployment","deployment",{"name":3826,"slug":3827,"type":13},"Feature Flags","feature-flags",{"name":9,"slug":8,"type":13},"2026-05-04T05:56:44.484909",{"slug":3831,"name":3831,"fn":3832,"description":3833,"org":3834,"tags":3835,"stars":17,"repoUrl":18,"updatedAt":3845},"diagnosing-experiment-results","diagnose PostHog experiment results and anomalies","Diagnoses bias, anomalies, and strange-looking results on a specific PostHog experiment. Covers empty \u002F 0-exposure experiments, sample ratio mismatch, identity fragmentation, multi-variant exposure, uneven-split exclusion bias, significance traps (peeking, A\u002FA, Bayesian vs Frequentist), PostHog-vs-SQL discrepancies, and surprises after mid-run edits. Symptom-driven dispatch to the right diagnostic.\nTRIGGER when: user asks 'is my experiment biased?' or 'why 0 exposures?', references the bias banner, says a variant looks strange \u002F wrong \u002F off, sees significance flipping, notices PostHog numbers disagreeing with their SQL, sees an A\u002FA test showing significance, or reports surprises after mid-run edits.\nDO NOT TRIGGER when: creating a new experiment (use creating-experiments), only configuring rollout (use configuring-experiment-rollout) or metrics (use configuring-experiment-analytics), or only asking lifecycle questions (use managing-experiment-lifecycle).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3836,3839,3840,3843,3844],{"name":3837,"slug":3838,"type":13},"A\u002FB Testing","a-b-testing",{"name":3615,"slug":3616,"type":13},{"name":3841,"slug":3842,"type":13},"Data Analysis","data-analysis",{"name":3675,"slug":3676,"type":13},{"name":9,"slug":8,"type":13},"2026-05-22T06:59:58.103867",{"slug":3847,"name":3847,"fn":3848,"description":3849,"org":3850,"tags":3851,"stars":17,"repoUrl":18,"updatedAt":3857},"diagnosing-missing-recordings","diagnose missing PostHog session recordings","Diagnoses why a session recording is missing or was not captured. Use when a user asks why a session has no replay, why recordings aren't appearing, or wants to troubleshoot session replay capture issues for a specific session ID or across their project. Covers SDK diagnostic signals, project settings, sampling, triggers, ad blockers, and quota\u002Fbilling scenarios.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3852,3853,3854,3855,3856],{"name":3615,"slug":3616,"type":13},{"name":3675,"slug":3676,"type":13},{"name":3722,"slug":3723,"type":13},{"name":3621,"slug":3622,"type":13},{"name":9,"slug":8,"type":13},"2026-04-22T05:06:51.989772",{"slug":3859,"name":3859,"fn":3860,"description":3861,"org":3862,"tags":3863,"stars":17,"repoUrl":18,"updatedAt":3868},"diagnosing-sdk-health","diagnose PostHog SDK health","Diagnoses the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them. Use when a user asks about PostHog SDK versions, outdated SDKs, upgrade recommendations, \"SDK health\", \"SDK doctor\" (the former name), or when events or features seem off and it might be due to an old SDK.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3864,3865,3866,3867],{"name":3615,"slug":3616,"type":13},{"name":3675,"slug":3676,"type":13},{"name":3621,"slug":3622,"type":13},{"name":9,"slug":8,"type":13},"2026-04-27T05:46:14.554016",{"slug":3870,"name":3870,"fn":3871,"description":3872,"org":3873,"tags":3874,"stars":17,"repoUrl":18,"updatedAt":3884},"error-tracking-android","track Android errors with PostHog","PostHog error tracking for Android",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3875,3878,3879,3882,3883],{"name":3876,"slug":3877,"type":13},"Android","android",{"name":3675,"slug":3676,"type":13},{"name":3880,"slug":3881,"type":13},"Mobile","mobile",{"name":3621,"slug":3622,"type":13},{"name":9,"slug":8,"type":13},"2026-04-06T18:46:26.982494",110]