Skip to content

chore: Consolidate GPUI-related skills into two unified skills#2405

Merged
huacnlee merged 10 commits into
mainfrom
update-skill
May 28, 2026
Merged

chore: Consolidate GPUI-related skills into two unified skills#2405
huacnlee merged 10 commits into
mainfrom
update-skill

Conversation

@huacnlee
Copy link
Copy Markdown
Member

Summary

  • Merges 14 individual .claude/skills/gpui-* and component skills into two consolidated skills: gpui and gpui-component
  • gpui skill uses progressive disclosure with a navigation table linking to 21 topic-specific reference files (action, async, context, element, entity, event, focus-handle, global, layout-style, test + extended references)
  • gpui-component skill covers new component creation, style guide, stories, and documentation via 4 reference files
  • Updates CLAUDE.md Skills Reference section to reflect the new structure

Test plan

  • Verify .claude/skills/ contains gpui/, gpui-component/, and github-pull-request-description/ only
  • Verify gpui/references/ contains all 21 topic reference files
  • Verify gpui-component/references/ contains 4 reference files

🤖 Generated with Claude Code

huacnlee and others added 10 commits May 28, 2026 11:03
Merge 14 individual skills into two consolidated ones:
- `gpui`: combines gpui-action, gpui-async, gpui-context, gpui-element,
  gpui-entity, gpui-event, gpui-focus-handle, gpui-global,
  gpui-layout-and-style, gpui-test — with topic-based reference files
- `gpui-component`: combines new-component, gpui-style-guide,
  generate-component-story, generate-component-documentation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add new skills under skills/ (the project-level skills directory):
- skills/gpui/ — unified GPUI framework skill with 21 topic reference files
- skills/gpui-component/ — unified component library skill with 4 reference files
- skills/github-pull-request-description/ — PR description guidelines

Also update CLAUDE.md and docs/skills.vue to reference the new skills/ path.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Fix cx.spawn closure from |cx| to |this, cx: &mut AsyncApp| when
  called from Context<Self> (entity receives WeakEntity<Self> as first arg)
- Add spawn_in + update_in pattern for tasks needing window access
- Update all code examples in async.md and entity.md to match actual API

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…-guide

- Rewrite SKILL.md: change focus from development to HOW TO USE gpui-component
- Add references/usage.md: setup, stateless/stateful patterns, common
  components (Button, Input, Select, Checkbox, Dialog, Notification),
  theming, layout helpers, overlay layers
- Rewrite references/style-guide.md: based on actual Button/Checkbox code,
  covers struct layout, required/optional traits, variants pattern,
  callback signatures, doc comment conventions, FluentBuilder usage

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Move new-component, story, and documentation references out of
gpui-component into a new gpui-component-dev skill, keeping
gpui-component focused on library usage.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
context.md: add cx.listener, subscribe_in, observe_window_activation,
  observe_global, defer/defer_in, naming convention
layout-style.md: add h_flex/v_flex helpers, tailwind shorthands,
  overflow/scroll, absolute positioning, z-index, text styling
event.md: add subscribe_in, observe_window_activation, observe_global,
  subscription lifetime (detach vs store in struct)
element-id.md: new file covering ElementId concept, uniqueness rules,
  component usage patterns (from docs/element_id.md + codebase)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Remove historical "Replaces individual..." noise from gpui description
- Fix broken "Reference Documentation" links in async, context, event,
  focus-handle, global, action (removed), and element/entity/test (updated
  to correct renamed file paths)
- Add table of contents to all reference files >100 lines as required
  by skill spec (entity-*, element-*, test-reference, context, layout-style,
  async, event, entity, focus-handle, global, action, usage, style-guide,
  new-component)
- Add online documentation links to gpui-component SKILL.md:
  llms-full.txt and per-component .md URLs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
SKILL.md: replace flat navigation with a complete component catalog
covering all 59 components grouped by category (Input/Form, Display,
Overlay, Navigation, Data, Charts), each with import path and key notes.
Claude can now find any component + fetch its per-component .md doc.

usage.md: add Tabs, Tooltip, Form, List quick examples; remove redundant
component list (now in catalog); update ToC.

The catalog + per-component URL fetch pattern is the optimal design:
SKILL.md handles discovery, online docs handle full API detail,
usage.md handles quick-start patterns for common components.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@huacnlee huacnlee merged commit 89f7662 into main May 28, 2026
4 checks passed
@huacnlee huacnlee deleted the update-skill branch May 28, 2026 06:14
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.

1 participant