Skip to content

Document the 8 skills missing from the README (additive only)#31

Merged
Owl-Listener merged 1 commit into
mainfrom
claude/readme-document-missing-skills
May 31, 2026
Merged

Document the 8 skills missing from the README (additive only)#31
Owl-Listener merged 1 commit into
mainfrom
claude/readme-document-missing-skills

Conversation

@Owl-Listener

Copy link
Copy Markdown
Owner

What this does

The README claimed "36 skills" but only documented 28 — eight skills that ship in the repo (several ported in #29) were never mentioned anywhere. So the count didn't reconcile with the visible lists, and users couldn't discover roughly a quarter of what's included.

This adds an "Entry Points & Support Skills" subsection right after the workflow table, documenting the previously-undocumented skills:

  • design-express — two-minute on-ramp for first-time users
  • design-review — the Review lane (audit existing screenshot/URL/code)
  • design-md — read/author a DESIGN.md and build faithfully from its tokens
  • design-library — pull a brand's DESIGN.md off the shelf and adapt it
  • figma-bridge — turn specs/code into Figma frames or an accessible HTML prototype
  • heuristic-evaluation — structured Nielsen-style heuristics pass
  • synthetic-user-testing — persona walkthroughs after the fix round
  • taste-report — written report from the two-layer taste model

Scope & safety

  • Purely additive: 18 lines added, 0 removed. No existing content, wording, or structure is changed — only a new subsection inserted.
  • After this, all 36 skill directories are referenced in the README, so the "36 skills" claim reconciles with what's listed.
  • scripts/check-consistency.sh passes (exit 0).

Generated by Claude Code

The README claimed "36 skills" but only documented 28 — eight skills shipped
in the repo (several ported in #29) were never mentioned, so the count didn't
reconcile with the visible lists and users couldn't discover them.

Adds an "Entry Points & Support Skills" subsection after the workflow table
covering: design-express, design-review, design-md, design-library,
figma-bridge, heuristic-evaluation, synthetic-user-testing, taste-report.

Purely additive — 18 lines added, none removed. No other content touched.
Consistency check passes (exit 0); all 36 skill dirs now referenced.
@Owl-Listener Owl-Listener marked this pull request as ready for review May 31, 2026 20:22
@Owl-Listener Owl-Listener merged commit f3c42fd into main May 31, 2026
1 check passed
@Owl-Listener Owl-Listener deleted the claude/readme-document-missing-skills branch May 31, 2026 20:23
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