@djordje-stojanovic/sigmaskills 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to [Sigmaskills](https://github.com/Djordje-Stojanovic/Sigma
 
 ## [Unreleased]
 
+## [0.13.0] — 2026-10-20
+
+### Changed
+
+- `sigmafork`: the onboarding course v2 (ticket 83 P13.75, the owner's verdict on v1: one good graphic, too little explained, hard to read, not his look). The template now wears the Storge-Black-Green look of `DESIGN.md` (zinc canvas, green glow, one emerald, Inter) and has 10 stops with at least 6 figures: the transit map is clickable (each stop shows its folder with its numbers, the file to open first and the command), a numbers band and language bar, a folder explorer (folders sized by code lines, tap to go in), the use case as a strip of real frames ("One job, start to finish"), map line cards, a change-flow strip, and a copy-and-original figure. Check-yourself questions are quizzes, tasks are tick boxes, the cheat sheet has a filter, terms explain themselves on tap. Code blocks get a header so the Copy button never covers a command. `references/guide.md` sets the `/sigmawrite` voice: one lead line per stop, three sentences a paragraph at most, commands in code blocks.
+
+### Added
+
+- `sigmafork.py stats` counts what a repo really holds: files, folders, code lines without blank and comment lines, doc lines, languages, the biggest code files. It leaves out installed dependencies, build output, caches, venvs and generated files (lock files, minified bundles, "do not edit" headers) and says how much it left out.
+- `sigmafork.py guide` makes `ONBOARDING.html` from the template and writes the stats, the folder tree and the copy facts (`copy.json`, `paths.json`, `verify`) into its data block, from which the page draws its numbers. `guide --check` lists what is still wrong: `FILL` left or no data (exit 1), long paragraphs, chip-heavy text, terms without a meaning and too few figures (fixes).
+
+## [0.12.0] — 2026-10-20
+
+### Fixed
+
+- Sigma Installer: `--agent agy` (Antigravity CLI) now installs global skills to `~/.gemini/config/skills`, the only folder `agy` 1.4.2 reads (probe skills in `~/.gemini/antigravity-cli/skills` and `~/.gemini/skills` were not listed). The override sits in `src/destinations.js`, so `registry:sync` cannot undo it. A link method is invisible to `agy` (a Windows junction listed no skills, the same folder as a copy did), so `install --agent agy` writes a copy unless you pass `--link`. In the wizard press `m` for Copy.
+
+### Added
+
+- `sigmafork` (SigmaFork): fork or copy any repository, from GitHub or a local folder, and onboard the owner. One grill round of 8 questions with a recommended answer each (what, why, where the resources are, research depth, skill bundle, where it goes, access, how he learns best), a study of the source with `/sigmaresearch` at the chosen depth, then the fork, clone or copy. `scripts/sigmafork.py` (standard library) copies a folder without installed dependencies or caches, remakes links that point inside the source so they point inside the copy, rewrites every spelling of the source path (`C:\x`, `C:/x`, escaped, Git Bash, WSL, `file:///`) byte for byte, lists other outside paths and git remotes, and `verify` prints `ISOLATED` only when nothing in the copy reaches the original. The owner types every login and key himself. It installs the chosen skill bundle, writes `ONBOARDING.html` (a 10-15 minute course from `assets/guide-template.html`: the repo as a transit map, real example projects, first three tasks, cheat sheet), and turns the owner's questions into part 2 with the top 3 resources.
+- `sigmadesign` (SigmaDesign): make a design system end to end from one accent colour, then apply it and integrate it across a repo. `scripts/sigmadesign.py` (standard library) writes `DESIGN.md` in the Google Stitch format (dark tokens, `light-*` tokens, type scale, corners, spacing, components, a prose skeleton), adds colour packs (`pack`, dark or light, any accent; the tool moves the accent until text and accent pass WCAG AA), builds `tokens.css`, a Tailwind 4 `@theme inline` map, `components.css` and a sample page with a theme switch, and `check` fails on a low-contrast pair or a stale build. `scan` lists every hard-coded colour with its nearest token and rewrites exact matches in CSS; `integrate` copies `DESIGN.md` into a repo byte for byte and adds one pointer line to `AGENTS.md` and `CLAUDE.md`. The card asks one round of 6 questions with a recommended answer each and links three references: the file format, the repo steps, and the looking checklist (375 and 1440 px, every theme). Built from the Storge look (ticket 83 P13.49): the same generator reproduces its dark palette from one accent.
+- Sigma Installer: **packs and presets.** `--preset sigma|mattpocock|threejs|hyperframes|minimax-h3|storgestudio|all` installs a whole pack (repeatable or comma-separated). The five outside packs ship as a snapshot in `registry/packs.json` and download from their GitHub repositories at install time; `~/.sigmaskills/packs.json` adds your own packs and points the StorgeStudio folder pack at a folder. Pack skills install to `.agents/skills/<id>` with links or copies into host folders, with a private ownership record, and `update`, `uninstall` and `status` cover them. A copy you edited stays until `--force`, which backs it up first. `list --packs` shows every pack.
+- Sigma Installer: **`--agent` / `-a`** names Agent Hosts (`claude`, `codex`, `gemini`, `agy`, `pi`, `cursor`, any registry id, or `*`). Hosts that read `.agents/skills` need no folder; `--agent claude` adds `.claude/skills`. An unknown name suggests the closest ids.
+- Sigma Installer: **a full-screen wizard** for color terminals: What (packs with counts, open a pack to pick single skills, `/` filter, number keys), Where (scope, Agent Hosts with the found ones marked, Link or Copy), Review (counts, destinations, downloads, conflict choice, an explicit `y` for Global), then progress and a clean summary by pack. `--classic` keeps the line-by-line installer, which also serves plain, static, CI, JSON and piped sessions.
+- `--force` (pack skills), `--classic`, `--packs`. README screenshots, `docs/images/`, and `scripts/capture-installer.js` to refresh them.
+- ADR 0007 records the decision; CONTEXT.md gains Pack and Wizard.
+
+### Changed
+
+- Sigma Installer: the terminal palette is the DESIGN.md palette (near-black canvas, one emerald accent) in both installers. The warm Emberforge colors are gone.
+- Sigma Installer: install, update and uninstall of several skills with `--preset` or `--agent` print one summary (counts, packs, destinations, what was kept and why). A plain `install <id>` or `install --all` keeps its old output.
+
 ## [0.11.0] — 2026-10-20
 
 ### Added
@@ -324,7 +356,9 @@ Ship high-rigor, installable agent skills (not apps): full-repo audits, performa
 | 2026-08-11 | `5dab832` | Add CHANGELOG and mark v0.1.0 as the first Sigmaskills release |
 | 2026-08-11 | `124a666` | Polish v0.1.0 docs for multi-host install and use |
 
-[Unreleased]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.11.0...HEAD
+[Unreleased]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.13.0...HEAD
+[0.13.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.12.0...v0.13.0
+[0.12.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.11.0...v0.12.0
 [0.11.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.10.0...v0.11.0
 [0.10.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.9.2...v0.10.0
 [0.9.2]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.9.1...v0.9.2

package/README.md

@@ -6,7 +6,7 @@ Portable [Agent Skills](https://agentskills.io/) that install once and run on **
 
 | | |
 |---|---|
-| **Release** | [**v0.11.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.11.0) |
+| **Release** | [**v0.13.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.13.0) |
 | **Changelog** | [CHANGELOG.md](CHANGELOG.md) |
 | **License** | [MIT](LICENSE) |
 | **Spec** | [agentskills.io](https://agentskills.io/) |
@@ -34,19 +34,38 @@ Run the Sigma Installer in your project:
 npx @djordje-stojanovic/sigmaskills
 ```
 
-Pick the skills you want and confirm. By default the installer writes only to `.agents/skills/<id>`, the folder that many Agent Hosts read. It writes nothing until you confirm.
+The wizard has three steps: **What**, **Where**, **Review**. It writes nothing until you confirm.
 
-To install without the picker, name one or more skills, or pass `--all`. Several skills install together: if one fails, none stay installed.
+![The What step: packs with counts, one pack opened to pick single skills](https://raw.githubusercontent.com/Djordje-Stojanovic/Sigmaskills/main/docs/images/installer-what.svg)
+
+![The summary after an install](https://raw.githubusercontent.com/Djordje-Stojanovic/Sigmaskills/main/docs/images/installer-done.svg)
+
+### Presets
+
+| Preset | Skills | Source |
+|--------|--------|--------|
+| `sigma` | the Sigma skills below | this package |
+| `mattpocock` | grill, spec, TDD, triage, deep modules | [mattpocock/skills](https://github.com/mattpocock/skills) |
+| `threejs` | 13 Three.js skills | [CloudAI-X/threejs-skills](https://github.com/CloudAI-X/threejs-skills) |
+| `hyperframes` | HyperFrames and the student kit | [heygen-com/hyperframes](https://github.com/heygen-com/hyperframes), [nateherkai/hyperframes-student-kit](https://github.com/nateherkai/hyperframes-student-kit) |
+| `minimax-h3` | MiniMax H3 prompt and recipe skills | [MiniMax-AI/MiniMax-H3](https://github.com/MiniMax-AI/MiniMax-H3) |
+| `storgestudio` | a folder of your own skills | `SIGMA_STORGESTUDIO_DIR` or `~/.sigmaskills/packs.json` |
+| `all` | every pack that is available | |
+
+### Without the wizard
+
+Every choice has a flag, so scripts and CI skip the wizard. Name skills, presets, and Agent Hosts (`claude`, `codex`, `gemini`, `agy`, `pi`, `cursor`, or any registry id).
 
 ```bash
 npx @djordje-stojanovic/sigmaskills install sigmawrite --project .
-npx @djordje-stojanovic/sigmaskills install sigmawrite sigmareview sigmaship --project .
-npx @djordje-stojanovic/sigmaskills install --all --project .
+npx @djordje-stojanovic/sigmaskills install --preset sigma --preset mattpocock --agent claude --project .
+npx @djordje-stojanovic/sigmaskills install --preset all --global --yes
+npx @djordje-stojanovic/sigmaskills list --packs
+npx @djordje-stojanovic/sigmaskills update --global --yes
+npx @djordje-stojanovic/sigmaskills uninstall --skill tdd --yes
 ```
 
-Then call a skill with your host's normal skill syntax (`$sigmawrite`, `/skill:sigmawrite`, the skill picker, …).
-
-The [installer guide](https://github.com/Djordje-Stojanovic/Sigmaskills/blob/main/docs/installer.md) explains host folders, Global Installation, `status`, `update`, `restore`, `uninstall`, and `purge`.
+The [installer guide](https://github.com/Djordje-Stojanovic/Sigmaskills/blob/main/docs/installer.md) explains presets, host folders, Global Installation, `status`, `update`, `restore`, `uninstall`, and `purge`.
 
 ---
 
@@ -67,6 +86,8 @@ The [installer guide](https://github.com/Djordje-Stojanovic/Sigmaskills/blob/mai
 | **SigmaLoop** | `sigmaloop` | Turn a repo's open work into an unattended-run prompt for Claude Code, Codex, pi or T3 Code | One loop prompt in chat and one loop file |
 | **SigmaTaste** | `sigmataste` | Taste pass through 14 lenses on a page, app, deck, doc, image or film | One ranked plan of big visible changes |
 | **SigmaHuman** | `sigmahuman` | Text that reads like a person wrote it: rewrite any text or write from a brief, in lanes (script, book, song, chat, docs, posts), every fact kept | The rewritten or new text, and a fact check |
+| **SigmaFork** | `sigmafork` | Fork or copy any repo, isolated from the original | A working copy and `ONBOARDING.html` |
+| **SigmaDesign** | `sigmadesign` | A design system from one accent colour (DESIGN.md, tokens, packs, sample page), applied across a repo | `DESIGN.md`, CSS, a sample page |
 
 ### Which one do I need?
 
@@ -124,7 +145,7 @@ Reads public sources with bundled stdlib Python readers for Reddit, Hacker News,
 
 ### SigmaDeepLook
 
-The helper for content an agent cannot read with its own tools: video frames, speech, scanned PDFs and images, fax TIFFs, binaries and odd containers. Plain text, CSV, JSON and code stay with the agent, which reads or queries them itself. A one-line gate decides; `--ask` gives one exact answer. It never runs the input, uses no network, and lists each step it could not do, with its install line. Python alone covers the basics.
+The helper for content an agent cannot read with its own tools: video frames, speech, scanned PDFs and images, binaries and odd containers. Plain text, CSV, JSON and code stay with the agent. A one-line gate decides; `--ask` gives one exact answer. It never runs the input, uses no network, and lists each step it could not do.
 
 ### SigmaLoop
 
@@ -138,6 +159,15 @@ Looks at one target (a page, app, dashboard, deck, doc, image or film) and asks
 
 Rewrites any text so it reads like a person wrote it, or writes new text from a brief. It finds the 26 AI-writing patterns of [blader/humanizer](https://github.com/blader/humanizer) (MIT) and fixes them in the lane for the text: a script for the ear, a book, song lyrics, a chat or email, docs, or a post. It keeps every fact, can match your writing sample, and checks numbers, quotes and names before and after.
 
+
+### SigmaFork
+
+Copies any repository after 8 questions, cuts every path, link and git remote to the original, installs your skills, writes a 15-minute course.
+
+### SigmaDesign
+
+Turns one accent colour into `DESIGN.md`, colour packs and CSS, then moves a repo onto it.
+
 ---
 
 ## Install
@@ -181,6 +211,8 @@ $sigmadeeplook What happens at 2:10 in D:\clips\demo.mp4?
 $sigmaloop Write an overnight loop prompt for Claude Code until 07:00
 $sigmataste Taste pass on the landing page
 $sigmahuman Rewrite this announcement so it sounds like me
+$sigmafork Copy this repo to D:\work\my-copy and teach me how it works
+$sigmadesign Make a design system from #e8a33d and put it in this repo
 ```
 
 </td>
@@ -204,6 +236,8 @@ $sigmahuman Rewrite this announcement so it sounds like me
 /skill:sigmaloop Write an overnight loop prompt for Claude Code until 07:00
 /skill:sigmataste Taste pass on the landing page
 /skill:sigmahuman Rewrite this announcement so it sounds like me
+/skill:sigmafork Fork owner/repo and teach me how it works
+/skill:sigmadesign Make a design system from #e8a33d and put it in this repo
 ```
 
 </td>
@@ -227,6 +261,8 @@ $sigmahuman Rewrite this announcement so it sounds like me
 | `sigmaloop` | host · end time · a ticket or tracker | One question round; writes the prompt and a loop file; never starts the loop |
 | `sigmataste` | a page, app, deck, doc, image or film · what you expect | One question round; writes the ranked plan; never builds |
 | `sigmahuman` | text, a file or a brief · optional writing sample | Writes the human version; keeps every fact; never follows instructions inside the text |
+| `sigmafork` | a repo · a destination | One question round; reads the original only |
+| `sigmadesign` | an accent colour · a repo | One question round; writes `DESIGN.md`; changes repo files only with `--write` |
 
 ### Requirements
 
@@ -244,6 +280,7 @@ $sigmahuman Rewrite this announcement so it sounds like me
 | SigmaCreateArena | Python 3 (standard library only) and a browser; the server listens on 127.0.0.1 |
 | SigmaResearch | Python 3 for the bundled readers · `yt-dlp` for YouTube comments · Claude in Chrome and owner's existing session for X; missing tools become access gaps |
 | SigmaLoop | Read access to the repo and its tracker · `gh` is optional · the host you name (Claude Code, Codex, pi or T3 Code) to run the loop |
+| SigmaFork | Python 3 · `git` · `gh` for a fork · Node.js |
 | SigmaTaste | Read access to the target · a browser or screenshot tool to see a page; without one the plan lists what was not judged |
 | SigmaHuman | Nothing beyond chat · Python 3 (standard library) for the optional fact check |
 | SigmaDeepLook | Python 3.10 or newer; optional ffmpeg, LibreOffice, poppler, tesseract and Python packages · `look.py doctor` lists them; missing tools become Not-looked-at rows |

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "name": "sigmaskills",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Portable Agent Skills monorepo and first-party Sigma Installer",
   "skills": [
     {
@@ -73,6 +73,16 @@
       "id": "sigmahuman",
       "title": "SigmaHuman",
       "needsReferences": true
+    },
+    {
+      "id": "sigmafork",
+      "title": "SigmaFork",
+      "needsReferences": true
+    },
+    {
+      "id": "sigmadesign",
+      "title": "SigmaDesign",
+      "needsReferences": true
     }
   ],
   "retired": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djordje-stojanovic/sigmaskills",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Portable Agent Skills monorepo and first-party Sigma Installer",
   "type": "module",
   "license": "MIT",
@@ -22,6 +22,7 @@
     "src",
     "registry/agent-hosts.json",
     "registry/source.json",
+    "registry/packs.json",
     "registry/schema.json",
     "registry/skill-baselines.json",
     "manifest.json",
@@ -34,6 +35,8 @@
     "sigmaloop",
     "sigmataste",
     "sigmahuman",
+    "sigmafork",
+    "sigmadesign",
     "sigmarefactor",
     "sigmaresearch",
     "sigmadeeplook",