@ggts-sh/skill

中文文档
0.48.3发布于 2026/11/06MITES Module零依赖构建来源已验证近 30 天下载 3594

Agent skill for the shared grammar of graphics: TypeScript, React, Svelte, portable JSON, and the ggts check/render feedback loop. Versions with all framework adapters.

原始使用文档
文档目录4 节
  1. Install
  2. Use
  3. Contents
  4. Guarantees

@ggts-sh/skill

The ggts agent skill: SKILL.md plus deep-dive references/ that teach a coding agent the shared grammar of graphics — TypeScript builders, React and Svelte components, PortableSpec JSON, and the ggts check / ggts render feedback loop.

This package is the one published home of the skill. It versions in lock-step with @ggts-sh/spec, @ggts-sh/core, @ggts-sh/compose, @ggts-sh/react, @ggts-sh/svelte, and @ggts-sh/cli: a given version number describes the spec, the renderers, and this skill as of the same release. Pin it like any other dependency and let dependabot (or npm-check-updates) tell you when the bundled skill in your repo is stale.

Install

npm install --save-dev --save-exact @ggts-sh/skill @ggts-sh/cli

The package root is the skill directory: SKILL.md sits next to this README. Skill loaders key off the frontmatter (name: ggts), not the directory name.

Use

Point your agent at the skill, or copy/symlink it into your agent's skills directory under the name ggts:

# Claude Code
cp -R node_modules/@ggts-sh/skill .claude/skills/ggts

# pi
cp -R node_modules/@ggts-sh/skill .pi/agent/skills/ggts

# or reference it in place
node_modules/@ggts-sh/skill/SKILL.md

Re-run the copy on every version bump (a two-line postinstall or a sync script works); the dependabot PR is the signal that the skill changed.

The skill assumes the agent can also run @ggts-sh/cli (ggts check and ggts render) for spec validation and headless SVG rendering — install it in every sandbox where an agent authors specs.

Contents

  • SKILL.md — target selection, shared grammar, authoring workflow.
  • references/react.md and references/svelte.md — adapter instructions.
  • references/ — geoms and stats, scales and palettes, themes, interactions, composition surfaces, recipes.

Guarantees

CI checks the teaching contracts and shipped examples:

  1. Content contracts (scripts/skill-content/*.test.ts, scripts/skill-package.test.ts) — inventory completeness for every geom, stat, position, theme, and color scheme; every complete JSON fence normalizes and validates; pack shape and lock-step version. Packed-consumer checks also compile complete TSX and Svelte examples from the installed skill.
  2. Trigger / disclosure contracts (scripts/skill-trigger.test.ts) — frontmatter description quality (the loader's selection signal), balanced positive/negative trigger fixtures under evals/trigger-cases.json, relative-link integrity, and progressive disclosure of every references/ file from SKILL.md.
  3. Held-out NL→spec evals (tests/evals/, bun run evals) — model capability on PortableSpec authoring with deterministic graders. These do not load this skill today; agent-in-the-loop skill evals (with/without skill A/B, multi-trial trigger accuracy) are tracked as follow-up work.

evals/trigger-cases.json is not packed to npm (files is only SKILL.md + references/). It is the living seed for future skill-loaded agent evals.

版本与发布记录

@ggts-sh/skill 共发布 11 个版本,首次发布于 2026/09/08;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.48.3latest2026/11/0610 天前
0.48.22026/11/0610 天前
0.48.12026/11/0510 天前
0.48.02026/11/0511 天前
0.47.02026/11/0313 天前
0.46.02026/11/0313 天前

关于 @ggts-sh/skill 的常见问题

@ggts-sh/skill 是什么?

Agent skill for the shared grammar of graphics: TypeScript, React, Svelte, portable JSON, and the ggts check/render feedback loop. Versions with all framework adapters.

如何安装 @ggts-sh/skill?

在项目目录运行 npm install @ggts-sh/skill,或使用 pnpm add / yarn add / bun add。

@ggts-sh/skill 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ggts-sh__skill 是否存在。

@ggts-sh/skill 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@ggts-sh/skill 可以商用吗?

@ggts-sh/skill 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ggts-sh/skill 的下载量有多少?

根据 npm 官方下载统计,@ggts-sh/skill 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,594 次,日均约 120 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ggts-sh/skill 还在维护吗?

最新版本 0.48.3 发布于 2026/11/06(10 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/09/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。