@djordje-stojanovic/sigmaskills 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -4,6 +4,30 @@ All notable changes to [Sigmaskills](https://github.com/Djordje-Stojanovic/Sigma
 
 ## [Unreleased]
 
+## [0.14.0] — 2026-10-20
+
+### Added
+
+- `sigmatour` (SigmaTour): a visual 15-60 minute tour of any repository in one HTML page. `scripts/sigmatour.py` (standard library) measures the repo without writing to it: size, languages, folder tree, history, entry points (package scripts and bins, console scripts, Makefile targets, main files, Dockerfiles), tests and CI, and the README held against the repo (commands with no script or file behind them, paths that do not exist, environment variables the code reads that no doc names, scripts and top folders the README never mentions, TODO and FIXME notes). `build` writes that into `assets/tour-template.html`, which draws the numbers band, the folder explorer, the history band, the README check and the entry points; the agent adds the transit map, the architecture figure, a stepper that follows one real request file by file, examples run for real, the hidden and missing list and the deep dives that set the length. `check` lists what is left. Plain technical English in the `/sigmawrite` voice.
+- `sigmaresearch`: Reddit and X never end at a block. The Reddit reader reads a thread's post and full comment tree from the Arctic Shift archive when JSON is blocked (401 login wall or 403 network policy), and searches titles there inside a subreddit; a removed archive copy takes its body from the live feed. The HTTP core follows a host's own window (`x-ratelimit-remaining`, `x-ratelimit-reset`): the Reddit feed allows one read per minute, so the next read waits for the reset instead of failing. `read.py x <post URL>` reads a post without a login (the FxTwitter API, then X's embed JSON) with its likes and reply count; a browser dump is filtered by the query words, so off-topic posts never reach the answer. `references/reddit.md` and `references/x.md` give the full route order: the reader's routes, a real browser (also a stealth Chromium on a server), another network address, more archives; tested on three threads and three posts.
+- SigmaHuman follows blader/humanizer upstream: a vendored copy (`sigmahuman/upstream/humanizer-SKILL.md`, commit and version in `UPSTREAM.json`) and one update command, `python sigmahuman/scripts/upstream.py status | sync [--ref R] | check`. `sync` rewrites the 26 patterns, the licence and the version lines and lists upstream's other changes for our layer; `check` runs in `npm test`. Lanes, section G, the write mode and `factcheck.py` stay ours.
+
+### Changed
+
+- Sigma Installer: the owner's studio folder preset is now the generic `local` pack (`--preset local`, alias `own`, folder from `SIGMA_LOCAL_SKILLS_DIR` or `dirs.local` in `~/.sigmaskills/packs.json`, no id prefix). A named pack with a prefix goes into `~/.sigmaskills/packs.json` under `packs`.
+- The public package names no private repository, host or path any more: `DESIGN.md` (now Black-Green), `AGENTS.md`, the installer guide, the arena template, the deeplook tests (real files from `SIGMADEEPLOOK_REAL`, else `~/.cache/sigmadeeplook/real`) and the guardrail lint. A repo invariant fails when one comes back. Tracked `__pycache__` files are gone.
+
+## [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
@@ -345,7 +369,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.12.0...HEAD
+[Unreleased]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.14.0...HEAD
+[0.14.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.13.0...v0.14.0
+[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

package/README.md

@@ -6,7 +6,7 @@ Portable [Agent Skills](https://agentskills.io/) that install once and run on **
 
 | | |
 |---|---|
-| **Release** | [**v0.12.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.12.0) |
+| **Release** | [**v0.14.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.14.0) |
 | **Changelog** | [CHANGELOG.md](CHANGELOG.md) |
 | **License** | [MIT](LICENSE) |
 | **Spec** | [agentskills.io](https://agentskills.io/) |
@@ -49,7 +49,7 @@ The wizard has three steps: **What**, **Where**, **Review**. It writes nothing u
 | `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` |
+| `local` | a folder of your own skills | `SIGMA_LOCAL_SKILLS_DIR` or `~/.sigmaskills/packs.json` |
 | `all` | every pack that is available | |
 
 ### Without the wizard
@@ -88,6 +88,7 @@ The [installer guide](https://github.com/Djordje-Stojanovic/Sigmaskills/blob/mai
 | **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 |
+| **SigmaTour** | `sigmatour` | A visual 15-60 minute tour of any repo: map, architecture, one request traced, examples run, README next to what the repo shows | One `<repo>-tour.html` page |
 
 ### Which one do I need?
 
@@ -141,7 +142,7 @@ Ranks many options by your taste. After a short grilling round it builds an **ar
 
 ### SigmaResearch
 
-Reads public sources with bundled stdlib Python readers for Reddit, Hacker News, GitHub, Stack Overflow and YouTube comments, plus X through Claude in Chrome on the owner's existing session. One interface (`read.py`), a 24-hour cache, per-host rate limits and source scoring. Reports contradictions, blocked and partial reads. It never logs in, solves CAPTCHAs or evades bot checks.
+Reads Reddit, X, Hacker News, GitHub, Stack Overflow and YouTube comments. Reddit never stops at a block: JSON, the Arctic Shift archive, the feed, a browser. X posts read without a login.
 
 ### SigmaDeepLook
 
@@ -168,6 +169,10 @@ Copies any repository after 8 questions, cuts every path, link and git remote to
 
 Turns one accent colour into `DESIGN.md`, colour packs and CSS, then moves a repo onto it.
 
+### SigmaTour
+
+A 15-60 minute tour of any repo in one page: a clickable map, one request traced, real runs, the README against the repo.
+
 ---
 
 ## Install
@@ -213,6 +218,7 @@ $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
+$sigmatour Give me a 30 minute tour of this repo
 ```
 
 </td>
@@ -238,6 +244,7 @@ $sigmadesign Make a design system from #e8a33d and put it in this repo
 /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
+/skill:sigmatour Give me a 30 minute tour of owner/repo
 ```
 
 </td>
@@ -263,6 +270,7 @@ $sigmadesign Make a design system from #e8a33d and put it in this repo
 | `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` |
+| `sigmatour` | a repo path or URL · a length | One question round; reads the repo only; runs its examples |
 
 ### Requirements
 

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "name": "sigmaskills",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Portable Agent Skills monorepo and first-party Sigma Installer",
   "skills": [
     {
@@ -83,6 +83,11 @@
       "id": "sigmadesign",
       "title": "SigmaDesign",
       "needsReferences": true
+    },
+    {
+      "id": "sigmatour",
+      "title": "SigmaTour",
+      "needsReferences": true
     }
   ],
   "retired": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djordje-stojanovic/sigmaskills",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Portable Agent Skills monorepo and first-party Sigma Installer",
   "type": "module",
   "license": "MIT",
@@ -37,6 +37,7 @@
     "sigmahuman",
     "sigmafork",
     "sigmadesign",
+    "sigmatour",
     "sigmarefactor",
     "sigmaresearch",
     "sigmadeeplook",

package/registry/packs.json

@@ -457,17 +457,16 @@
       ]
     },
     {
-      "id": "storgestudio",
-      "title": "StorgeStudio",
-      "blurb": "The StorgeStudio film, audio, image and publishing skills (local to the owner).",
+      "id": "local",
+      "title": "Local",
+      "blurb": "A folder of your own skills on this machine.",
       "aliases": [
-        "storge"
+        "own"
       ],
       "sources": [
         {
           "type": "dir",
-          "env": "SIGMA_STORGESTUDIO_DIR",
-          "prefix": "storgestudio-"
+          "env": "SIGMA_LOCAL_SKILLS_DIR"
         }
       ]
     }