docs: make the marketplace descriptions and the suite headline true (#47)

Two front-page claims that nothing derives and nothing checks.

Plugin descriptions promising skills that do not exist. Auditing every claim
in marketplace.json against what each local plugin ships found three backed
by nothing: design-ops "asset management", designer-toolkit "portfolio
review" and "resume building". "asset management" appears exactly once
across 109 skills, as one bullet in team-workflow's tooling list. Two more
were advertised by designer-toolkit but live in ux-strategy ("design briefs",
"stakeholder communication"). Both descriptions now name what ships.

The suite headline claimed 241 skills and 91 commands across 33 plugins.
generate-readmes.py skips that line — it spans five repositories and cannot
be derived from this checkout — so it was hand-maintained and drifted.
Counted by resolving all 33 marketplace sources to a directory:

  designer-skills (this repo)     9 plugins   109 skills   34 commands
  inclusive-design-skills         6 plugins    58 skills    0 commands
  ai-design-skills                6 plugins    44 skills   18 commands
  design-leadership-skills        6 plugins    32 skills   12 commands
  ux-pgm-skills                   6 plugins    30 skills   12 commands
                                 33 plugins   273 skills   76 commands

The headline understated skills by 32 and overstated commands by 15. The
commands gap is almost exactly inclusive-design-skills, which ships 58
skills and no commands at all.

Counting plugin directories matters rather than raw files: ai-design-skills
mirrors its 44 skills into three trees, so a naive find reports 132. The
comment in generate-readmes.py now records that method.
This commit is contained in:
MC Dean
2026-09-04 16:04:00 +00:00
committed by GitHub
parent 9372f0fa7b
commit 7216b0bf02
3 changed files with 12 additions and 4 deletions
+2 -2
View File
@@ -46,13 +46,13 @@
},
{
"name": "design-ops",
"description": "Design operations skills: handoff specs, design critique facilitation, design sprint planning, asset management, and design debt audits.",
"description": "Design operations skills: handoff specs, design critique facilitation, design sprint planning, team workflows, QA checklists, and design debt audits.",
"source": "./design-ops",
"category": "design"
},
{
"name": "designer-toolkit",
"description": "Designer utility skills: portfolio review, resume building, case study structure, design presentations, stakeholder communication, and design briefs.",
"description": "Designer utility skills: design rationale, case study structure, design presentations, UX writing, design system adoption, and design negotiation — plus the /start-here router.",
"source": "./designer-toolkit",
"category": "design"
},
+1 -1
View File
@@ -2,7 +2,7 @@
Design skills for the agent era, written so an AI agent can actually use them.
**241 skills and 91 commands across 33 plugins, in five collections**, for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Gemini CLI](https://github.com/google-gemini/gemini-cli).
**273 skills and 76 commands across 33 plugins, in five collections**, for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Gemini CLI](https://github.com/google-gemini/gemini-cli).
**Not sure which skill you need? Start with the [skill index](./INDEX.md)** — every skill in this repo arranged by the situation you're in, plus the pairs most often mistaken for each other.
+9 -1
View File
@@ -124,7 +124,15 @@ def _update_root_readme(counts: dict[str, tuple[int, int]]) -> bool:
n_plugins = len(counts)
# Collection summary line: "**N skills and N commands across N plugins.**"
# The all-collections line includes "in five collections" — leave it alone.
#
# The all-collections line ("... in five collections") is left alone: it
# spans five repositories and cannot be derived from this checkout. It is
# maintained by hand and has drifted before, so recompute it by resolving
# every source in .claude-plugin/marketplace.json to a directory — local
# "./path" here, git-subdir sources in a clone of the named repo — and
# counting skills/*/SKILL.md and commands/*.md under each. Count the 33
# plugin directories, never raw SKILL.md files: ai-design-skills mirrors
# its 44 skills into three trees, so a naive find would treble them.
text = re.sub(
r"\*\*\d+ skills and \d+ commands across \d+ plugins\.\*\*",
f"**{total_s} skills and {total_c} commands across {n_plugins} plugins.**",