[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B1J6EZGX2X3SC356FVP5ZP":3,"skill-same:01M7B1J6EZGX2X3SC356FVP5ZP":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":14,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7B1J6EZGX2X3SC356FVP5ZP","new-package",null,"Scaffold a new publishable @grafana\u002F* package in the monorepo via the turbo generator, with TypeScript build, vitest, AGENTS.md, and publish config wired up.","torkelo\u002Fscenes2","torkelo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10999?v=4","01M7B1G6RRGVK2TZGTJ2813VJ4","Torkel Ödegaard","01M7B1G6SAYVTDC3NWMBPX16TB",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnew-package\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: new-package\ndescription: Scaffold a new publishable @grafana\u002F* package in the monorepo via the turbo generator, with TypeScript build, vitest, AGENTS.md, and publish config wired up.\nmetadata:\n  generated: hatch@v1.2.0\n  source: .hatch\u002F_skills\u002Fnew-package\u002FSKILL.md\n---\n\n# Scaffold new package\n\nCreate a new publishable package named **@grafana\u002F$ARGUMENTS[0]** in the\nmonorepo.\n\nIf a description is provided as `$ARGUMENTS[1]`, use that. Otherwise ask the\nuser for a short description of the package's purpose before proceeding.\n\n## Step 1 — Use the turbo generator\n\nThe repo ships a `package` generator that creates everything in one go:\n\n```bash\npnpm gen\n# pick \"package\"\n# enter the name (without @grafana\u002F)\n# enter the description\n```\n\nThis produces, under `packages\u002F\u003Cname>\u002F`:\n\n- `package.json` — Apache-2.0, `type: module`, ESM-only build with `tsc`,\n  `publishConfig: { access: \"public\" }`, vitest devDep\n- `tsconfig.json` — extends `..\u002F..\u002Ftsconfig.base.json`\n- `vitest.config.ts`\n- `src\u002Findex.ts` — empty entry point\n- `README.md`, `CHANGELOG.md`, `AGENTS.md` — populated from templates\n\nThe generator is the source of truth — review the templates in\n`turbo\u002Fgenerators\u002Ftemplates\u002Fpackage\u002F` before deviating from them.\n\n## Step 2 — Determine package shape\n\nThe generator output is a **pure ESM TypeScript build** (`tsc --build`). That\nis the right default. If the new package needs more, pick the matching\nadjustment:\n\n| Shape              | What to change                                                                                                                                                                                                                                                                                                                                           |\n| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **React library**  | Add `\"jsx\": \"react-jsx\"` to `tsconfig.json` compilerOptions. Add `peerDependencies: { \"react\": \">=18\" }` to `package.json`. Pull in `@types\u002Freact` as a devDep.                                                                                                                                                                                          |\n| **Dual CJS + ESM** | Replace `tsc --build` with the Rollup pipeline used by `@grafana\u002Ficons` (`rollup-plugin-esbuild` + `rollup-plugin-dts`). Update `main` \u002F `module` \u002F `types` \u002F `exports` per `packages\u002Ficons\u002Fpackage.json`. Refer to the note in the `AGENTS.md` template.                                                                                                |\n| **Uses styling**   | This repo uses `@emotion\u002Fcss`. Add it as a runtime `dependency`, not a peer dep, unless the package is a component library where consumers should provide their own emotion runtime — match what `@grafana\u002Fcomponents` does.                                                                                                                             |\n| **Exports CSS**    | For every `.css` file exposed via `exports`, the entry must be a conditional `{ types, default }` pair AND the build must emit a sibling `\u003Cname>.css.d.ts` next to the CSS. Without this, consumers on `moduleResolution: \"bundler\" \\| \"node16\" \\| \"nodenext\"` get TS2307 on the recommended side-effect import. Refer to **CSS subpath exports** below. |\n\nDo not invent a new build shape — copy from an existing package\n(`design-tokens`, `icons`, `components`, `prototype`) that matches the type\nyou need.\n\n### CSS subpath exports\n\nIf the package exports any `.css` files, two things have to line up:\n\n1. **`exports` uses the conditional form.** Each CSS subpath entry must\n   carry both a `types` and a `default` condition. Examples from the\n   monorepo:\n\n   ```jsonc\n   \u002F\u002F single file\n   \".\u002Ftokens.css\": {\n     \"types\":   \".\u002Fgenerated\u002Ftokens.css.d.ts\",\n     \"default\": \".\u002Fgenerated\u002Ftokens.css\"\n   }\n   \u002F\u002F wildcard\n   \".\u002Fcss\u002Flegacy\u002F*.css\": {\n     \"types\":   \".\u002Fdist\u002Fcss\u002Flegacy\u002F*.css.d.ts\",\n     \"default\": \".\u002Fdist\u002Fcss\u002Flegacy\u002F*.css\"\n   }\n   ```\n\n2. **The build emits a sibling `\u003Cname>.css.d.ts` next to every published\n   `.css`.** The stub is canonical and one line:\n\n   ```ts\n   \u002F\u002F Side-effect-only stylesheet. This file exists so that\n   \u002F\u002F `import '@grafana\u002F\u003Cpkg>\u002F\u003Cpath>.css'` typechecks\n   \u002F\u002F under moduleResolution: \"bundler\" | \"node16\" | \"nodenext\".\n   export {};\n   ```\n\n   For an example pipeline, refer to\n   `packages\u002Fdesign-tokens\u002Fscripts\u002FpostProcessCss.ts` (single-file\n   emission), `packages\u002Fcomponents\u002Fscripts\u002FemitCssTypes.ts` (sweeps a\n   directory after rollup writes the CSS), or\n   `packages\u002Ffonts\u002Fscripts\u002Fbuild.ts` (inline next to the CSS write).\n\n3. **The `files` array publishes the `.d.ts`.** Usually covered for free\n   by a `dist` or matching `generated\u002F\u003Cdir>` entry, but check.\n\nWhy this is required: under `moduleResolution: \"bundler\" | \"node16\" |\n\"nodenext\"` TypeScript honors the package's `exports` field and refuses\na wildcard `declare module '*.css'` shim from the consumer's project.\nThe recommended side-effect import — `import '@grafana\u002F\u003Cpkg>\u002F\u003Cpath>.css';`\n— would otherwise fail with TS2307 in every modern Vite \u002F esbuild \u002F\nRollup \u002F webpack 5 \u002F Bun project. Shipping a sibling `.d.ts` makes the\npackage self-contained.\n\n## Step 3 — Install and verify\n\nThe generator does not run `pnpm install` for you.\n\n```bash\npnpm install\npnpm turbo run build typecheck lint --filter=@grafana\u002F$ARGUMENTS[0]\n```\n\nIf lint fails because there's no source code yet, that's fine. The build and\ntypecheck must pass.\n\n## Step 4 — First publish\n\nA brand-new package needs a one-time bootstrap publish before OIDC trusted\npublishing can be wired up — the package has to exist on npm before the\ntrusted publisher can be configured against it.\n\nThe `initial-publish` skill (`\u002Finitial-publish`) walks through this end-to-end:\ngenerates a `stub` shape (`pnpm gen` → \"stub\"), prompts for the `grafanabot`\ncredentials, publishes `0.0.0`, prompts to configure the trusted publisher on\nnpmjs.com, and logs out.\n\nRoutine releases after that go through changesets — refer to\n[`docs\u002FRELEASING.md`](..\u002F..\u002F..\u002Fdocs\u002FRELEASING.md) and the `\u002Fchangeset` command.\n\n## Step 5 — Report\n\nSummarize:\n\n- What was created (package name, shape, file list)\n- What adjustments (if any) you made beyond the generator defaults\n- Whether the package needs the `initial-publish` bootstrap before its first\n  release\n- Reminder to run `pnpm changeset` when the first real change is ready\n\n## Rules\n\n- **pnpm only** — never use `npm` or `yarn`.\n- **No per-package TypeScript** — `typescript` is a root devDependency.\n- **No per-package ESLint \u002F Prettier configs** — these are repo-wide.\n- **Never manually edit `version`** — it's owned by changesets.\n- **License is Apache-2.0**, not UNLICENSED.\n- **Run `pnpm install`** after creating `package.json` so the workspace link\n  resolves.\n","# Scaffold new package\n\nCreate a new publishable package named **@grafana\u002F$ARGUMENTS[0]** in the\nmonorepo.\n\nIf a description is provided as `$ARGUMENTS[1]`, use that. Otherwise ask the\nuser for a short description of the package's purpose before proceeding.\n\n## Step 1 — Use the turbo generator\n\nThe repo ships a `package` generator that creates everything in one go:\n\n```bash\npnpm gen\n# pick \"package\"\n# enter the name (without @grafana\u002F)\n# enter the description\n```\n\nThis produces, under `packages\u002F\u003Cname>\u002F`:\n\n- `package.json` — Apache-2.0, `type: module`, ESM-only build with `tsc`,\n  `publishConfig: { access: \"public\" }`, vitest devDep\n- `tsconfig.json` — extends `..\u002F..\u002Ftsconfig.base.json`\n- `vitest.config.ts`\n- `src\u002Findex.ts` — empty entry point\n- `README.md`, `CHANGELOG.md`, `AGENTS.md` — populated from templates\n\nThe generator is the source of truth — review the templates in\n`turbo\u002Fgenerators\u002Ftemplates\u002Fpackage\u002F` before deviating from them.\n\n## Step 2 — Determine package shape\n\nThe generator output is a **pure ESM TypeScript build** (`tsc --build`). That\nis the right default. If the new package needs more, pick the matching\nadjustment:\n\n| Shape              | What to change                                                                                                                                                                                                                                                                                                                                           |\n| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **React library**  | Add `\"jsx\": \"react-jsx\"` to `tsconfig.json` compilerOptions. Add `peerDependencies: { \"react\": \">=18\" }` to `package.json`. Pull in `@types\u002Freact` as a devDep.                                                                                                                                                                                          |\n| **Dual CJS + ESM** | Replace `tsc --build` with the Rollup pipeline used by `@grafana\u002Ficons` (`rollup-plugin-esbuild` + `rollup-plugin-dts`). Update `main` \u002F `module` \u002F `types` \u002F `exports` per `packages\u002Ficons\u002Fpackage.json`. Refer to the note in the `AGENTS.md` template.                                                                                                |\n| **Uses styling**   | This repo uses `@emotion\u002Fcss`. Add it as a runtime `dependency`, not a peer dep, unless the package is a component library where consumers should provide their own emotion runtime — match what `@grafana\u002Fcomponents` does.                                                                                                                             |\n| **Exports CSS**    | For every `.css` file exposed via `exports`, the entry must be a conditional `{ types, default }` pair AND the build must emit a sibling `\u003Cname>.css.d.ts` next to the CSS. Without this, consumers on `moduleResolution: \"bundler\" \\| \"node16\" \\| \"nodenext\"` get TS2307 on the recommended side-effect import. Refer to **CSS subpath exports** below. |\n\nDo not invent a new build shape — copy from an existing package\n(`design-tokens`, `icons`, `components`, `prototype`) that matches the type\nyou need.\n\n### CSS subpath exports\n\nIf the package exports any `.css` files, two things have to line up:\n\n1. **`exports` uses the conditional form.** Each CSS subpath entry must\n   carry both a `types` and a `default` condition. Examples from the\n   monorepo:\n\n   ```jsonc\n   \u002F\u002F single file\n   \".\u002Ftokens.css\": {\n     \"types\":   \".\u002Fgenerated\u002Ftokens.css.d.ts\",\n     \"default\": \".\u002Fgenerated\u002Ftokens.css\"\n   }\n   \u002F\u002F wildcard\n   \".\u002Fcss\u002Flegacy\u002F*.css\": {\n     \"types\":   \".\u002Fdist\u002Fcss\u002Flegacy\u002F*.css.d.ts\",\n     \"default\": \".\u002Fdist\u002Fcss\u002Flegacy\u002F*.css\"\n   }\n   ```\n\n2. **The build emits a sibling `\u003Cname>.css.d.ts` next to every published\n   `.css`.** The stub is canonical and one line:\n\n   ```ts\n   \u002F\u002F Side-effect-only stylesheet. This file exists so that\n   \u002F\u002F `import '@grafana\u002F\u003Cpkg>\u002F\u003Cpath>.css'` typechecks\n   \u002F\u002F under moduleResolution: \"bundler\" | \"node16\" | \"nodenext\".\n   export {};\n   ```\n\n   For an example pipeline, refer to\n   `packages\u002Fdesign-tokens\u002Fscripts\u002FpostProcessCss.ts` (single-file\n   emission), `packages\u002Fcomponents\u002Fscripts\u002FemitCssTypes.ts` (sweeps a\n   directory after rollup writes the CSS), or\n   `packages\u002Ffonts\u002Fscripts\u002Fbuild.ts` (inline next to the CSS write).\n\n3. **The `files` array publishes the `.d.ts`.** Usually covered for free\n   by a `dist` or matching `generated\u002F\u003Cdir>` entry, but check.\n\nWhy this is required: under `moduleResolution: \"bundler\" | \"node16\" |\n\"nodenext\"` TypeScript honors the package's `exports` field and refuses\na wildcard `declare module '*.css'` shim from the consumer's project.\nThe recommended side-effect import — `import '@grafana\u002F\u003Cpkg>\u002F\u003Cpath>.css';`\n— would otherwise fail with TS2307 in every modern Vite \u002F esbuild \u002F\nRollup \u002F webpack 5 \u002F Bun project. Shipping a sibling `.d.ts` makes the\npackage self-contained.\n\n## Step 3 — Install and verify\n\nThe generator does not run `pnpm install` for you.\n\n```bash\npnpm install\npnpm turbo run build typecheck lint --filter=@grafana\u002F$ARGUMENTS[0]\n```\n\nIf lint fails because there's no source code yet, that's fine. The build and\ntypecheck must pass.\n\n## Step 4 — First publish\n\nA brand-new package needs a one-time bootstrap publish before OIDC trusted\npublishing can be wired up — the package has to exist on npm before the\ntrusted publisher can be configured against it.\n\nThe `initial-publish` skill (`\u002Finitial-publish`) walks through this end-to-end:\ngenerates a `stub` shape (`pnpm gen` → \"stub\"), prompts for the `grafanabot`\ncredentials, publishes `0.0.0`, prompts to configure the trusted publisher on\nnpmjs.com, and logs out.\n\nRoutine releases after that go through changesets — refer to\n[`docs\u002FRELEASING.md`](..\u002F..\u002F..\u002Fdocs\u002FRELEASING.md) and the `\u002Fchangeset` command.\n\n## Step 5 — Report\n\nSummarize:\n\n- What was created (package name, shape, file list)\n- What adjustments (if any) you made beyond the generator defaults\n- Whether the package needs the `initial-publish` bootstrap before its first\n  release\n- Reminder to run `pnpm changeset` when the first real change is ready\n\n## Rules\n\n- **pnpm only** — never use `npm` or `yarn`.\n- **No per-package TypeScript** — `typescript` is a root devDependency.\n- **No per-package ESLint \u002F Prettier configs** — these are repo-wide.\n- **Never manually edit `version`** — it's owned by changesets.\n- **License is Apache-2.0**, not UNLICENSED.\n- **Run `pnpm install`** after creating `package.json` so the workspace link\n  resolves.\n",{"name":5,"metadata":24,"description":7},{"source":25,"generated":26},".hatch\u002F_skills\u002Fnew-package\u002FSKILL.md","hatch@v1.2.0","main","9b85ba995139627c15a6ef1cec1daec64659cf75",".agents\u002Fskills\u002Fnew-package","https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2","https:\u002F\u002Fgithub.com\u002Ftorkelo","https:\u002F\u002Fgrafana.com","Grafana Labs Co-Founder, Grafana Creator & product manager & lead architect.  ","2026-11-14 19:30:54",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add torkelo\u002Fscenes2 --skill new-package",{"tool":41,"command":42},"bunx","bunx skills add torkelo\u002Fscenes2 --skill new-package",{"tool":44,"command":45},"pnpm","pnpm dlx skills add torkelo\u002Fscenes2 --skill new-package","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnew-package\u002FSKILL.md",true,[],[50,57,64,69,74,81],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7B1QT196EFM12F7737ZFBJ3","validate-plugin","validate a Grafana plugin using the official Grafana plugin validator","https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2\u002Fblob\u002Fmain\u002Fapps\u002Fdemo-app\u002F.codex\u002Fskills\u002Fvalidate-plugin\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7B1QQGHG8JJ9MK4BY2V8879","build-plugin","build a Grafana plugin using the standard build process (frontend and backend if applicable)","https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2\u002Fblob\u002Fmain\u002Fapps\u002Fdemo-app\u002F.codex\u002Fskills\u002Fbuild-plugin\u002FSKILL.md",[],[],{"skillNo":65,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7B1QPP9RN7E1KNMRK9D8V6M","https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2\u002Fblob\u002Fmain\u002Fapps\u002Fdemo-app\u002F.claude\u002Fskills\u002Fvalidate-plugin\u002FSKILL.md",[],[],{"skillNo":70,"name":59,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7B1QN3V9SQ7H6WXNZDMQ57Q","https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2\u002Fblob\u002Fmain\u002Fapps\u002Fdemo-app\u002F.claude\u002Fskills\u002Fbuild-plugin\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7B1QJEW06858M7GC4EM46B5","stop-slop","Remove AI writing patterns from prose. Use when drafting, editing, or reviewing text to eliminate predictable AI tells.","https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2\u002Fblob\u002Fmain\u002F.hatch\u002F_skills\u002Fstop-slop\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7B1QGEPPZQQNRJRXTQVZAKC","snag-fixer","Lightweight agent for quick fixes, tweaks, and small improvements. Optimized for single-task focused work without bloating context. Used by snag workflow for sequential fix processing.","https:\u002F\u002Fgithub.com\u002Ftorkelo\u002Fscenes2\u002Fblob\u002Fmain\u002F.hatch\u002F_skills\u002Fsnag-fixer\u002FSKILL.md",[],[]]