sheleg-design-skill 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,114 @@
+# Changelog
+
+All notable changes to this project are documented in this file. The format
+follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions
+follow [SemVer](https://semver.org/spec/v2.0.0.html).
+
+## [0.7.0] - 2026-07-25
+
+Review pass.
+
+- **FIX: `SHELEG_DESIGN.md` pointed at a non-existent `DESIGN.md`** and hard-coded
+  the instrument-console palette in the build recipe, contradicting the
+  style-agnostic method — §11 now says to implement the chosen style pack's tokens.
+- **Toggleable release automation** (`.github/workflows/release.yml`, off unless
+  `RELEASE_ENABLED` is set): the repo shipped 0.2.0–0.6.0 with no tags and no
+  GitHub releases.
+- README gains a Russian section; `package.json` `files[]` ships `CHANGELOG.md`;
+  a stray untracked `.claude/skills/sheleg-design` plain copy was removed and
+  `.claude/` gitignored (it shadowed the plugin).
+
+## [0.6.0] - 2026-07-20
+
+### Added
+
+- Ready-made token layers `styles/tokens/<pack>.css` for all three packs
+  (copy verbatim instead of transcribing tables; workbench ships light +
+  `data-theme="dark"` twins). Validator requires a tokens file per pack.
+- Motion-flavor sections in the cinematic packs (particle tint/energy,
+  Reveal set, instrument styling per style).
+- Versioned release test scenarios (`test/scenarios.md`, T1–T6) encoding
+  the RED/GREEN history.
+- Validator installer-sync check (every bundle file shipped by install.sh;
+  npx CLI now walks the bundle at runtime — adding a pack no longer
+  touches installers) and a CI negative self-test (validator must FAIL on
+  a corrupted version).
+- Style-pack authoring skeleton `templates/style-pack-template.md`;
+  `/sheleg-design` accepts a pack name argument.
+
+### Fixed
+
+- Discovery gap: skill description (and Cursor rule) now trigger on
+  product-UI tasks — dashboards, admin tools, design tokens, light/dark
+  themes (EN + RU) — previously such tasks never loaded the skill.
+- Stale manifests: package.json / marketplace / plugin descriptions and
+  the Cursor rule now mention style packs incl. workbench.
+
+## [0.5.0] - 2026-07-20
+
+### Added
+
+- **`workbench` style pack** — quiet light+dark utilitarian product UI for
+  dashboards, admin panels, and internal/dev tools: neutral grays, borders
+  as elevation, one functional blue accent, system + mono type, canonical
+  atoms (status dot, chip, stat tile, sparkline), honest-state and
+  glanceability rules. Blended from the Builder Pro AI production design
+  system and GitHub-style border discipline. Usable standalone — SKILL.md
+  now routes dashboard/tool requests to this pack instead of excluding
+  them outright.
+
+## [0.4.0] - 2026-07-19
+
+### Added
+
+- **Style packs** (`styles/`): the motion methodology is now style-agnostic
+  and pairs with a chosen visual identity pack. Two packs ship:
+  `instrument-console` (near-black aerospace console, electric-blue signal
+  — the original reference style) and `editorial-luxury` (warm cream +
+  espresso + sage, Fraunces/Newsreader/JetBrains Mono, dossier motifs —
+  extracted from the prowl.chat production design system). Each pack locks
+  palette/type/texture/motion tokens, signature motifs, and bans; SKILL.md
+  documents the pack contract for authoring new styles.
+- Installers (npx CLI, install.sh) ship the `styles/` directory; validator
+  enforces >=2 packs with required sections.
+
+## [0.3.0] - 2026-07-19
+
+### Added
+
+- Claude Code marketplace layout: `.claude-plugin/marketplace.json` +
+  `plugins/sheleg-design/` (plugin.json, `/sheleg-design` command, skill).
+  Installable via `/plugin marketplace add ssheleg/sheleg-design-skill` and
+  discoverable by the vercel-labs `skills` CLI.
+- Cursor rule `cursor/rules/sheleg-design.mdc` (self-contained, no relative
+  links).
+- Repo consistency validator `test/validate.py` + GitHub Actions CI
+  (`validate.yml`: validator, `node --check`, CLI smoke test).
+- POSIX fallback installer `install.sh` (local checkout / curl / wget).
+- Russian trigger phrases in the skill description.
+
+### Changed
+
+- Skill bundle moved from `skill/` to
+  `plugins/sheleg-design/skills/sheleg-design/`; the npx installer copies
+  from the new location (installed layout unchanged).
+
+## [0.2.0] - 2026-07-19
+
+### Changed
+
+- SKILL.md reworked to skill-authoring canon: trigger-only description
+  (no workflow summary), canonical sections (Overview / When to Use / Core
+  Pattern / How to Apply / Quick Reference / Common Mistakes), ~590 words,
+  explicit REQUIRED REFERENCE pointer to SHELEG_DESIGN.md.
+- Reference doc genericized (removed source-repo-specific `v2` paths).
+- Verified with subagent scenarios (trigger, application, retrieval) before
+  and after the rewrite.
+
+## [0.1.0] - 2026-06-11
+
+### Added
+
+- Initial release: SKILL.md + SHELEG_DESIGN.md bundle and the zero-dependency
+  `npx sheleg-design-skill` installer (auto-detect `.cursor`/`.claude`,
+  `--cursor`, `--claude`, `--dir`, `--force`).

package/README.md

@@ -117,6 +117,19 @@ test on every push and PR. Versioning is semver; bump `marketplace.json` +
 `plugin.json` + `package.json` + `CHANGELOG.md` together — the validator
 enforces the sync.
 
+## По-русски
+
+**sheleg-design** — методология SHELEG: кинематографичные скролл-лендинги (единые
+часы анимации, слоистая композиция, «degrade to calm» при снижении ресурсов) плюс
+**style packs** для продуктового UI. Метод — style-agnostic; визуальную систему
+задаёт выбранный пак (`styles/<pack>.md` + `styles/tokens/<pack>.css`):
+`instrument-console` (тёмная приборная панель), `editorial-luxury` (тёплая
+издательская), `workbench` (светлый рабочий интерфейс).
+
+Триггеры: «кинематографичный лендинг», «скролл-анимация», «лендинг с частицами»,
+«стиль дашборда», «дизайн-токены», «светлая/тёмная тема». Запуск — `/sheleg-design
+<что построить или улучшить>`. Установка — см. раздел Install выше.
+
 ## License
 
 MIT © ssheleg

package/bin/cli.js

@@ -169,7 +169,7 @@ function main() {
     `\n${c("green", "✓")} ${c("bold", "SHELEG Design")} installed to ${c("blue", rel + "/")}\n` +
       `  ${c("dim", "SKILL.md")}          the agent skill\n` +
       `  ${c("dim", "SHELEG_DESIGN.md")}  the full reference\n` +
-      `  ${c("dim", "styles/")}           style packs (console / editorial)\n\n` +
+      `  ${c("dim", "styles/")}           style packs (instrument-console / editorial-luxury / workbench)\n\n` +
       `Your Cursor / Claude agent can now discover the skill and build\n` +
       `cinematic, scroll-driven, particle-backed pages on its principles.\n\n` +
       `${c("dim", "Docs: " + pkg.homepage)}\n`,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sheleg-design-skill",
-  "version": "0.6.0",
-  "description": "SHELEG Design — an agent skill for cinematic scroll-driven landing pages AND product UI. Installs a SKILL.md + architecture reference + style packs (instrument-console dark, editorial-luxury warm, workbench light/dark for dashboards & tools) so Cursor/Claude agents build with a single-clock motion system and locked design tokens.",
+  "version": "0.7.0",
+  "description": "SHELEG Design \u2014 an agent skill for cinematic scroll-driven landing pages AND product UI. Installs a SKILL.md + architecture reference + style packs (instrument-console dark, editorial-luxury warm, workbench light/dark for dashboards & tools) so Cursor/Claude agents build with a single-clock motion system and locked design tokens.",
   "bin": {
     "sheleg-design-skill": "bin/cli.js"
   },
@@ -10,7 +10,8 @@
     "plugins/",
     "cursor/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "type": "commonjs",
   "engines": {

package/plugins/sheleg-design/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "sheleg-design",
   "description": "SHELEG Design methodology: cinematic scroll-driven landing pages (single scroll clock, layered degrade-to-calm motion, WebGL particle formations) plus pluggable visual style packs — instrument-console (dark console), editorial-luxury (warm editorial), workbench (light/dark product UI for dashboards and tools). Ships the sheleg-design skill, the architecture reference, style packs with ready-made token CSS, and the /sheleg-design command.",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "author": {
     "name": "ssheleg"
   },

package/plugins/sheleg-design/skills/sheleg-design/SHELEG_DESIGN.md

@@ -526,7 +526,10 @@ text-equivalent in the DOM (e.g. the ecosystem stage keeps the diagram's
 
 A pragmatic order that front-loads the parts everything else depends on.
 
-1. **Lay the visual system first.** Implement `DESIGN.md`: near-black canvas,
+1. **Lay the visual system first.** Pick a style pack (`styles/<pack>.md` +
+   `styles/tokens/<pack>.css`) and implement ITS tokens verbatim — the pack is the
+   visual contract, this document is the motion/structure method. The
+   `instrument-console` pack, for example, gives: near-black canvas,
    one signal accent, hairline structure, mono telemetry labels, the panel /
    button / status-pill components. Motion on top of a weak visual system just
    amplifies the weakness.
@@ -638,6 +641,6 @@ A pragmatic order that front-loads the parts everything else depends on.
 ---
 
 *SHELEG Design is the motion + systems half of this site's identity; pair it
-with `DESIGN.md` for the visual half. The north star for both: it should feel
+with the chosen `styles/<pack>.md` for the visual half. The north star for both: it should feel
 like a precision instrument responding to your hand — authority through
 accuracy and restraint, not spectacle.*