Skip to content

docs(readme): ELI5 + visible skills + Tsumagoi (v1.12.0)#12

Merged
kensaurus merged 1 commit into
mainfrom
docs/readme-eli5-1.12.0
Jul 24, 2026
Merged

docs(readme): ELI5 + visible skills + Tsumagoi (v1.12.0)#12
kensaurus merged 1 commit into
mainfrom
docs/readme-eli5-1.12.0

Conversation

@kensaurus

Copy link
Copy Markdown
Owner

Summary

Addresses live npm README feedback:

  1. Mermaid → ASCII/table so the workflow diagram actually shows on npm
  2. Skill lists always visible with a family-counts table (no click-to-expand)
  3. Tsumagoi Work&Camp playful invite at the bottom → https://tsumagoi.kensaur.us
  4. ELI5 tone + use cases at the top; skill inventory above Quick Start

Test plan

  • npm test
  • CI green
  • Release → npm 1.12.0
  • Playwright: skill family table + ASCII loop + Tsumagoi section visible without expanding

…2.0)

- ELI5 opener with use-case table and ASCII workflow loop (replaces mermaid)
- Always-visible family counts + full skill tables (no collapsed details)
- Playful Tsumagoi Work&Camp ad; skill list moved above Quick Start
Copilot AI review requested due to automatic review settings July 24, 2026 02:51
@kensaurus
kensaurus merged commit 24f1bcd into main Jul 24, 2026
4 checks passed

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the repository’s npm/GitHub-facing documentation to improve readability/discoverability (no Mermaid rendering issues on npm, always-visible skill inventory) and bumps the release to v1.12.0, including updating the README skill-index generator to match the new layout.

Changes:

  • Reworked README.md to add an ELI5 intro + use-case table, replace Mermaid with an ASCII loop diagram, and ensure skill families + full skill lists are always visible.
  • Updated scripts/generate-skill-index.mjs to emit a family counts table and per-family markdown tables (instead of collapsed <details> blocks), and to report totals accordingly.
  • Bumped versions and documented the release in CHANGELOG.md, package.json, and .cursor-plugin/plugin.json.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
scripts/generate-skill-index.mjs Generates a visible family-counts table plus per-family skill tables for README injection.
README.md Restructures and rewrites README for npm-safe rendering and improved onboarding/discoverability.
package.json Bumps package version to 1.12.0.
CHANGELOG.md Adds 1.12.0 release notes describing the README/index changes.
.cursor-plugin/plugin.json Bumps plugin version to 1.12.0.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants